IntelliJ IDEA
 
2023.2
快捷方式：Windows
获取 IntelliJ IDEA
  1. 编译与构建
  2. 构建工具
  3. 摇篮
  4. Gradle 运行/调试配置

运行/调试配置：Gradle

最后修改时间：2023 年 9 月 7 日

所需插件：Gradle（默认下载并启用）

创建：运行| 编辑配置| 添加新配置 | 摇篮

有关更多信息，请参阅Gradle部分。

您可以使用运行配置来运行 Gradle 任务。此类配置中列出的默认选项足以运行您的任务。如果需要，您还可以使用其他选项或添加更多任务和参数来创建高级配置。

创建运行/调试 Gradle 配置

  1. 从主菜单中，选择“添加配置”。或者，右键单击Gradle工具窗口中的任意任务，然后选择“修改运行配置”。

  2. 在“名称”字段中指定配置的名称，以便在编辑或运行配置时（例如，从“运行”弹出窗口或Gradle工具窗口）快速识别它。AltShiftF10

  3. 指定您希望配置运行的位置。默认的本地计算机选项将在您的计算机上本地运行您的配置。

    您可以更改运行执行的位置。例如，使用 SSH 或 Docker 来运行您的目标。

    您还可以在WSL上运行您的目标。如果您需要配置新目标或更改现有配置，请单击“管理目标”，然后在“运行目标”对话框中添加您的更改。有关更多信息，请参阅运行目标。

  4. 如果需要，请指定存储为项目文件，以保存具有运行配置设置的文件，以便您可以与其他团队成员共享。默认位置是.idea/runConfigurations。但是，如果您不想共享.idea目录，则可以将配置保存到项目内的任何其他目录。

    要更改位置，请选择此选项并单击管理文件位置图标，在打开的对话框中添加新位置。

  5. 如果您不需要在Run字段中指定任何内容，则默认任务，例如在Before buildhelp部分中指定的 和 任务。部分将被执行。或者，如果您从Gradle工具窗口创建运行配置，则您选择的任务将显示在此字段中。但是，您可以为运行配置指定其他外部任务和参数。使用空格将一项任务与另一项任务分开。如果您想查看 Gradle 任务和参数的可用列表，请单击该字段。插入任务和参数图标

  6. 指定 Gradle 项目的位置。

    您可以手动输入，也可以单击浏览按钮并指向打开的对话框中的所需位置。但是，如果您从Gradle工具窗口创建运行配置，IntelliJ IDEA 将自动显示项目的名称。

    您还可以单击Gradle 注册项目 模块节点图标，从现有 IntelliJ IDEA 项目中的注册 Gradle 模块列表中选择可用的 Gradle 模块。

    如果需要，您可以指定构建脚本文件的路径而不是项目路径。如果您有想要引用的自定义构建脚本，这可能会有所帮助。

  7. 如果需要，请指定要在项目中使用的环境变量。

  8. 以下默认选项已启用，但您可以单击“修改选项”以添加新选项或在“添加运行选项”中删除一些默认选项：

    • 启动时打开运行/调试工具窗口- 执行配置时自动打开运行/调试工具窗口和多个调试器选项

    • 调试 Gradle 脚本- 在 Gradle 脚本中启用断点。

      当您使用编辑器或上下文菜单中的左侧装订线执行测试时，此选项将被禁用。这样做是为了加快调试过程。

单击“修改选项”可添加更多运行选项或删除上述一些默认选项。

等级配置设置

操作系统

物品

描述

允许多个实例

选择此选项以允许并行运行此运行配置的多个实例。默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，IntelliJ IDEA 建议停止正在运行的实例并启动另一个实例。当运行配置消耗大量资源并且没有充分理由运行多个实例时，这非常有用。

爪哇

物品

描述

虚拟机选项

指定启动应用程序时要传递给 Java 虚拟机的选项，例如-mx、-verbose等。

指定 JVM 选项时，请遵循以下规则：

  • 使用空格分隔各个选项。

  • 如果选项的值包含空格，请用双引号将该值或实际空格括起来。

  • 如果选项包含双引号作为值的一部分，请使用反斜杠转义双引号。

  • 您可以将环境变量值传递给自定义 Java 属性。

-Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}

在此字段中使用代码完成：开始键入标志的名称，IDE 会建议可用命令行选项的列表。这适用于-XX:和-X选项以及一些 IntelliJ IDEA 未自动配置的标准选项，例如-ea，但不适用于-cp或–release。

该字段中指定的选项-classpath将覆盖模块的类路径。

日志

您可以选择在运行或调试时生成的日志文件应显示在控制台中，即显示在“运行”或“调试”工具窗口的专用选项卡上。stdout您还可以选择将控制台输出保存到文件或在消息打印到或时显示控制台输出的选项stderr。

代码覆盖率

您可以选择与使用代码覆盖率运行配置相关的选项。

发布前

您可以在执行运行配置之前选择要添加的其他选项。例如，您可以添加要在运行配置之前执行的 Gradle 任务。

单击“添加启动前任务”，然后在打开的列表中选择Gradle 任务，然后在打开的对话框中配置您的任务。

摇篮

物品

描述

调试执行图上的所有任务

当您选择此选项时，将调试执行图中的每个任务。例如，您尝试调试的任务的所有相关任务。

在单独的调试选项卡中调试分叉的 Gradle 任务

选择此选项可在“调试”工具窗口的单独选项卡中运行调试过程。

作为测试运行

默认情况下，此选项处于禁用状态。在这种情况下，IntelliJ IDEA 不会打开运行工具窗口，并且不会重新运行测试任务（如果它们是最新的）。

但是，如果 IntelliJ IDEA 在运行配置中找到测试任务，这些任务会在Gradle工具窗口中突出显示，IntelliJ IDEA 不会重新运行测试任务，而是打开 Gradle 工具窗口。

运行按钮当您使用装订线或上下文菜单从编辑器触发测试执行时，该选项将启用。

在这种情况下，IntelliJ IDEA 会打开运行工具窗口，并在每次触发执行时重新运行测试任务，即使测试是最新的也是如此。

此选项可能有助于控制项目中测试任务的重新运行过程。