build.gradle.kts とは？初心者向けガイドで学ぶ基礎と使い方共起語・同意語・対義語も併せて解説！

この記事を書いた人

高岡智則

年齢：33歳性別：男性職業：Webディレクター（兼ライティング・SNS運用担当）居住地：東京都杉並区・永福町の1LDKマンション出身地：神奈川県川崎市身長：176cm 体系：細身〜普通（最近ちょっとお腹が気になる）血液型：A型誕生日：1992年11月20日最終学歴：明治大学・情報コミュニケーション学部卒通勤：京王井の頭線で渋谷まで（通勤20分）家族構成：一人暮らし、実家には両親と2歳下の妹恋愛事情：独身。彼女は2年いない（本人は「忙しいだけ」と言い張る）

build.gradle.kts とは？

build.gradle.kts は Gradle のビルドスクリプトを Kotlin DSL で書くためのファイル名です。従来の Groovy DSL ではなく Kotlin 言語の文法を使います。初心者の人には最初は難しく感じるかもしれませんが、慣れると自然にビルド設定を素早く記述できるようになります。ここでは中学生にも分かるよう、できるだけ平易な言葉で基礎を解説します。

Gradle とはそもそものこと

Gradle は Java や Android のビルドを自動化するツールです。プログラムをどうコンパイルし、どう依存関係を解決し、どうパッケージするかを指示するスクリプトを用意します。Kotlin DSL はそのビルドスクリプトを Kotlin の文法で書く方法です。従来の Groovy DSL より型安全性が高く、統合開発環境 IDE の補完機能が使いやすいのが特徴です。

build.gradle.kts の基本構造

build.gradle.kts は通常、次のようなセクションで構成されます。plugins でプラグインを適用し、repositories で依存ライブラリを探す場所を指定し、dependencies で使うライブラリを宣言します。これらを組み合わせることでプロジェクトのビルドが決まります。ファイル名が build.gradle.kts になる点が Kotlin DSL の特徴です。

サンプルの構成要素を理解する

最初に覚えるべき三つの要点を把握しましょう。plugins はビルドに必要な機能を付与します。repositories はライブラリの探索先です。dependencies は実際に使うライブラリを宣言します。これらを正しく記述することで後の作業が格段に楽になります。

セクション	説明
plugins	ビルドに必要なプラグインを適用します
repositories	依存関係を探す場所を指定します
dependencies	実際に使うライブラリを宣言します

簡単な使い方の流れ

初めはシンプルなプロジェクトから始めましょう。Gradle Wrapper という仕組みを使えば、プロジェクトに必要な Gradle のバージョンを自動で揃えることができます。次に repositories と dependencies を整え、tasks の設定を少しずつ覚えると、ビルドの自動化がぐんと進みます。

初心者がつまずくポイント

よくあるつまずきは 依存関係のバージョン衝突 と 同名のタスクの競合 です。Kotlin DSL は型が決まっているため、エディタの補完機能を活用するとエラーを早めに見つけやすくなります。落ち着いてエラーメッセージを読み、対応する依存関係のバージョンを揃える練習をしましょう。

具体的な手順のイメージ

以下は構成のイメージです。実際のコードはプロジェクトに合わせて書き換えます。まずはプラグインの適用から始め、次にリポジトリと依存関係を追加します。最後にタスクの設定を行うことでビルドが走ります。

手順	1 プラグインを適用 2 リポジトリを指定 3 依存関係を宣言 4 タスク設定
ポイント	型安全な Kotlin DSL を活用し IDE 補完を活かす

まとめ

build.gradle.kts は Kotlin を使って Gradle のビルド設定を記述する新しいスタイルのファイルです。 Groovy DSL とは書き方が少し違いますが、基本的な考え方は同じです。初心者には最初は戸惑いがあるかもしれませんが、公式ドキュメントや入門記事を一歩ずつ読み進めると、自然と理解が深まります。焦らず、少しずつ慣れていくことが大切です。これから紹介するポイントを頭に入れておけば、Gradle のビルド設定を Kotlin DSL で扱えるようになります。

build.gradle.ktsの同意語

build.gradle.kts: Gradle のビルド設定を Kotlin で書くときのデフォルトのファイル名。拡張子は .gradle.kts。
Gradle Kotlin DSL ビルドスクリプト: Kotlin で記述された Gradle のビルドスクリプト（Kotlin DSL）を指す表現。
Kotlin DSL Gradle スクリプト: Kotlin DSL を用いた Gradle のビルドスクリプトのこと。
Gradle の Kotlin DSL ファイル: Gradle の設定を Kotlin DSL で記述するファイル形式のこと。
Kotlin ベースの Gradle ビルドファイル: Kotlin 言語をベースにした Gradle のビルドファイル。
Kotlin スクリプト版 Gradle ビルドスクリプト: Kotlin スクリプトとして記述された Gradle のビルドスクリプト。
Gradle Kotlin Script ファイル: Gradle の Kotlin Script によるビルド設定ファイルのこと。
Kotlin DSL のビルドスクリプト: Kotlin DSL 形式で書かれた Gradle のビルドスクリプト。
Kotlin で書かれた Gradle ビルドスクリプト: Kotlin 言語を使って作成された Gradle のビルドスクリプト。
Gradle の Kotlin スクリプト: Gradle の設定を Kotlin スクリプトで記述するファイルの総称。
Gradle における Kotlin DSL ビルドスクリプト: Gradle で Kotlin DSL を用いて書かれたビルドスクリプトの呼称。
Kotlin DSL ファイル（Gradle 用）: Gradle 用に特化して書かれた Kotlin DSL のファイル。
Kotlin ベースの Gradle 設定ファイル: Gradle の設定を Kotlin ベースで表現したファイル。
Gradle の Kotlin DSL 拡張子ファイル: .gradle.kts 拡張子の Kotlin DSL ファイルを指す表現。
Gradle の Kotlin スクリプトファイル: Gradle における Kotlin スクリプトとして用いられるファイル。

build.gradle.ktsの対義語・反対語

build.gradle: Gradle の Groovy DSL によるビルド設定ファイル。Kotlin DSL である build.gradle.kts の対義語としてよく挙げられ、同じ Gradle ツールでも記述言語が異なります。
Maven (pom.xml): Maven のビルド設定ファイル。XMLベースの構文で記述され、Kotlin DSL の Gradle とは別のビルドツール体系の代表格です。
Ant (build.xml): Ant のビルド設定ファイル。XML 形式で書く古典的なビルドツールで、Gradle の Kotlin DSL とは異なる世代のツールの象徴です。
XMLベースのビルド設定: XML 形式でのビルド設定全般のこと。Kotlin DSL で書く build.gradle.kts とは対照的な表現形式です。
Makefile: GNU Make のビルド定義ファイル。環境依存のスクリプト言語を使わず、宣言型ではなく手続き的な記述が特徴の古典的ビルド方法です。
Groovy DSL: Gradle の Groovy ベースの DSL。Kotlin DSL の対義語として挙げられる、別言語の DSL です。

build.gradle.ktsの共起語

build.gradle.kts: Gradle の Kotlin DSL を用いたビルド設定ファイル。Kotlin で記述され、依存関係・タスク・プラグインなどのビルド設定を定義します。
Gradle: ビルド自動化ツール。プロジェクトの依存関係解決やタスク実行、ビルドの全体管理を行います。
Kotlin DSL: Kotlin 言語を用いた Gradle の DSL。型安全で補完が効く点が特徴です。
Gradle Kotlin DSL: Gradle の Kotlin DSL の総称。build.gradle.kts や settings.gradle.kts などで利用されます。
Groovy DSL: Gradle の従来の DSL。build.gradle などは Groovy 言語で記述されることが多いです。
build.gradle: Groovy DSL で記述するビルド設定ファイル。Gradle の標準的なビルドスクリプトとして使われます。
settings.gradle.kts: マルチプロジェクトの設定を Kotlin DSL で記述する設定ファイルです。
settings.gradle: マルチプロジェクトの設定を Groovy DSL で記述する設定ファイルです。
plugins: ビルドに適用するプラグインを宣言するブロック。例: kotlin(
id
dependencies: ビルドが依存するライブラリやモジュールを宣言するブロックです。
repositories: 依存関係を取得するリポジトリの場所を宣言するブロックです。
tasks: ビルド内で定義する作業単位。カスタムタスクの作成や既存タスクの設定を行います。
wrapper: Gradle Wrapper の設定。特定の Gradle バージョンをプロジェクトに固定して実行します。
gradle-wrapper.properties: Gradle Wrapper の設定ファイル。distributionUrl などの情報を保持します。
version catalog: 依存関係のバージョンを一元管理する仕組み。libs.versions.toml などを使います。
libs.versions.toml: Version Catalog の定義ファイル。依存関係とそのバージョンを一箇所で管理します。
versionCatalogs: Version Catalog の設定セクション。settings.gradle.kts や build.gradle.kts から参照します。
Kotlin plugin: Kotlin を使って JVM/Android などをビルドするための Gradle プラグインです。
Android Gradle Plugin: Android アプリのビルドを支援する Gradle プラグイン。Android Studio でよく使われます。
Java plugin: Java プロジェクトをビルドするための Gradle プラグインです。
multi-project: 複数のサブプロジェクトを含むビルド構成のことを指します。
project: Gradle におけるビルドの単位。ルートプロジェクトやサブプロジェクトを指します。
subprojects: マルチプロジェクト構成におけるサブプロジェクトへの共通設定を適用する対象です。
gradle.properties: ビルド実行時の設定を格納するファイル。環境変数の代替的な用途で使われます。
buildSrc: ビルド用の自作プラグインやコードを格納する専用ディレクトリ。再利用性を高めます。

build.gradle.ktsの関連用語

build.gradle.kts: Gradleのビルド設定をKotlin DSLで記述するファイル。モジュールごとに設置され、依存関係やタスク、プラグインの設定を定義します。
Gradle: ビルド自動化ツール。依存関係の解決、タスクの実行、ビルドのライフサイクル管理を行います。
Kotlin DSL: GradleのスクリプトをKotlinで記述する方法。静的型とIDE補完が利く点が特徴です。
Groovy DSL: Gradleの従来のスクリプト言語であるGroovyベースの記述方法。互換性は高いが型安全性は低めです。
settings.gradle.kts: 複数モジュールを管理する設定ファイル。include でモジュールを宣言し、ルート設定を行います。
Gradle Wrapper: 特定のGradleバージョンをプロジェクトに同梱して使用する仕組み。gradlewスクリプトなどを含みます。
gradle-wrapper.properties: Wrapperの設定ファイル。使用するGradleのバージョンやダウンロード先を指定します。
gradlew: Unix系のGradle実行スクリプト。Wrapper経由でビルドを起動します。
gradlew.bat: Windows向けGradle実行スクリプト。
gradle.properties: パフォーマンス設定や共通プロパティを格納するファイル。
libs.versions.toml: Version Catalogsの定義ファイル。ライブラリの名前とバージョンを一元管理します。
versionCatalogs: Version Catalogs機能を有効化する設定。依存関係の参照を統一します。
Plugins block: プラグインを宣言・適用するブロック。Kotlin DSLでの記述が主流です。
プラグインチューニングの例: プラグインをIDとバージョンで宣言する一般的な書き方を含む実践説明。
kotlin jvm プラグイン: KotlinとJVM向けのプラグインを適用する宣言。KotlinコードをJVM上で動かす前提です。
org.jetbrains.kotlin.jvm プラグイン: KotlinのJVM向け公式プラグインを適用する宣言の別表現。
dependencies block: 依存関係を宣言するブロック。ライブラリやモジュールをプロジェクトに取り込みます。
repositories block: 依存関係を取得するリポジトリを指定するブロック。
mavenCentral: Maven Centralリポジトリを使用する宣言。多くの公開ライブラリのデフォルト場所です。
google(): Googleのリポジトリを追加する宣言。Android関連ライブラリの取得先として重要です。
maven { url = uri(...) }: カスタムのMavenリポジトリを追加する記述。特定の私用リポジトリへアクセスします。
jcenter: JCenterリポジトリの宣言。現在は非推奨となっています。
implementation: 依存関係の実装用配置。実行時にも必要なライブラリを追加します。
api: 公開APIとして依存関係を扱う設定。モジュールの消費者に影響を与えます。
testImplementation: テストコード用の依存関係。
testRuntimeOnly: テスト実行時のみ必要な依存関係。
compileOnly: コンパイル時のみ必要で実行時には不要な依存関係。
runtimeOnly: 実行時のみ必要な依存関係。
kapt: Kotlinのアノテーション処理用の依存関係。Kaptを使う場合に指定します。
ksp: Kotlin Symbol Processing の略。アノテーション処理の別手段。
Kotlin Multiplatform: 複数のプラットフォーム向けにビルドする設定。例として JVM, JS, Native など。
buildSrc: ビルド用の共通ロジックを格納する特別なソースディレクトリ。再利用性を高めます。
sourceSets: ソースコードの配置（main, test など）を定義するセクション。
tasks: Gradleのタスクを管理・定義するブロック。
tasks.register: 新しいタスクを登録する推奨方法。
tasks.named: 既存のタスクを名前で参照して設定する方法。
kotlinOptions: Kotlinのコンパイルオプションを設定するブロック。
jvmTarget: Kotlinのコンパイル対象JVMバージョンを指定する設定。
Java toolchains: Javaツールチェーンを使用する設定。特定のJavaバージョンでビルドを固定します。
group: プロジェクトのグループIDを設定します。
version: プロジェクトのバージョンを設定します。
extra properties: 追加のカスタムプロパティを定義・参照する仕組み。
ext: Groovy風の追加プロパティ表現。Kotlin DSLでも活用方法が異なります。
resolutionStrategy: 依存関係の解決戦略を設定。特定のバージョンを強制したり排他処理を行います。
buildCache: ビルドキャッシュの設定。ビルド速度の改善に寄与します。
configuration cache: 構成キャッシュ。次回ビルドの初期化を高速化します。
platform / BOM: プラットフォーム（BOM）を使って依存関係のバージョンを統一管理します。
publishing: 成果物をリポジトリへ公開する設定ブロック。
maven-publish: Maven形式で公開する公式プラグイン。
publishing block: 公開設定を記述するブロック。
repositories for publishing: 公開先のリポジトリを指定する設定。
Gradle Plugin Portal: 公式プラグインの配布先サイト。プラグインの探索に使います。
type-safe accessors: バージョンカタログを使って依存を型安全に参照する機能。
IDEサポート: IntelliJ IDEAやAndroid Studioにおける補完やリファクタリングの支援。
Gradle 7+: 重要な新機能やパフォーマンス改善が導入された主要バージョン。
BOM usage: 依存関係の整合性を保つために BOM を使う方法。
include in settings: 設定ファイルでモジュールを含める宣言。
rootProject / subprojects: ルートプロジェクトとサブプロジェクトの関係を定義します。
incremental builds: 増分ビルド。変更があった部分だけ再ビルドします。
dependency locking: 依存関係のロック機能。再現性のあるビルドを保証します。
Android Gradle Plugin: Android プロジェクト向けのGradleプラグイン。特定の設定が必要です。
Code samples: 公式や学習リソースにある実例コードを参照すると理解が深まります。