本文档的内容是由机器翻译的。请通过反馈微件提交您的反馈。
 

IntelliJ IDEA 项目

最后修改日期： 2025年 3月 21日

IntelliJ IDEA Project 构建运行程序允许您构建在 IntelliJ IDEA 中创建的项目。

支持的 IntelliJ IDEA 功能

TeamCity IntelliJ IDEA 运行器支持 IntelliJ IDEA 功能的子集：

功能

状态

备注，限制

Java

plus.png

Runner 能够编译 Java 项目

JUnit 3.x / 4.x

plus.png ，有限制

  • 测试运行器参数不受支持

  • 在测试开始前运行 Maven 是不被支持的

  • 不支持替代 JRE

TestNG

plus.png ，有限制

  • 测试运行器参数不受支持

  • 在测试开始前运行 Maven 是不被支持的

  • 从组中运行测试不受支持

  • 不支持替代 JRE

应用程序运行配置

plus.png ，有限制

  • 在测试开始前运行 Maven 是不被支持的

  • 不支持替代 JRE

J2EE 集成

plus.png

Runner 能够生成带有必要描述符的 WAR 和 EAR 归档文件

JPA

plus.png

Runner 在生成的工件中添加必要的描述符

GWT

plus.png

Runner 可以调用 GWT 编译器并将编译结果添加到工件中

Groovy

plus.png ，有限制

Runner 能够编译包含 Groovy 代码的项目并运行以 Groovy 编写的测试，但不支持 Groovy 脚本运行配置。

Android

plus.png

Flex

minus.png

覆盖率

minus.png ，如果在运行配置中指定

基于 IntelliJ IDEA 的覆盖率可在运行器设置页面上单独配置

性能分析插件

minus.png

IntelliJ IDEA 项目设置

选项

描述

项目的路径

使用此字段来指定项目文件（.ipr ）的路径，或者指定含有 .idea 目录的项目目录（项目的根目录）的路径。 这些信息是构建运行程序需要的，以理解项目的结构。

路径应相对于签出目录。

在 *.iml 文件中检测全局库和基于模块的 JDK

如果勾选此选项，则在保存时，所有模块文件将自动扫描全局库和模块 JDK 的引用。 这可以帮助您确保所有引用都能得到正确解析。

warning

当选择此选项时，打开和保存构建运行程序设置的过程可能会变得耗时，因为它涉及加载和解析所有项目模块文件。

检查 / 重新解析项目

点击以重新解析项目，并直接从 IDEA 项目中导入构建设置，例如 JDKs 列表。

note

如果您在 IntelliJ IDEA 中更新了项目设置——添加了新的 JDK、库，请不要忘记通过单击 检查 / 重新解析项目 更新构建运行器设置。

工作目录

输入一个路径到 构建工作目录 ，如果它与 构建检出目录 不同。

如有不同，可选地指定与检出目录不同的目录。

未解决的项目模块和路径变量

当 IntelliJ IDEA 模块文件（.iml ）被 IPR 文件引用时，此部分会显示：

  • 找不到

  • 允许您输入在 IPR-file 中使用的路径变量的值

要刷新此部分中的值，请单击 检查 / 重新解析项目。

选项

描述

<path_variable_name>

如果项目文件包含路径宏，该字段将显示，这些路径宏在 IntelliJ IDEA 的设置对话框中的路径变量对话框中定义。 在 将值设置为 中，指定项目资源的路径，以便在不同的构建代理上使用。

项目 JDKs

这一部分提供了项目中检测到的 JDKs 列表。

选项

描述

JDK 主页

使用此字段来为项目指定 JDK 主目录。

note

对于 检查 和 重复项查找器 构建，此 JDK 将在内部用于解析项目中使用的 Java API。
要运行构建过程本身，将使用 JAVA_HOME 环境变量中指定的 JDK。

JDK Jar 文件模式

点击此链接以打开一个文本区域，您可以在其中为项目 JDK 的 .jar 文件定义模板。 使用 Ant 规则来定义 .jar 文件模式。
默认值用于 Linux 和 Windows 操作系统：

jre/lib/*.jar

对于 macOS ，请使用以下行：

lib/*.jar

../Classes/*.jar

IDEA 主页

如果您的项目使用 IDEA JDK， 请指定 IDEA 主目录的位置

IDEA Jar 文件模式

点击此链接可以打开一个文本区域，您可以在其中定义 IDEA JDK 的 .jar 文件模板。

note

在定义值时，您可以使用对外部属性的引用，例如 %system.idea_home% 或 % \ env.JDK_1_3 %。 这将为相应的属性添加一个 需求。

Java 参数

选项

描述

JDK

选择一个 JDK。 本节详述了可用的选项。 默认值为 JAVA_HOME 环境变量或代理自身的 Java。

JDK 主目录路径

当上方选择了 <Custom> 时，此选项便可用。使用此字段来指定用于运行构建的自定义 JDK 的路径。 如果该字段为空，则会从代理机器的 JAVA_HOME 环境变量或在 构建代理配置 文件（buildAgent.properties ）中指定的 env.JAVA_HOME 属性读取JDK Home的路径。 如果这些值未被指定，TeamCity 将使用构建代理进程本身的 Java home。

JVM 命令行参数

附加的 JVM 命令行参数允许您设置初始和最大堆大小，启用额外的日志记录，选择所需的字节码验证器模式等等。

您可以指定标准的（例如以 - 开始，例如 -verbose：[class|module|gc|jni] 或 --dry-run ）和非标准的（例如以 -X 开始，例如 -Xmx<size> 或 -XstartOnFirstThread ）JVM 选项。

要指定多个命令行参数，使用空格作为分隔符。 例如：

-verbose:gc -Xdiag -Xcomp -Xmx512m -Xms256m

编译设置

选项

描述

只编译构建工件和执行运行配置所需的类

选择是否要编译项目中的所有类，或者只编译运行配置或构建工件所需的类。

工件

选项

描述

构建的工件

在此指定需要构建的工件名称，这些工件在 IntelliJ IDEA 项目中已配置。

Run configurations

选项

描述

执行运行配置

在此处指定在项目中配置的 IntelliJ IDEA 运行配置的名称，以在 TeamCity 构建中执行。 支持的配置类型包括：JUnit 、TestNG 和 Application。 请注意，这里指定的运行配置应当是 共享的（通过 IntelliJ IDEA 的 运行/调试配置对话框中的 "Share" 复选框），并且要将其签入到版本控制中。

在 IDEA 运行配置的 启动前 列表中指定的 Ant 和 Build Artifacts 任务得到了支持。

测试参数

  • 要了解有关 首先运行最近失败的测试 和 首先运行新的和修改过的测试 选项的更多信息，请参阅 优先运行风险组测试页面。

  • 仅运行受影响的测试（基于依赖关系） 选项将考虑构建更改。 启用此选项后，运行器会计算当前构建更改影响的模块，并且只会执行那些直接或间接依赖于受影响模块的运行配置。

Code Coverage（代码覆盖率）

指定代码覆盖率选项，具体细节请参阅 IntelliJ IDEA 代码覆盖率 页面。

See also

Administrator's Guide