Dart

创建新的 Dart 项目

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

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

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

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

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

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

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

5. 要在项目中创建示例应用程序，请选中 生成示例内容 复选框，并从下方列表中选择相应模板。 如果清除此复选框，PyCharm 将创建一个空项目。

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

创建空的 PyCharm 项目

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

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

打开已在您计算机上的应用程序源代码

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

从版本控制中检出应用程序源代码

1. 在 欢迎 屏幕的左侧窗格中点击 克隆。

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

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

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

在现有项目中配置 Dart 支持

1. 在 设置 对话框 Ctrl+Alt+S 中，于 语言和框架 下选择 Dart。 Dart 页面随即打开。

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

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

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

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

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

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

1. 在 设置 对话框（Ctrl+Alt+S ）中，转到 项目结构。 项目结构页面 随即打开。

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

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

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

   

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

运行 Dart 命令行应用程序

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

2. 从所选内容的上下文菜单中，选择 运行 '<dart_file_name>'。 PyCharm 会生成一个类型为 Dart Command Line App 的运行/调试配置，并使用该配置启动您的应用程序。

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

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

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

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

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

创建 Dart Remote Debug 运行/调试配置

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 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() method 的调用，并从上下文菜单中选择 运行“<test_name>” 或 调试 '<test_name>'。

运行或调试测试组

打开测试文件，在编辑器中，右键点击对 group() method 的调用，并从上下文菜单中选择 运行 '<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. 选择配色方案，接受继承自默认设置的高亮设置，或按照 颜色与字体 中的说明对其进行自定义。