镖

从 Stagehand 模板创建 Dart 项目

1. 在欢迎屏幕 上单击创建新项目或选择文件 | 新 | 主菜单中的项目。创建新项目对话框打开。

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

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

4. 指定 Dart SDK 的路径。WebStorm 检测并显示Dart 版本。

   tip

   Dart SDK 为每个项目单独配置。这意味着您可以在 WebStorm 中拥有多个 Dart SDK，并在它们之间从一个项目切换到另一个项目。

5. 要在项目中创建示例应用程序，请选中Generate sample content复选框并从下面的列表中选择相关的 Stagehand 模板。如果清除该复选框，WebStorm 将创建一个空项目。

   

6. 单击创建。WebStorm 设置项目结构并根据选定的 Stagehand 模板生成一些源。

创建一个空的 WebStorm 项目

1. 在欢迎屏幕 上单击创建新项目或选择文件 | 新 | 主菜单中的项目。创建新项目对话框打开。

2. 在左侧窗格中，选择Empty Project。在右侧窗格中，指定应用程序文件夹并单击Create。

打开您机器上已有的应用程序源

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

从您的版本控制中查看应用程序源

1. 在欢迎屏幕上单击从 VCS 获取。或者，选择文件 | 来自版本控制或<Your_VCS> 的项目 | 从主菜单中获取版本控制。

   <Your_VCS> 代表与您当前打开的项目相关联的版本控制系统。

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

在现有项目中配置 Dart 支持

1. 在Settings/Preferences对话框Ctrl+Alt+S中，选择Languages and Frameworks下的Dart。Dart 页面打开。

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

3. 在Dart SDK Path字段中，指定下载的Dart SDK的位置。手动键入路径或单击并在打开的对话框中选择路径。如果 WebStorm 正确识别了 Dart SDK，它的修订号会显示在Version只读字段中。

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

1. 在“设置/首选项”对话框 ( Ctrl+Alt+S) 中，转到“目录” 。

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

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

2. 在选项卡顶部的窗格中，单击Webdev build ...。这会调用webdev 构建操作。

   

3. 在打开的对话框中，指定要从中获取源的输入文件夹以及您希望存储已编译应用程序的输出文件夹。

tip

或者，从pubspec.yaml的上下文菜单中选择webdev build。

对于 Dart SDK 2 之前的版本，将调用action pub build 。

运行 Dart 命令行应用程序

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

2. 从选择的上下文菜单中，选择Run '<dart_file_name>'。WebStorm 生成Dart 命令行应用程序类型的运行/调试配置，并使用它启动您的应用程序。

在本地调试 Dart 命令行应用程序

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

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

3. 从选择的上下文菜单中，选择Debug '<dart_file_name>'。WebStorm 生成Dart 命令行应用程序类型的运行/调试配置，并使用它启动调试会话。

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

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

1. 在主菜单上，转到运行 | 编辑配置，单击并从列表中选择Dart Remote Debug 。运行/调试配置：Dart 远程调试打开。

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

启动远程调试会话

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

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

   

3. 在Select run/debug configuration列表中选择新创建的Dart Remote Debug配置，然后单击。

4. 在Connect to a Running App对话框中，粘贴 URL 地址和您复制的身份验证令牌，如上所述。

   

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

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

   从主菜单中，选择运行 | 编辑配置，单击工具栏上的 并从列表中选择Dart Web 。

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

2. 要运行您的应用程序，请从工具栏上的Select run/debug configuration列表中选择新创建的Dart Web配置，然后单击列表旁边的 。

   浏览器在127.0.0.1:<webdev_port>/<specified_HTML_file>.

3. 要调试您的应用程序，请根据需要在 Dart 代码中设置断点。然后从工具栏上的Select run/debug configuration列表中选择新创建的Dart Web配置，然后单击列表旁边的 。

运行或调试单个测试

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

运行或调试组

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

从文件运行或调试 Dart 测试

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

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

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

tip

如果选择了文件夹，则测试运行程序仅在名称格式为*_test.dart的文件中查找测试。

保存自动生成的默认配置

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

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

• 从工具栏上的列表中选择所需的Dart 测试配置，然后单击或。

1. 在Settings/Preferences对话框 ( Ctrl+Alt+S) 中，转到Editor | 配色方案 | 飞镖。

2. 选择配色方案，接受从默认值继承的突出显示设置，或按照颜色和字体中的说明自定义它们。