Dart

创建新的 Dart 项目

1. 在 欢迎 屏幕上点击 新建项目 ，或从主菜单中选择 文件 | 新建 | 项目。 此时将打开 新建 项目 对话框。

2. 在左侧窗格中选择 Dart。

3. 在右侧窗格中指定存储项目相关文件的文件夹路径。

4. 指定已下载 Dart SDK 的位置。

   如果您按照 Dart 官方网站 上描述的标准安装过程进行操作，WebStorm 会自动检测 Dart SDK 的路径。

   或者，手动输入路径，或点击 并在打开的对话框中选择路径。

   如果 WebStorm 正确识别 Dart SDK，会在 版本 的只读字段中显示其修订版本号。

5. 若要在项目中创建示例应用程序，请选中 生成示例内容 复选框，并从下方列表中选择相应模板。 如果取消勾选该复选框，WebStorm 会创建一个空项目。

   

6. 点击 创建。 WebStorm 会设置项目结构，并根据所选模板生成一些源文件。

创建空的 WebStorm 项目

1. 在 欢迎 屏幕上点击 新建项目 ，或从主菜单中选择 文件 | 新建 | 项目。 此时将打开 新建 项目 对话框。

2. 在左侧窗格中，选择 空的 项目。 在右侧窗格中，指定应用程序文件夹，然后点击 创建。

打开本机上的应用源文件

在 欢迎 屏幕中点击 打开 ，或从主菜单中选择 文件 | 打开。 在打开的对话框中，选择存放源代码的文件夹。

从版本控制中检出应用源文件

1. 在 欢迎 屏幕中点击 克隆版本库克隆。

   或者，从主菜单中选择 文件 | 新建 | 来自版本控制的项目…、 Git | 克隆… 或 版本控制 | 从版本控制获取。

   您也可能会在主菜单中看到与项目关联的其他版本控制系统，而不是 Git。 例如， Mercurial 或 Perforce。

2. 在打开的对话框中，从列表中选择版本控制系统，并指定要检出应用程序源代码的存储库。 有关更多信息，请参见 检出项目（克隆）。

在现有项目中配置 Dart 支持

1. 在对话框 设置 Ctrl+Alt+S 中，转到 Dart 下的 语言与框架。 将打开 Dart 页面。

2. 选中 为项目 <project name> 启用 Dart 支持 复选框。

3. 在 Dart SDK 路径 字段中，指定已下载的 Dart SDK 的位置。

   如果您按照 Dart 官方网站 上描述的标准安装过程进行操作，WebStorm 会自动检测 Dart SDK 的路径。

   或者，手动输入路径，或点击 并在打开的对话框中选择路径。

   如果 WebStorm 正确识别 Dart SDK，会在 版本 的只读字段中显示其修订版本号。

将 Dart 项目（包）添加到现有 WebStorm 项目中

1. 在对话框 设置 （Ctrl+Alt+S ）中，转到 目录。

2. 在右侧窗格的现有内容根目录列表中，点击 添加内容根目录。 然后在打开的对话框中，选择要附加的 Dart 项目（包）的根文件夹。

1. 在编辑器中打开 pubspec.yaml 文件，或切换到已打开该文件的选项卡。

2. 在选项卡顶部的面板中点击 Webdev 构建…。 这将调用 webdev build 操作。

   

3. 在打开的对话框中，指定要读取源代码的输入文件夹和存放已编译应用程序的输出文件夹。

运行 Dart 命令行应用

1. 打开用于启动应用的 Dart 文件，或在 项目工具窗口 中选择它。 此文件必须包含一个 main() 方法。

2. 在所选项的上下文菜单中选择 运行 '<dart_file_name>'。 WebStorm 将生成一个类型为 Dart Command Line App 的运行/调试配置，并使用该配置启动应用。

本地调试 Dart 命令行应用

1. 在 Dart 代码中 配置并设置断点。

2. 打开用于启动应用的 Dart 文件，或在 项目工具窗口 中选择它。 此文件必须包含一个 main() 方法。

3. 在所选项的上下文菜单中选择 调试 '<dart_file_name>'。 WebStorm 将生成一个类型为 Dart Command Line App 的运行/调试配置，并使用该配置启动调试会话。

4. 在打开的 调试工具窗口 中， 逐步执行程序、 暂停并恢复程序执行、 在暂停时检查等。

创建 Dart 远程调试运行/调试配置

1. 从工具栏上的 运行／调试配置 小组件中选择 编辑配置 ，单击 添加新配置 按钮（ ），然后从列表中选择 Dart 远程调试 ，以打开 配置设置。

   

2. 如果您的 WebStorm 项目包含配置为内容根的 多个 Dart 项目 ，请在 在以下位置搜索源 字段中指定要调试的 Dart 项目。 从列表中选择 Dart 项目，或单击 并在打开的对话框中选择所需的文件夹。

启动远程调试会话

1. 使用 VM 选项启动远程 Dart 应用程序，例如使用 --enable-vm-service --pause_isolates_on_start。 应用程序启动后，会立即因 --pause_isolates_on_start 参数而挂起并等待调试器连接。

2. 在 运行 工具窗口中，复制应用运行的 URL 地址和用于访问的已生成身份验证令牌。

   

3. 在 选择运行／调试配置 列表中选择新建的 Dart Remote Debug 配置，并单击 。

4. 在打开的 连接到正在运行的应用 对话框中，粘贴之前复制的 URL 地址和身份验证令牌 如上所述。

   

5. 在打开的 调试工具窗口 中， 逐步执行程序、 暂停并恢复程序执行、 在暂停时检查等。

创建运行/调试配置

1. 创建 Dart Web 运行/调试配置：

   转到 运行(U) | 编辑配置(E) ，在随即打开的 编辑配置 对话框中，点击工具栏上的 添加 按钮（ ），然后从列表中选择 Dart Web。

   在打开的 运行/调试配置：Dart Web 对话框中，指定引用 Dart 代码以运行或调试的 HTML 文件路径，以及 webdev server 启动 Dart Web 应用时使用的端口。

运行应用

• 从工具栏的 运行／调试配置 小部件列表中，选择新创建的 Dart Web 配置，然后点击其旁边的 。

  浏览器将在 127.0.0.1:<webdev_port>/<specified_HTML_file> 打开。

调试应用

1. 根据需要，在 Dart 代码中设置 断点。

2. 从工具栏的 运行 小部件列表中，选择新创建的 Dart Web 配置，然后点击其旁边的 。

运行或调试单个测试

在编辑器中打开测试文件，右键点击 test() 方法 的调用，然后从上下文菜单中选择 运行 '<test_name>' 或 调试 '<test_name>'。

运行或调试分组

在编辑器中打开测试文件，右键点击 group() 方法 的调用，然后从上下文菜单中选择 运行 '<group_name>' 或 调试 '<group_name>'。

从文件运行或调试 Dart 测试

在 项目工具窗口 中，选择包含要运行测试的文件，然后从上下文菜单中选择 运行 '<file_name>' 或 调试 '<file_name>'。

从文件夹运行或调试 Dart 测试

在 项目工具窗口 中，选择包含要运行测试的文件夹，然后从上下文菜单中选择 运行 '<folder_name>' 或 调试 '<folder_name>'。

保存自动生成的默认配置

测试会话结束后，从测试、测试组、测试文件或文件夹的上下文菜单中选择 保存 <default_test_configuration_name>。

使用先前保存的运行/调试配置运行或调试测试

• 在工具栏上从列表中选择所需的 Dart Test 配置，然后点击 或 。

1. 在 设置 对话框（Ctrl+Alt+S ）中，转到 编辑器 | 配色方案 | Dart。

2. 选择颜色方案，接受从默认设置继承的高亮显示设置，或按照 颜色和字体 中的说明进行自定义。