用 Kotlin 脚本（KTS）重塑 Android 工程效能：2000 字终极实践指南

// Groovy 的危险操作（运行时才会报错）
dependencies {
    implementation "com.squareup.retrofit:retrofit:2.9.0" // 拼写错误无法及时检测
}

// KTS 的安全保障（编辑时立即提示）
dependencies {
    implementation("com.squareup.retrofit2:retrofit:2.9.0") // 自动补全 + 版本校验
    implementation(Retrofit.core) // 通过集中管理进一步强化安全
}

// buildSrc/src/main/kotlin/Dependencies.kt
object Versions {
    const val compose = "1.6.3"
    const val koin = "3.5.3"
}

object Libs {
    // AndroidX
    const val coreKtx = "androidx.core:core-ktx:1.12.0"
    
    // Jetpack Compose
    const val composeUi = "androidx.compose.ui:ui:${Versions.compose}"
    const val composeMaterial3 = "androidx.compose.material3:material3:${Versions.compose}"
    
    // DI
    const val koinCore = "io.insert-koin:koin-core:${Versions.koin}"
    const val koinAndroid = "io.insert-koin:koin-android:${Versions.koin}"
}

// 模块级 build.gradle.kts
dependencies {
    implementation(Libs.coreKtx)
    implementation(Libs.composeUi)
    implementation(Libs.koinAndroid)
}

// 根据构建类型动态切换依赖
val isRelease = gradle.startParameter.taskRequests.toString().contains("Release")

dependencies {
    if (isRelease) {
        implementation(Libs.firebaseCrashlytics)
        implementation(Libs.firebaseAnalytics)
    } else {
        debugImplementation(Libs.leakCanary)
        implementation(Libs.chuckerDebug)
    }
}

tasks.register("archiveApk", Copy::class) {
    from("$buildDir/outputs/apk")
    into("/var/www/apk_archive/${project.name}")
    
    // 按日期组织目录
    val dateFormat = SimpleDateFormat("yyyyMMdd_HHmm")
    rename { fileName ->
        "${dateFormat.format(Date())}_$fileName"
    }
    
    // 仅处理 release APK
    include("**/*release*.apk")
    
    doLast {
        println("APK 已归档至 ${destinationDir.path}")
    }
}

// 关联到发布任务链
tasks.named("assembleRelease") {
    finalizedBy("archiveApk")
}

// 定义 3 维构建矩阵
flavorDimensions += listOf("region", "tier", "monetization")

productFlavors {
    // 地区维度
    register("china") {
        dimension = "region"
        resValue("string", "cdn_url", "\"https://cn.cdn.example.com\"")
    }
    
    register("global") {
        dimension = "region"
        resValue("string", "cdn_url", "\"https://global.cdn.example.com\"")
    }

    // 服务等级
    register("free") {
        dimension = "tier"
        buildConfigField("Boolean", "PREMIUM_FEATURES", "false")
    }
    
    register("premium") {
        dimension = "tier"
        buildConfigField("Boolean", "PREMIUM_FEATURES", "true")
    }

    // 商业化模式
    register("ad") {
        dimension = "monetization"
        buildConfigField("Int", "AD_FREQUENCY", "3")
    }
    
    register("subscription") {
        dimension = "monetization"
        buildConfigField("Int", "AD_FREQUENCY", "0")
    }
}

// 生成 2x2x2=8 种变体
variantFilter {
    // 排除不合理的组合（如 premium+ad）
    if (name.contains("premium") && name.contains("ad")) {
        ignore = true
    }
}

tasks.register("preReleaseCheck") {
    group = "verification"
    
    doLast {
        // 1. 检查未解决的 TODO
        val todos = fileTree("src").filter { it.readText().contains("TODO") }
        if (todos.isNotEmpty()) {
            throw GradleException("发现 ${todos.count()} 个未解决的 TODO")
        }

        // 2. 验证密钥配置
        if (System.getenv("SIGNING_KEY") == null) {
            throw GradleException("未检测到签名密钥")
        }

        // 3. 检查依赖更新
        exec {
            commandLine("gradle", "dependencyUpdates")
        }
    }
}

// 绑定到发布流程
tasks.named("publishReleaseBundle") {
    dependsOn("preReleaseCheck")
}

// buildSrc/src/main/kotlin/ResourceOptimizerPlugin.kt
class ResourceOptimizerPlugin : Plugin<Project> {
    override fun apply(project: Project) {
        project.afterEvaluate {
            tasks.register("analyzeResources") {
                doLast {
                    val resourceDir = project.file("src/main/res")
                    val usedResources = detectUsedResources(project)
                    
                    resourceDir.walk()
                        .filter { it.isFile && it.extension == "xml" }
                        .forEach { file ->
                            val resName = file.nameWithoutExtension
                            if (!usedResources.contains(resName)) {
                                logger.warn("未使用资源: ${file.relativeTo(resourceDir)}")
                                if (project.hasProperty("autoClean")) {
                                    file.delete()
                                }
                            }
                        }
                }
            }
        }
    }

    private fun detectUsedResources(project: Project): Set<String> {
        // 实现代码引用扫描逻辑
        return setOf("ic_launcher", "activity_main")
    }
}

// 应用插件
plugins {
    id("ResourceOptimizerPlugin")
}

// gradle.properties
org.gradle.parallel=true
org.gradle.caching=true
org.gradle.vfs.watch=true

// build.gradle.kts
tasks.withType<JavaCompile>().configureEach {
    options.isFork = true
    options.forkOptions.apply {
        memoryMaximumSize = "2g"
        jvmArgs = listOf("-Dkotlin.compiler.execution.strategy=in-process")
    }
}

android {
    compileOptions {
        isCoreLibraryDesugaringEnabled = true
        isIncremental = true
    }
    
    kotlinOptions {
        freeCompilerArgs = listOf(
            "-Xopt-in=kotlin.RequiresOptIn",
            "-Xjvm-default=all",
            "-Xbackend-threads=4"
        )
        jvmTarget = "17"
    }
}

# 启用 KTS 预览功能
echo "kotlin.code.style=official" >> $HOME/.gradle/gradle.properties

# 生成类型安全访问器
./gradlew kotlinDslAccessorsReport