Android：告别 Groovy！将我们的 build.gradle 迁移至 Kotlin

原文地址：Android: ¡Adios Groovy! Migrar a Kotlin nuestro build.gradle

作者：Marco Ramírez

Groovy 的文档通知称Kotlin 脚本（KTS）现在将称为默认的语言用于依赖同步，并且从新版本的 Android Studio 开始，这个过程将称为新应用的默认设置。因此，这个简短的教程将帮助你将一个小项目从 Groovy 迁移到 KTS。

什么是 KTS？

KTS 是 Kotlin 脚本的缩写。从 Groovy 转换到 Kotlin 并不意味着我们将改变在 Android 中导入库的核心方式，仍然会通过 Gradle 进行。对于新手来说，Gradle 是一种构建工具和自动化工具，兼容多种编程语言；它是用 Java 构建的，当 Android Kit Kat 发布时，取代了 Ant。

KT 文件和 KTS 文件之间有几个区别，其中之一是 KT 文件由 Kotlin 编辑器解释，而 KTS 文件由Kotlin 的脚本支持解释，因此无需提前贬义。在这种情况下，Gradle 会考虑 KTS 文件，无需事先编译。

这会花很长时间吗？

许多人可能会认为这很困难且耗时，但实际上非常简单，因为只需在 build.gradle 文件中更改某些语法就可以实现。现在是时候动手了

1、更改 setting.gradle

首先，将文件名更改为带有.kts扩展名的文件，并在文件中添加以下行：

include: ':app'

在 KTS 中，你需要将上述行为更改为以下内容：

include("app")

在这个文件中不需要再做其他操作，即使你想尝试一下，也可以同步你的依赖想项。但是，请务必不要使用单引号，因为 Kotlin 会将其解释为字符并引发错误。在字符串中尽量使用双引号以避免出现任何问题。

2、更改根 build.gradle

现在，假设你要在根 build.gradle 文件中更改文件名，并且有版本变量（在“ext”节点中），请按照以下步骤操作：

buildscript {
    ext.androidGradleVersion = "8.0.1"
    ext.androidKotlinPlugin = "1.8.20"
}

改为：

buildscript {
    val androidGradlePlugin by extra("8.0.1")
    val androidKotlinPlugin by extra("1.8.20")
}

还没有结束。在线面我们有plugins节点，将他从这个：

plugins {
    id "com.android.application:$androidGradleVersion"
    id "com.android.library:$androidGradleVersion"
    id "org.jetbrains.kotlin.android:$androidKotlinPlugin"
}

改为：

plugins {
    id("com.android.application") version "${extra["androidGradlePlugin"]}" apply false
    id("com.android.library") version "${extra["androidGradleVersion"]}" apply false
    id("org.jetbraings.kotlin.android") version "${extra["androidKotlinPlugin"]}" apply false
}

现在这个文件已经准备好了，现在是时候去处理我们模块的 build.gradle 文件了。

3、更改我们模块的 build.gradle

在这种情况下，我们将更改 app 模块的文件。如果你有更多的模块，你需要为每个模块做相同操作。和前面两个文件一样，将文件名改为在末尾添加 KTS 扩展名。然后进行以下更改：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

改为：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
}

同样，在 Android 定义的部分，为每个定义添加一个等号（=）

android {
    namespace 'com.example.demo'
    compileSdk 33
    
    defaultConfig {
        applicationId "com.example.demo"
        minSdk 24
        targetSdk 33
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

改为：

android {
    namespace = "com.example.demo"
    compileSdk = 33
    
    defaultConfig {
        applicationId = "com.example.demo"
        minSdk = 24
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled = false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

最后，请将你的实现方式名称括在括号中

dependencies {
    implementation 'androidx.core:core-ktx:1.8.0'
    implementation 'androidx.appcompat:appcompat:1.4.1'
    implementation 'com.google.android.material:material:1.5.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.3'
    implementation 'androidx.navigation:navigation-fragment-ktx:2.5.3'
    implementation 'androidx.navigation:navigation-ui-ktx:2.5.3'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.6.1'
    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.1'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

改为：

dependencies {
    implementation("androidx.core:core-ktx:1.8.0")
    implementation("androidx.appcompat:appcompat:1.4.1")
    implementation("com.google.android.material:material:1.5.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.3")
    implementation("androidx.navigation:navigation-fragment-ktx:2.5.3")
    implementation("androidx.navigation:navigation-ui-ktx:2.5.3")
    implementation("androidx.legacy:legacy-support-v4:1.0.0")
    implementation("androidx.lifecycle:lifecycle-livedata-ktx:2.6.1")
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.1")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.3")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
}

现在，完成这一切后，请Sync你的项目。

通过这些步骤，你已经成功更新了你的项目以使用 Kotlin 脚本，并能够享受它的优势，同时也能保持你的应用程序更新。

希望这个教程对你有用～