Gradle 构建脚本迁移：从 Groovy DSL 到 Kotlin DSL，语法与技巧对比

将 Gradle 构建脚本从 Groovy DSL 迁移到 Kotlin DSL 是提升构建脚本可维护性、类型安全性和IDE支持的常见实践。以下是核心语法对比和迁移技巧：

一、核心语法对比

1. 文件扩展名

Groovy DSL ：build.gradle
Kotlin DSL ：build.gradle.kts

2. 基本结构与赋值

Groovy：弱类型，可省略分号和括号
groovy 复制代码
```
group 'com.example'
version '1.0.0'
apply plugin: 'java'
```
Kotlin：强类型，需显式分号（可选但推荐），函数调用需括号
kotlin 复制代码
```
group = "com.example"
version = "1.0.0"
apply(plugin = "java")
```

3. 插件应用

Groovy：支持短名称和映射语法

groovy 复制代码

plugins {
    id 'java'
    id 'org.springframework.boot' version '2.7.0'
}

Kotlin：需显式字符串参数，支持类型安全访问

kotlin 复制代码

plugins {
    `java`  // 关键字冲突时用反引号
    id("org.springframework.boot") version "2.7.0"
}

4. 依赖声明

Groovy：简洁的闭包语法

groovy 复制代码

dependencies {
    implementation 'com.google.guava:guava:31.1-jre'
    testImplementation group: 'junit', name: 'junit', version: '4.13.2'
}

Kotlin ：类型安全的函数调用，支持 invoke 简化

kotlin 复制代码

dependencies {
    implementation("com.google.guava:guava:31.1-jre")
    testImplementation(group = "junit", name = "junit", version = "4.13.2")
}

5. 任务定义

Groovy：动态方法和闭包配置

groovy 复制代码

task copyFiles(type: Copy) {
    from 'src'
    into 'dest'
    include '*.txt'
}

Kotlin：类型安全的任务注册，支持 lambda 配置

kotlin 复制代码

tasks.register<Copy>("copyFiles") {
    from("src")
    into("dest")
    include("*.txt")
}

6. 条件与循环

Groovy ：灵活的语法（支持 if/for 直接使用）
groovy 复制代码
```
if (project.hasProperty('release')) {
    version += '-RELEASE'
}
```

Kotlin：严格的语法，需显式调用 API

kotlin 复制代码

if (project.hasProperty("release")) {
    version = "${version}-RELEASE"
}

7. 扩展属性（Extra Properties）

Groovy：动态添加属性
groovy 复制代码
```
ext {
    minSdkVersion = 21
}
```

Kotlin ：通过 extra 映射操作

kotlin 复制代码

extra["minSdkVersion"] = 21
// 读取时需显式转换
val minSdk = extra["minSdkVersion"] as Int

二、迁移技巧

渐进式迁移

从子模块或简单脚本开始，Gradle 支持混合使用 Groovy 和 Kotlin DSL。通过 buildSrc 共享逻辑可减少重复。
利用 IDE 支持

IntelliJ/Android Studio 对 Kotlin DSL 提供自动补全、重构和类型检查，迁移时可借助 IDE 提示修复语法错误。
处理路径与文件

Groovy 中 file('path') 可简化为 'path'，但 Kotlin 需显式使用 file("path") 或 project.file("path")。
插件 ID 冲突

当插件 ID 与 Kotlin 关键字冲突（如 java、kotlin），用反引号包裹：java。

依赖版本管理

推荐使用 versionCatalog（Kotlin DSL 更友好）统一管理版本：

kotlin 复制代码

// settings.gradle.kts
dependencyResolutionManagement {
    versionCatalogs {
        create("libs") {
            version("guava", "31.1-jre")
            library("guava", "com.google.guava", "guava").versionRef("guava")
        }
    }
}

// 引用
dependencies {
    implementation(libs.guava)
}

任务依赖与执行

Kotlin DSL 中任务依赖需显式引用任务对象：
kotlin 复制代码
```
tasks.named("assemble") {
    dependsOn("copyFiles")
}
```
调试与日志

使用 logger.quiet("message") 替代 Groovy 的 println，日志级别更可控。

三、优势总结

类型安全：编译期检查错误，减少运行时构建失败。
IDE 友好：自动补全、跳转和重构支持更完善。
可读性：语法更严格，团队协作时风格更统一。
扩展性：Kotlin 语言特性（如扩展函数、高阶函数）可增强构建逻辑。