Dart

创建一个新的 Dart 项目

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

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

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

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

   如果您遵循Dart 官方网站上所述的标准安装过程，PyCharm 会自动检测 Dart SDK 的路径。

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

   如果 PyCharm 正确识别 Dart SDK，其修订号将显示在Version只读字段中。

   提示

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

5. 要在项目中创建示例应用程序，请选中“生成示例内容”复选框，然后从下面的列表中选择相关模板。如果清除该复选框，PyCharm 将创建一个空项目。

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

创建一个空的 PyCharm 项目

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

2. 在左侧窗格中，选择“空项目”。在右侧窗格中，指定应用程序文件夹并单击“创建”。

打开计算机上已有的应用程序源

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

从版本控制中检查应用程序源

1. 单击欢迎屏幕上的从 VCS 获取。

   或者，选择文件 | 新 | 来自版本控制或Git 的项目| 从主菜单克隆...。

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

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

在现有项目中配置 Dart 支持

1. 在“设置”对话框中，在“语言和框架”下选择“Dart”。Dart 页面打开。CtrlAlt0S

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

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

   如果您遵循Dart 官方网站上所述的标准安装过程，PyCharm 会自动检测 Dart SDK 的路径。

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

   如果 PyCharm 正确识别 Dart SDK，其修订号将显示在Version只读字段中。

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

1. 在“设置”对话框 ( ) 中，转到“项目结构”。“ 项目结构”页面打开。CtrlAlt0S

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

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

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

   

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

提示

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

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

运行 Dart 命令行应用程序

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

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

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

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

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

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

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

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

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

   

   动图

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

启动远程调试会话

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

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

   

3. 在“选择运行/调试配置”列表中选择新创建的Dart 远程调试配置，然后单击。

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

   

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

创建运行/调试配置

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

  转到“运行”| 编辑配置，在打开的编辑配置对话框中，单击工具栏上的添加按钮 ( )，然后从列表中选择Dart Web 。

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

运行您的应用程序

• 从工具栏上的运行/调试配置列表中，选择新创建的Dart Web配置并单击其旁边的 。

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

调试您的应用程序

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

2. 从工具栏上的选择运行/调试配置列表中，选择新创建的Dart Web配置并单击其旁边的 。

运行或调试单个测试

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

运行或调试组

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

从文件运行或调试 Dart 测试

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

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

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

提示

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

保存自动生成的默认配置

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

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

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

1. 在“设置”对话框 ( ) 中，转到编辑器 | 配色方案| Dart。CtrlAlt0S

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