このページは Cloud Translation API によって翻訳されました。

ビルド構成を Groovy から Kotlin に移行する

Android Gradle プラグイン 4.0 で、Gradle ビルドで Kotlin を使用するためのサポートが追加されました Terraform というプログラミング言語の Groovy の後継としてよく使用されます。

Kotlin は、Gradle スクリプトの記述には Groovy より好まれます。Kotlin はコンパイル時のチェックと IDE のサポートが向上します。

現在、Kotlin は Android Studio のコードとより緊密に統合されていますが、 Groovy と比較すると、Kotlin を使用したビルドは使用するかを判断する際は、ビルドのパフォーマンスを考慮してください。移行できます。

このページでは、Android アプリの Gradle が Groovy から Kotlin にファイルをビルドします。より包括的な移行のために Gradle の公式ドキュメントをご覧ください。

タイムライン

Android Studio Giraffe 以降の新しいプロジェクトでは Kotlin DSL を使用するビルド構成のデフォルト（build.gradle.kts）。これにより、 Groovy DSL（build.gradle）よりも優れた編集エクスペリエンスハイライト表示、コードの補完、宣言へのナビゲーションです。詳しくは詳しくは、 Gradle Kotlin DSL Primer。

よく使用する用語

Kotlin DSL: 主に Android Gradle プラグイン Kotlin DSL のことを指します。基となる Gradle Kotlin DSL を指すこともあります。

この移行ガイドでは、「Kotlin」は「Kotlin DSL」はすべて同じ意味で使用されます同様に "Groovy"「Groovy DSL」などのすべて同じ意味で使用されます

スクリプトファイルの名称

スクリプトファイルの拡張子は、ビルドファイルが記述されている言語に基づきます。

Groovy で記述した Gradle ビルドファイルは、ファイル名拡張子 .gradle を使用します。
Kotlin で記述した Gradle ビルドファイルは、ファイル名拡張子 .gradle.kts を使用します。

構文を変換する

Groovy と Kotlin の構文には一部異なる点があるため、それらの違いをビルドスクリプト全体に反映する必要があります。

メソッド呼び出しにかっこを追加する

メソッド呼び出しのかっこは、Groovy では省略できますが Kotlin では必須です。構成を移行するには、かっこが省略されているメソッド呼び出しにかっこを追加します。Groovy で設定を構成する場合のコードは次のようになっています。

compileSdkVersion 30

これを Kotlin で記述すると次のようなコードになります。

compileSdkVersion(30)

代入呼び出しに `=` を追加する

Groovy DSL では、次の場合に代入演算子 = を省略できます。プロパティの割り当ては可能ですが、Kotlin では必須です。Groovy でプロパティを代入する場合のコードは次のようになっています。

java {
    sourceCompatibility JavaVersion.VERSION_17
    targetCompatibility JavaVersion.VERSION_17
}

Kotlin でプロパティを代入するには次のようなコードを記述します。

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

文字列を変換する

Groovy と Kotlin では、文字列に関して以下のような違いがあります。

文字列の二重引用符: Groovy では一重引用符を使用して文字列を定義できますが、Kotlin では二重引用符を使用する必要があります。
ドット表記の文字列補間: Groovy ではドット表記の文字列補間に接頭辞 $ を使用できますが、Kotlin ではドット表記を中かっこで囲む必要があります。たとえば、Groovy では次のスニペットのように $project.rootDir を使用できます。
```
    myRootDirectory = "$project.rootDir/tools/proguard-rules-debug.pro"
    
```
一方、Kotlin では project.rootDir ではなく project で toString() を呼び出します。ルートディレクトリの値を取得するには、${project.rootDir} のように中かっこで囲みます。
```
    myRootDirectory = "${project.rootDir}/tools/proguard-rules-debug.pro"
    
```
詳細については、Kotlin ドキュメントの文字列テンプレートをご覧ください。

ファイル拡張子を変更する

コンテンツを移行する際に、各ビルドファイルに .kts を追加します。たとえば、ビルドファイル settings.gradle を選択したら、ファイル名を settings.gradle.kts を実行し、ファイルの内容を Kotlin に変換します。各ビルドファイルの移行後もプロジェクトがコンパイルされていることを確認します。

まずは小さなファイルの移行から始めて作業に慣れてください。Google Chat ではプロジェクトに Kotlin と Groovy のビルドファイルが混在しているため、慎重に移行してください。

`def` を `val` または `var` で置き換える

Kotlin で変数を定義できるよう、def を val または var で置き換えます。Groovy では次のように変数を宣言します。

def building64Bit = false

これを Kotlin で記述すると次のようなコードになります。

val building64Bit = false

ブール値プロパティに接頭辞 `is` を追加する

Groovy はプロパティ控除ロジックを使用しています自動的に作成されます。ブール値プロパティ foo の場合、推定メソッドは getFoo、setFoo、または isFoo になります。Kotlin では推定メソッドがサポートされていないため、プロパティ名を推定メソッド名に変更する必要があります。たとえば、buildTypes DSL ブール値要素には、接頭辞 is を追加する必要があります。Groovy では、次のようなコードでブール値プロパティを設定します。

android {
    buildTypes {
        release {
            minifyEnabled true
            shrinkResources true
            ...
        }
        debug {
            debuggable true
            ...
        }
    ...

これを Kotlin で記述すると次のようなコードになります。プロパティには接頭辞 is が追加されています。

android {
    buildTypes {
        getByName("release") {
            isMinifyEnabled = true
            isShrinkResources = true
            ...
        }
        getByName("debug") {
            isDebuggable = true
            ...
        }
    ...

リストとマップを変換する

Groovy と Kotlin では、リストとマップを定義する構文が異なります。Groovy では [] を使用しますが、Kotlin では listOf または mapOf を使用してコレクション作成メソッドを明示的に呼び出します。移行時には、[] を listOf または mapOf に置き換える必要があります。

Groovy では、次のようなコードでリストを定義します。

jvmOptions += ["-Xms4000m", "-Xmx4000m", "-XX:+HeapDumpOnOutOfMemoryError</code>"]

これを Kotlin で記述すると次のようなコードになります。

jvmOptions += listOf("-Xms4000m", "-Xmx4000m", "-XX:+HeapDumpOnOutOfMemoryError")

Groovy では、次のようなコードでマップを定義します。

def myMap = [key1: 'value1', key2: 'value2']

これを Kotlin で記述すると次のようなコードになります。

val myMap = mapOf("key1" to "value1", "key2" to "value2")

ビルドタイプを設定する

Kotlin DSL で暗黙的に使用できるビルドタイプは debug と release のみです。これら以外のすべてのカスタムビルドタイプは手動で作成する必要があります。

Groovy では、debug や release 以外にも、先に作成していなくても使用できるビルドタイプがあります。次のコードスニペットに、Groovy でビルドタイプ debug、release、benchmark を使用する構成を示します。

buildTypes {
 debug {
   ...
 }
 release {
   ...
 }
 benchmark {
   ...
 }
}

Kotlin で同等の構成を作成するには、 benchmark ビルドタイプ。

buildTypes {
 debug {
   ...
 }

 release {
   ...
 }
 register("benchmark") {
    ...
 }
}

buildscript から plugins ブロックに移行する

ビルドで buildscript {} 追加する場合は、リファクタリングして plugins {} ブロックしてください。plugins {} ブロックを使用すると、プラグインを簡単に適用できるほか、適切に機能するバージョンカタログをご覧ください。

また、ビルドファイルで plugins {} ブロックを使用する場合は、 Android Studio は、ビルドが失敗してもコンテキストを認識します。このコンテキストを使用すると、Kotlin DSL ファイルを修正できます。これにより、Studio IDE で次のことが可能になります。その他の有用な提案を行う方法を学びます。

プラグイン ID を確認する

一方、buildscript {} ブロックでは、次のコマンドを使用して、ビルドクラスパスにプラグインを追加します。 Maven 座標プラグインのバージョン（例: com.android.tools.build:gradle:7.4.0） plugins {} ブロックでは、代わりにプラグイン ID を使用します。

ほとんどのプラグインでは、プラグイン ID は、 apply plugin。たとえば、次のプラグイン ID は Android Gradle プラグイン:

com.android.application
com.android.library
com.android.lint
com.android.test

プラグインの全リストについては、 Google Maven リポジトリ。

Kotlin プラグインは複数のプラグイン ID で参照できます。「新規顧客の獲得」目標を名前空間付きプラグイン ID を作成し、短縮形から名前空間付きプラグイン ID にリファクタリングします。次の表をご覧ください。

プラグイン ID の省略形	名前空間付きプラグイン ID
`kotlin`	`org.jetbrains.kotlin.jvm`
`kotlin-android`	`org.jetbrains.kotlin.android`
`kotlin-kapt`	`org.jetbrains.kotlin.kapt`
`kotlin-parcelize`	`org.jetbrains.kotlin.plugin.parcelize`

URL でプラグインを検索することもできます。 Gradle プラグインポータル Maven Central Repository および Google Maven リポジトリ。読むカスタム Gradle プラグインの開発をご覧ください。

リファクタリングを実行する

使用するプラグインの ID がわかったら、次の手順を行います。

buildscript {} で宣言されたプラグインのリポジトリがまだある場合 settings.gradle に移動します。ファイルを使用してください。
プラグインを最上位の plugins {} ブロックに追加します。 build.gradle ファイル。ID と文字列を指定する必要があります。プラグインのバージョンをここに示します。プラグインが適用するには、apply false を使用します。
最上位の build.gradle.kts ファイルから classpath エントリを削除します。
プラグインを plugins {} ブロックに追加し、モジュールレベルの build.gradle ファイル。必要なのは、プラグインのバージョンがルートプロジェクトから継承されるため。
モジュールレベルからプラグインの apply plugin 呼び出しを削除 build.gradle ファイル。

たとえば、この設定では buildscript {} ブロックを使用しています。

// Top-level build.gradle file
buildscript {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:7.4.0")
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.0")
        ...
    }
}

// Module-level build.gradle file
apply(plugin: "com.android.application")
apply(plugin: "kotlin-android")

plugins {} ブロックを使用した同等の設定は次のとおりです。

// Top-level build.gradle file
plugins {
   id 'com.android.application' version '7.4.0' apply false
   id 'org.jetbrains.kotlin.android' version '1.8.0' apply false
   ...
}

// Module-level build.gradle file
plugins {
   id 'com.android.application'
   id 'org.jetbrains.kotlin.android'
   ...
}

// settings.gradle
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

plugins ブロックを変換する

plugins {} ブロックからプラグインを適用する方法は、Groovy と Kotlin で類似しています。次のコードは、バージョンカタログ:

// Top-level build.gradle file
plugins {
   alias libs.plugins.android.application apply false
   ...
}

// Module-level build.gradle file
plugins {
   alias libs.plugins.android.application
   ...
}

Kotlin で同じ処理を行うコードは次のようになります。

// Top-level build.gradle.kts file
plugins {
   alias(libs.plugins.android.application) apply false
   ...
}

// Module-level build.gradle.kts file
plugins {
   alias(libs.plugins.android.application)
   ...
}

次のコードは、インストールを行っていない場合に、Groovy でプラグインを適用する方法を示しています。バージョンカタログを使用する:

// Top-level build.gradle file
plugins {
   id 'com.android.application' version '7.3.0' apply false
   ...
}

// Module-level build.gradle file
plugins {
   id 'com.android.application'
   ...
}

Kotlin で同じ処理を行うコードは次のようになります。

// Top-level build.gradle.kts file
plugins {
   id("com.android.application") version "7.3.0" apply false
   ...
}

// Module-level build.gradle.kts file
plugins {
   id("com.android.application")
   ...
}

plugins {} ブロックの詳細については、適用プラグインをご覧ください。

その他

その他の機能の Kotlin コードサンプルについては、以下のドキュメントページをご覧ください。

ProGuard 構成がある場合は、圧縮、難読化、最適化の有効化をご覧ください。
signingConfig {} ブロックがある場合は、ビルドファイルから署名情報を削除するをご覧ください。
プロジェクト全体のプロパティを使用する場合は、追加プロパティを使用してプロジェクト全体のプロパティを構成するをご覧ください。

既知の問題

現在、既知の問題が Kotlin は Groovy よりもビルド速度が遅くなる可能性があります。

問題を報告する方法

問題の優先順位の判断に必要な情報を提供する方法については、ビルドツールと Gradle バグの詳細をご覧ください。その後、Google の公開 Issue Tracker を使用してバグを報告します。

その他のリソース

Kotlin で記述された Gradle ビルドファイルの実際の例については、 Now In Android サンプルアプリご覧ください。

ビルド構成を Groovy から Kotlin に移行する

タイムライン

よく使用する用語

スクリプト ファイルの名称

構文を変換する

メソッド呼び出しにかっこを追加する

代入呼び出しに = を追加する

文字列を変換する

ファイル拡張子を変更する

def を val または var で置き換える

ブール値プロパティに接頭辞 is を追加する

リストとマップを変換する

ビルドタイプを設定する

buildscript から plugins ブロックに移行する

プラグイン ID を確認する

リファクタリングを実行する

plugins ブロックを変換する

その他

既知の問題

問題を報告する方法

その他のリソース

スクリプトファイルの名称

代入呼び出しに `=` を追加する

`def` を `val` または `var` で置き換える

ブール値プロパティに接頭辞 `is` を追加する