创建新的 Flutter 应用

本页提供在你首选开发环境中引导创建新 Flutter 应用的分步说明。

要创建新 Flutter 应用，请先 配置 Flutter，然后选择首选环境并遵循相应说明。

要使用 VS Code 及其他基于 Code OSS 的编辑器创建 Flutter 应用，请先 安装 Flutter 并为 Flutter 开发 配置 VS Code。然后按以下步骤操作：

1. 启动 VS Code

   打开 VS Code 或你首选的基于 Code OSS 的编辑器。

2. 打开命令面板

   前往 View > Command Palette，或按 Cmd/Ctrl + Shift + P。

3. 查找 Flutter 命令

   在命令面板中输入 flutter:，VS Code 应显示 Flutter 插件命令。

4. 运行新建项目命令

   选择 Flutter: New Project 命令；系统或 VS Code 可能请求文档访问权限，同意以继续。

5. 选择模板

   VS Code 会提示 Which Flutter template?；根据项目类型选择模板，新建应用选 Application。

6. 选择项目位置

   将出现文件对话框；选择或创建父目录（勿自行创建项目文件夹）。点击 Select a folder to create the project in 确认。

7. 输入项目名称

   VS Code 会提示输入项目名称；按 lowercase_with_underscores 与 Effective Dart 输入名称，按 Enter 确认。

8. 等待项目初始化

   VS Code 根据输入用 flutter create 引导应用；进度常在右下角通知或 Output 面板显示。

9. 运行你的应用

   新应用应已在 VS Code 中打开；试运行请按 运行与调试 步骤操作。

你已在 VS Code 中成功创建新的 Flutter 应用！更多帮助请参阅 VS Code 的 Flutter 参考。

要使用 Android Studio 创建 Flutter 应用，请先 安装 Flutter 并 配置 Android Studio，然后按以下步骤操作：

1. 启动 Android Studio

   打开已安装 Dart 与 Flutter 插件的 Android Studio。

2. 开始创建项目

   若在显示 Welcome to Android Studio 的欢迎对话框，点击中央的 New Flutter Project 按钮。

   若已有打开的项目，可关闭或前往 File > New > New Flutter Project...。

3. 选择项目类型

   在 New Project 对话框左侧 Generators 下选择 Flutter。

4. 验证 Flutter SDK 配置

   在右侧面板顶部确保 Flutter SDK path 与欲使用的 Flutter SDK 位置一致，否则请选择或指定正确路径。

5. 配置你的项目

   点击 Next 继续项目配置，将出现多个配置选项。

   在 Project name 字段输入符合 lowercase_with_underscores 规范的应用名称，遵循 Effective Dart 指南。

   若并非创建 application，从 Project type 下拉框选择其他模板。

   若未来可能发布应用，将 Organization 字段 设为公司域名。

   其他字段可保持默认或按项目需要配置。

6. 完成项目创建

   完成项目配置后，点击 Create 开始初始化。

7. 等待工作区初始化

   Android Studio 将初始化工作区、引导项目结构并获取依赖，可能耗时，可在窗口底部查看进度。

8. 运行你的应用

   新应用应已创建并在 Android Studio 中打开；试运行请按 运行与调试 步骤操作。

你已在 Android Studio 中成功创建新的 Flutter 应用！更多帮助请参阅 Android Studio 的 Flutter 参考。

要使用 IntelliJ 或其他 JetBrains IDE 创建 Flutter 应用，请先 安装 Flutter 并 配置 IntelliJ，然后按以下步骤操作：

1. 启动 IntelliJ

   打开已安装 Dart 与 Flutter 插件的 IntelliJ IDEA 或你首选的 JetBrains 旗下基于 IntelliJ 的 IDE。

2. 开始创建项目

   若在 Welcome to IntelliJ IDEA 欢迎对话框，点击右上角 New Project 按钮。

   若已有打开的项目，可关闭或前往 File > New > New Project...。

3. 选择项目类型

   在 New Project 对话框左侧 Generators 下选择 Flutter。

4. 验证 Flutter SDK 配置

   在右侧面板顶部确保 Flutter SDK path 与欲使用的 Flutter SDK 位置一致，否则请选择或指定正确路径。

5. 配置你的项目

   点击 Next 继续项目配置，将出现多个配置选项。

   在 Project name 字段输入符合 lowercase_with_underscores 规范的应用名称，遵循 Effective Dart 指南。

   若并非创建 application，从 Project type 下拉框选择其他模板。

   若未来可能发布应用，将 Organization 字段 设为公司域名。

   其他字段可保持默认或按项目需要配置。

6. 完成项目创建

   完成项目配置后，点击 Create 开始初始化。

7. 等待工作区初始化

   IntelliJ 将初始化工作区、引导项目结构并获取依赖，可能耗时，可在窗口底部查看进度。

8. 运行你的应用

   新应用应已在 IntelliJ 中创建并打开；试运行请按 运行与调试 步骤操作。

你已在 IntelliJ 中成功创建新的 Flutter 应用！更多帮助请参阅 IntelliJ 的 Flutter 参考。

要使用 Antigravity 创建 Flutter 应用，请先按 Antigravity 页面 的说明安装并配置 Antigravity。然后按以下步骤操作：

1. 打开 Antigravity 并创建工作区

   启动 Antigravity IDE，使用 Agent Manager 为你的项目创建一个新的沙盒化工作区。

2. 使用 Agent Manager

   切换到 Agent Manager 界面，你将在这里通过聊天与 AI agent 交互。

3. 编写详细的提示词

   使用详细、结构化的提示词向 agent 传达你的应用需求，就像给初级开发者下达指令一样。例如：「Create a new Flutter project named my_app. Add a home screen with a list of items and a floating action button」。

4. 审查并批准计划

   AI agent 会生成详细的实现计划，包括文件夹结构、依赖和步骤。你可以审查该计划并点击 Proceed，或提供反馈以做出修改。

5. 授权操作

   agent 在运行终端命令（如 flutter pub add 或 flutter create）或访问浏览器/模拟器前会请求许可。审查并 Accept 这些操作，以允许 agent 构建应用。

6. 迭代与优化

   初始应用生成后，你可以提供更多提示词来添加功能、优化 UI、实现逻辑或添加持久化（例如：「Add local storage using shared_preferences」）。

7. 测试应用

   使用集成模拟器或连接实体设备来测试应用。 agent 甚至可以运行测试并提供功能的视频演示。

8. 在编辑器中验证代码

   你可以随时切换到标准代码编辑器视图，检查生成的 Dart 和 Flutter 文件，确保代码质量符合你的标准。

要在终端中创建 Flutter 应用，请先安装并 配置 Flutter。然后按以下步骤操作：

1. 打开终端

   打开你首选的命令行访问方式，例如 macOS 上的 Terminal 或 Windows 上的 PowerShell。

2. 导航到目标目录

   确保当前工作目录是新应用所需的父目录。不要自行创建项目文件夹，flutter 工具会创建它。

3. 配置项目创建

   在终端中输入 flutter create 命令，并传入所需的标志和选项来配置项目。例如，要创建一个带有极简 main.dart 文件的应用，可以添加 --empty 选项：

   $ flutter create --empty
   

   content_copy

   要了解可用的创建选项，请在另一个终端窗口运行 flutter create --help。

4. 输入项目名称

   作为 flutter create 唯一的非选项参数，指定应用的目录和默认名称。名称应遵循 lowercase_with_underscores 命名规范，符合 Effective Dart 指南。

   例如要创建名为 my_app 的应用：

   $ flutter create my_app
   

   content_copy

5. 执行配置好的命令

   要按指定配置创建项目，运行你在上一步构建的命令。

6. 等待项目初始化

   flutter 工具将引导项目的文件结构并获取所有必要依赖。这可能需要一些时间。

7. 进入项目目录

   项目创建完成后，你可以在终端或首选编辑器中进入它。例如，使用 bash shell 且项目名为 my_app：

   $ cd my_app
   

   content_copy

8. 运行你的应用

   要试用新应用，在终端运行 flutter run 命令，并根据提示选择输出设备。

你已在终端中成功创建新的 Flutter 应用！若在配置项目或使用 flutter CLI 工具时需要帮助，请参阅 Flutter CLI 参考。