当前位置:   article > 正文

Android Gradle 的配置从 Groovy 迁移到 KTS_android kts

android kts

目录

#1. 引用

#2.常用术语

#3.脚本文件命名

#4.Gradle迁移示例

1.准备工作:对 Groovy 做简单转换

2. plugins 代码块迁移

3. 显式和隐式 buildTypes

4.默认配置:defaultConfig

5.签名配置:signingConfigs

6.打包配置:applicationVariants

7.编译选项:compileOptions

8.依赖配置:dependencies

9.参数配置:ext

10.迁移 project/build.gradle

11.迁移 setting.gradle

#5.更多资源


#1. 引用

Android Gradle 插件 4.0 支持在 Gradle 构建配置中使用 Kotlin 脚本 (KTS),用于替代 Groovy(过去在 Gradle 配置文件中使用的编程语言)。

将来,KTS 会比 Groovy 更适合用于编写 Gradle 脚本,因为采用 Kotlin 编写的代码可读性更高,并且 Kotlin 提供了更好的编译时检查和 IDE 支持。

虽然与 Groovy 相比,KTS 当前能更好地在 Android Studio 的代码编辑器中集成,但采用 KTS 的构建速度往往比采用 Groovy 慢,因此在迁移到 KTS 时应考虑构建性能。

本页介绍了有关将 Android 应用的 Gradle build 文件从 Groovy 转换为 KTS 的基本信息。

如需查看更全面的迁移指南,请参阅 Gradle 的官方文档

⚠️  采用 KTS 的构建速度往往比采用 Groovy 慢,因此在迁移到 KTS 时应考虑构建性能。

#2.常用术语

KTS:是指 Kotlin 脚本,这是 Gradle 在构建配置文件中使用的一种 Kotlin 语言形式。Kotlin 脚本是可从命令行运行的 Kotlin 代码。

Kotlin DSL:主要是指 Android Gradle 插件 Kotlin DSL,有时也指底层 Gradle Kotlin DSL。

在讨论从 Groovy 迁移时,术语“KTS”和“Kotlin DSL”可以互换使用。换句话说,“将 Android 项目从 Groovy 转换为 KTS”与“将 Android 项目从 Groovy 转换为 Kotlin DSL”实际上是一个意思。 

#3.脚本文件命名

  • 用 Groovy 编写的 Gradle build 文件使用 .gradle 文件扩展名。
  • 用 Kotlin 编写的 Gradle build 文件使用 .gradle.kts 文件扩展名。

#4.Gradle迁移示例

⚠️ 在迁移之前,我们要一次迁移一个文件:

由于可以在项目中结合使用 Groovy build 文件和 KTS build 文件,因此将项目转换为 KTS 的一个简单方法是先选择一个简单的 build 文件(例如 settings.gradle),将其重命名为 settings.gradle.kts,然后将其内容转换为 KTS。之后,确保您的项目在迁移每个 build 文件之后仍然可以编译。

1.准备工作:对 Groovy 做简单转换

一些简单的 Kotlin 和 Groovy 语言差异会使转换脚本变得乏味:

  • 字符串:Groovy 可以用单引号'string'或双引号引用"string",而 KTS 需要双引号"string"。

  • 括号:Groovy 允许在调用函数时省略括号,而 KTS 需要括号。

  • 赋值运算符:Groovy 允许在分配属性时省略赋值运算符(=),而 Kotlin 需要赋值运算符(=)。

作为迁移的第一步,建议通过以下方式准备您的 Groovy 构建脚本

  • 使用双引号统一引号,

  • 分别使用括号和赋值运算符。

示例1.使用双引号统一引号

Groovy - app/gradle:
  1. android {
  2. compileSdkVersion 30
  3. buildToolsVersion '30.0.2'
  4. ...
  5. }
  6. dependencies {
  7. implementation 'com.acme:example:1.0'
  8. }

变成 KTS - app/gradle:

  1. android {
  2. compileSdkVersion 30
  3. buildToolsVersion = "30.0.2"
  4. ...
  5. }
  6. dependencies {
  7. implementation "com.acme:example:1.0"
  8. }

继续示例1中的更改

示例2.分别使用括号和赋值运算符

  1. android {
  2. compileSdkVersion(30)
  3. buildToolsVersion = "30.0.2"
  4. ...
  5. }
  6. dependencies {
  7. implementation("com.acme:example:1.0")
  8. }

⚠️ 后者涉及更多,因为在 Groovy 脚本中区分函数调用和属性分配可能并非易事,我们一开始并不能明确哪些地方该使用括号还是赋值运算符。一个好的策略是首先对所有不明确的语句进行属性分配,然后通过将失败的语句转换为函数调用来修复构建。
接下来,我们一起来看看具体的替换:

2. plugins 代码块迁移

Groovy 中的以下代码:

  1. apply plugin: 'com.android.application'
  2. apply plugin: 'kotlin-android'
  3. apply plugin: 'dagger.hilt.android.plugin'
  4. // or
  5. plugins {
  6. id 'com.android.application'
  7. id 'kotlin-android'
  8. id 'dagger.hilt.android.plugin'
  9. }
  10. apply from: '../signing.gradle'

在 KTS 中变为以下代码:

  1. plugins {
  2.     id("com.android.application")
  3.     id("kotlin-android")
  4.     id("dagger.hilt.android.plugin")
  5.  }
  6. apply(from = "../signing.gradle")

这里 id("kotlin-android") 也能写成 kotlin("android")

⚠️ plugins 代码块仅解析 Gradle 插件门户中提供的插件或使用 pluginManagement 代码块指定的自定义存储库中提供的插件。如果插件来自插件门户中不存在的 buildScript 依赖项,那么这些插件在 Kotlin 中就必须使用 apply 才能应用。例如:

apply(plugin = "kotlin-android")

3. 显式和隐式 buildTypes

⚠️ 在 Kotlin DSL 中,某些 buildTypes(如 debug 和 release,)是隐式提供的。但是,其他 buildTypes 则必须手动创建。

Groovy - buildTypes

  1. // 例如,在 Groovy 中,您可能有 debug、release 和 staging 
  2. buildTypes
  3.   debug {
  4.     ...
  5.   }
  6.   release {
  7.     ...
  8.   }
  9.   staging {
  10.     ...
  11.   }

在 KTS 中,仅 debug 和 release, buildTypes 是隐式提供的,而 staging 则必须由您手动create(创建)出来:

KTS - buildTypes:

  1. buildTypes
  2.   getByName("debug") {
  3.     ...
  4.   }
  5.   getByName("release") {
  6.     ...
  7.   }
  8.   create("staging") {
  9.     ...
  10.   }

补充:buildTypes-debug的改变

Groovy - buildTypes-debug:

  1. buildTypes {
  2. debug {
  3. minifyEnabled false
  4. testCoverageEnabled project.hasProperty("coverage")
  5. debuggable true
  6. applicationIdSuffix ".dev"
  7. versionNameSuffix "-DEV"
  8. signingConfig signingConfigs.debug
  9. proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
  10. }
  11. release {
  12. }
  13. }

KTS - buildTypes-debug 对应的更改:

  1. buildTypes {
  2. getByName("debug") {
  3. isMinifyEnabled = false
  4. isTestCoverageEnabled = project.hasProperty("coverage")
  5. isDebuggable = true
  6. applicationIdSuffix = ".dev"
  7. versionNameSuffix = "-DEV"
  8. signingConfig = signingConfigs.getByName("debug")
  9. proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
  10. }
  11. getByName("release") {
  12. ...
  13. }
  14. }

4.默认配置:defaultConfig

Groovy - defaultConfig:

  1. defaultConfig {
  2. applicationId "com.android.testplaydemo"
  3. minSdkVersion 21
  4. targetSdkVersion 30
  5. versionCode 1
  6. versionName "1.0"
  7. testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
  8. }

KTS - defaultConfig: 

  1. defaultConfig {
  2. applicationId = "com.android.testplaydemo"
  3. minSdkVersion(21)
  4. targetSdkVersion(30)
  5. versionCode = 1
  6. versionName = "1.0"
  7. testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
  8. }

5.签名配置:signingConfigs

Groovy - signingConfigs

  1. signingConfigs {
  2. release {
  3. keyAlias 'test'
  4. keyPassword '123456'
  5. storeFile file('../test.jks')
  6. storePassword '123456'
  7. v1SigningEnabled true
  8. v2SigningEnabled true
  9. }
  10. debug {
  11. keyAlias 'test'
  12. keyPassword '123456'
  13. storeFile file('../test.jks')
  14. storePassword '123456'
  15. }
  16. }

KTS - signingConfigs

  1. signingConfigs {
  2. create("release") {
  3. keyAlias = "test"
  4. keyPassword = "123456"
  5. storeFile = File("../test.jks")
  6. storePassword = "123456"
  7. isV1SigningEnabled = true
  8. isV2SigningEnabled = true
  9. }
  10. getByName("debug") {
  11. keyAlias = "test"
  12. keyPassword = "123456"
  13. storeFile = File("../test.jks")
  14. storePassword = "123456"
  15. }
  16. }

6.打包配置:applicationVariants

 Groovy 示例:

  1. // 自定义多渠道打包 apk名称
  2. applicationVariants.all { variant ->
  3. def buildType = variant.buildType.name
  4. variant.outputs.all { output ->// each 改为 all
  5. def date = new Date().format("ddHHmm", TimeZone.getTimeZone("GMT+08"))
  6. def fileName = "MVVM_${productFlavors[0].name}_${versionName}_${versionCode}_${date}.apk"
  7. def outFile = output.outputFile
  8. if (outFile != null && buildType == "release") {
  9. outputFileName = fileName // output.outputFile 改为 outputFileName
  10. }
  11. }
  12. }
  13. // 多渠道配置
  14. flavorDimensions "code"
  15. productFlavors {
  16. google {
  17. }
  18. baidu {
  19. }
  20. other {
  21. }
  22. }
  23. productFlavors.all {
  24. flavor -> flavor.manifestPlaceholders = [CHANNEL_VALUE: name]
  25. }

 KTS 示例:

  1. // 自定义多渠道打包 apk名称
  2. applicationVariants.all {
  3. val buildType = buildType.name
  4. outputs.all {
  5. if (this is com.android.build.gradle.internal.api.ApkVariantOutputImpl) {
  6. if (buildType == "release") {
  7. outputFileName = "DEMO_v${versionCode}_${flavorName}_${Versions.dateFormat}.apk"
  8. }
  9. }
  10. }
  11. }
  12. // 多渠道配置
  13. flavorDimensions("code")
  14. productFlavors {
  15. create("google")
  16. create("baidu")
  17. create("other")
  18. }
  19. productFlavors.all {
  20. manifestPlaceholders["CHANNEL_VALUE"] = name
  21. }

7.编译选项:compileOptions

Groovy - compileOptions 

  1. compileOptions {
  2. sourceCompatibility JavaVersion.VERSION_1_8
  3. targetCompatibility JavaVersion.VERSION_1_8
  4. }
  5. kotlinOptions {
  6. jvmTarget = '1.8'
  7. }

KTS - compileOptions  

  1. compileOptions {
  2. sourceCompatibility = JavaVersion.VERSION_1_8
  3. targetCompatibility = JavaVersion.VERSION_1_8
  4. }
  5. kotlinOptions {
  6. jvmTarget = "1.8"
  7. }

8.依赖配置:dependencies

Groovy - dependencies

  1. dependencies {
  2. implementation fileTree(dir: "libs", include: ["*.jar"])
  3. implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
  4. implementation 'androidx.core:core-ktx:1.6.0'
  5. implementation 'androidx.appcompat:appcompat:1.3.1'
  6. implementation 'com.google.android.material:material:1.4.0'
  7. implementation 'androidx.constraintlayout:constraintlayout:2.1.0'
  8. testImplementation 'junit:junit:4.12'
  9. androidTestImplementation 'androidx.test.ext:junit:1.1.3'
  10. androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
  11. }

KTS - dependencies

  1. dependencies {
  2. implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
  3. implementation("org.jetbrains.kotlin:kotlin-stdlib:${Libs.kotlin_version}")
  4. implementation("androidx.core:core-ktx:1.6.0")
  5. implementation("androidx.appcompat:appcompat:1.3.1")
  6. implementation("com.google.android.material:material:1.4.0")
  7. implementation("androidx.constraintlayout:constraintlayout:2.1.0")
  8. testImplementation("junit:junit:4.12")
  9. androidTestImplementation("androidx.test.ext:junit:1.1.3")
  10. androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
  11. }

⚠️  需要注意:implementation fileTree(dir: "libs", include: ["*.jar"]) 这行的改动!
在kts中写法为:implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar")))) 。

9.参数配置:ext

关于参数的配置的更改(比如:应用版本号,兼容最低Android sdk版本号,依赖版本号,签名)如下示例:(Groovy

  1. // 一般放入 build.gradle 中
  2. ext {
  3. minAndroidSdk = 21
  4. targetSdk = 29
  5. verCode = automatedVerCode
  6. verName = "1.0.0-${project.findProperty('buildNumber') ?: 0}"
  7. // 依赖包版本号 配置
  8. kotlin_version = "1.4.10"
  9. other_version = "2.2.0"
  10. }
  11. // 一般会创建一个 signing.gradle 来存放签名配置参数
  12. ext {
  13. StoreFile = "test.keystore"
  14. StorePassword = "202121"
  15. KeyAlias = "test"
  16. KeyPassword = "202121"
  17. }

我们需要删除原来的 ext 参数配置,并在根目录上右键新建 buildSrc 目录。目录结构与文件如下所示:

创建参数的示例:(KTS

  1. // 应用版本号/兼容sdk版本号 配置
  2. object Versions {
  3. const val applicationId = "com.android.mvvm"
  4. const val minAndroidSdk = 21
  5. const val targetSdk = 30
  6. const val verCode = 100 // XYZ
  7. const val verName = "1.0.0" // X.Y.Z; X = Major, Y = minor, Z = Patch level
  8. }
  9. // 依赖包版本号 配置
  10. object Libs {
  11. const val KOTLIN_VERSION = "1.4.10"
  12. const val OTHER_VERSION = "2.2.0"
  13. }
  14. // 签名 配置
  15. object Signing {
  16. const val StoreFile = "test.keystore"
  17. const val StorePassword = "123456"
  18. const val KeyAlias = "test"
  19. const val KeyPassword = "123456"
  20. }

 补充:其中需要看下 buildSrc 目录中的 build.gradle.kts 配置:

  1. // build.gradle.kts
  2. plugins {
  3. `kotlin-dsl`
  4. }
  5. repositories {
  6. gradlePluginPortal()
  7. }

以上为 app/build.gradle.kts 的迁移。

需要更多更详细,请查看已迁移文件:app/build.gradle.kts

10.迁移 project/build.gradle

第一步:需要删除原来的 ext 参数配置;第二步:根据依赖配置做相应的更改:

示例(Groovy

  1. // Top-level build file where you can add configuration options common to all sub-projects/modules.
  2. buildscript {
  3. ext {
  4. kotlin_version = "1.4.32"
  5. other_version = "2.2.0"
  6. }
  7. repositories {
  8. google()
  9. jcenter()
  10. }
  11. dependencies {
  12. classpath "com.android.tools.build:gradle:4.1.2"
  13. classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
  14. // NOTE: Do not place your application dependencies here; they belong
  15. // in the individual module build.gradle files
  16. }
  17. }
  18. allprojects {
  19. repositories {
  20. google()
  21. jcenter()
  22. }
  23. }
  24. task clean(type: Delete) {
  25. delete rootProject.buildDir
  26. }

示例(KTS

  1. // Top-level build file where you can add configuration options common to all sub-projects/modules.
  2. buildscript {
  3. repositories {
  4. google()
  5. jcenter()
  6. }
  7. dependencies {
  8. classpath("com.android.tools.build:gradle:4.0.1")
  9. classpath(kotlin("gradle-plugin", version = Libs.KOTLIN_VERSION))
  10. classpath("com.google.dagger:hilt-android-gradle-plugin:${Libs.HILT_VERSION}")
  11. // NOTE: Do not place your application dependencies here; they belong
  12. // in the individual module build.gradle.kts files
  13. }
  14. }
  15. allprojects {
  16. repositories {
  17. google()
  18. jcenter()
  19. }
  20. }
  21. tasks.register("clean", Delete::class) {
  22. delete(rootProject.buildDir)
  23. }

⚠️  这里需要注意创建任务的写法:

  1. // Groovy
  2. task clean(type: Delete) {
  3. delete rootProject.buildDir
  4. }
  5. // KTS
  6. tasks.register("clean", Delete::class) {
  7. delete(rootProject.buildDir)
  8. }

11.迁移 setting.gradle

最后就很简单,示例(Groovy

  1. include ':app'
  2. rootProject.name = "TestDemo"

 示例(KTS

  1. include(
  2. ":app"
  3. )
  4. rootProject.name = "TestDemo"

#5.更多资源

如需查看用 KTS 编写的 Gradle build 文件的可运行示例,

请参阅 GitHub上提供的 MVVM 示例应用 - Groovy-To-KTS分支

也可以参阅 GitHub 上的官方提供的 IOSched 示例应用

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/空白诗007/article/detail/845529
推荐阅读
相关标签
  

闽ICP备14008679号