Skip to content

Kotlin 与 TeamCity 的持续集成 ​

在本页中,您将学习如何配置 TeamCity 来构建 Kotlin 应用程序。 有关 TeamCity 的安装和基本设置,请参阅 TeamCity 文档。

Kotlin 可以直接与 Gradle 和 Maven 等标准构建工具集成,因此在 TeamCity 中配置 Kotlin 构建的工作流程与配置任何其他项目相同。如果您改为使用 IntelliJ IDEA 构建系统来编译项目,TeamCity 也提供了专用的运行器。

Gradle 和 Maven ​

使用 Gradle 或 Maven 构建时,构建配置文件(build.gradle.kts 或 pom.xml)中已经声明了 Kotlin 依赖项和编译器插件。TeamCity 不需要任何额外的 Kotlin 专属设置。

对于 Gradle,请在构建配置中添加一个 Gradle 构建步骤,并指定要运行的 Step name(步骤名称)和 Gradle tasks(Gradle 任务)。 Gradle Build Step

同样,对于 Maven,请添加一个 Maven 构建步骤,并指定要执行的 Step name(步骤名称)和 Goals(目标)。

IntelliJ IDEA 构建系统 ​

如果使用 IntelliJ IDEA 项目文件构建项目,TeamCity 中的 Kotlin 版本必须与 IDE 项目中配置的版本相匹配。 您可以使用 TeamCity recipe 来自动化下载和配置 Kotlin 编译器。Recipe 是元运行器(meta-runner)的演进形态:它们的作用相同,但提供了额外的优势,例如 YAML 支持以及可在 JetBrains Marketplace 上轻松共享。

  1. 下载并导入 recipe。

    • 从 GitHub 下载 Kotlin 元运行器文件。
    • 将其作为新的 recipe 导入 TeamCity。有关详情,请参阅使用 recipe。 TeamCity recipe
  2. 添加获取 Kotlin 编译器步骤。

    • 使用导入的运行器添加一个构建步骤。
    • 指定 Step name(步骤名称)和所需的 Kotlin Version(Kotlin 版本)。 Setup Kotlin Compiler

在运行构建之前,请在构建配置中将 system.path.macro.KOTLIN.BUNDLED 添加为系统参数。 您可以为其指定任意占位符值,运行器将在构建时使用解析出的编译器路径将其覆盖。

  1. 添加编译步骤。 在获取编译器步骤之后添加一个 IntelliJ IDEA Project 运行器步骤,以编译项目并生成构建工件。 IntelliJ IDEA Project runner

其他 CI 服务器 ​

如果使用 TeamCity 以外的 CI 系统,直接在流水线脚本中调用标准的 Gradle 或 Maven 命令即可。

下一步 ​