Kotlin と TeamCity による継続的インテグレーション
このページでは、Kotlin アプリケーションをビルドするために TeamCity を設定する方法について説明します。 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 を指定します。 
同様に Maven の場合は、Maven ビルドステップを追加し、Step name と実行したい Goals を指定します。
IntelliJ IDEA ビルドシステム
IntelliJ IDEA プロジェクトファイルを使用してプロジェクトをビルドする場合、TeamCity 内の Kotlin バージョンは IDE プロジェクトで設定されているバージョンと一致している必要があります。 TeamCity のレシピ(recipe)を使用すると、Kotlin コンパイラのダウンロードと設定を自動化できます。レシピはメタランナー(meta-runner)の発展形であり、同じ目的を持ちながら、YAML のサポートや JetBrains Marketplace での簡単な共有といった追加の利点を提供します。
レシピをダウンロードしてインポートします。
- GitHub から Kotlin メタランナーファイルをダウンロードします。
- 新しいレシピとして TeamCity にインポートします。詳細については、Working with recipes を参照してください。

Kotlin コンパイラ取得ステップを追加します。
- インポートしたランナーを使用してビルドステップを追加します。
- Step name と必要な Kotlin Version を指定します。

ビルドを実行する前に、ビルド設定で system.path.macro.KOTLIN.BUNDLED をシステムパラメータとして追加してください。 任意のプレースホルダー値を設定でき、ランナーはビルド時に解決されたコンパイラパスでそれを上書きします。
- コンパイルステップを追加します。 コンパイラ取得ステップの後に IntelliJ IDEA Project ランナーステップを追加して、プロジェクトをコンパイルし、ビルドアーティファクトを生成します。

その他の CI サーバー
TeamCity 以外の CI システムを使用している場合は、パイプラインスクリプト内で標準の Gradle または Maven コマンドを直接実行してください。
次のステップ
- Kotlin Multiplatform アプリケーションのビルド、テスト、デプロイを行うために、Kotlin Multiplatform アプリケーション向けに TeamCity を設定する方法 を学びます。
- チュートリアルに従って、ホストされた macOS エージェント上で Kotlin Multiplatform プロジェクト用の iOS 配信パイプラインを設定 し、TestFlight へのデプロイを自動化します。
- プロジェクト設定をバージョン管理に保存 し、Kotlin DSL を使用してパイプラインをコードとして管理する方法について学びます。
