Android 源代码集布局

新的 Android 源代码集布局在 Kotlin 1.8.0 中引入，并在 1.9.0 中成为默认布局。请遵循本指南，了解已弃用布局和新布局之间的主要区别，以及如何迁移你的项目。

你无需实现所有建议，只需实现适用于你的特定项目的建议。

检测兼容性

新布局要求 Android Gradle 插件 7.0 或更高版本，并支持 Android Studio 2022.3 及更高版本。检测你的 Android Gradle 插件版本，如有必要请升级。

重命名 Kotlin 源代码集

如适用，请遵循此模式重命名你项目中的源代码集：

旧版源代码集布局	新版源代码集布局
targetName + AndroidSourceSet.name	targetName + AndroidVariantType

{AndroidSourceSet.name} 映射到 {KotlinSourceSet.name} 如下所示：

	旧版源代码集布局	新版源代码集布局
main	androidMain	androidMain
test	androidTest	androidUnitTest
androidTest	androidAndroidTest	androidInstrumentedTest

移动源文件

如适用，请遵循此模式将你的源文件移动到新目录：

旧版源代码集布局	新版源代码集布局
该布局包含额外的 /kotlin 源目录	src/{KotlinSourceSet.name}/kotlin

{AndroidSourceSet.name} 映射到 {SourceDirectories included} 如下所示：

	旧版源代码集布局	新版源代码集布局
main	src/androidMain/kotlin src/main/kotlin src/main/java	src/androidMain/kotlin src/main/kotlin src/main/java
test	src/androidTest/kotlin src/test/kotlin src/test/java	src/androidUnitTest/kotlin src/test/kotlin src/test/java
androidTest	src/androidAndroidTest/kotlin src/androidTest/java	src/androidInstrumentedTest/kotlin src/androidTest/java, src/androidTest/kotlin

移动 AndroidManifest.xml 文件

如果你的项目中有 AndroidManifest.xml 文件，请遵循此模式将其移动到新目录：

旧版源代码集布局	新版源代码集布局
src/{AndroidSourceSet.name}/AndroidManifest.xml	src/{KotlinSourceSet.name}/AndroidManifest.xml

{AndroidSourceSet.name} 映射到 {AndroidManifest.xml location} 如下所示：

	旧版源代码集布局	新版源代码集布局
main	src/main/AndroidManifest.xml	src/androidMain/AndroidManifest.xml
debug	src/debug/AndroidManifest.xml	src/androidDebug/AndroidManifest.xml

检测 Android 与公共测试之间的关系

新的 Android 源代码集布局改变了 Android 插桩测试（在新布局中重命名为 androidInstrumentedTest）和公共测试之间的关系。

此前，androidAndroidTest 和 commonTest 之间的 dependsOn 关系是默认的。这意味着以下几点：

• commonTest 中的代码在 androidAndroidTest 中可用。
• commonTest 中的 expect 声明必须在 androidAndroidTest 中有对应的 actual 实现。
• 在 commonTest 中声明的测试也作为 Android 插桩测试运行。

在新版 Android 源代码集布局中，dependsOn 关系默认不添加。如果你希望保留此前的行为，请在你的 build.gradle.kts 文件中手动声明以下关系：

kotlin {
// ...
    sourceSets {
        val commonTest by getting
        val androidInstrumentedTest by getting {
            dependsOn(commonTest)
        }
    }
}

调整 Android flavor 的实现

此前，Kotlin Gradle 插件主动创建与 Android 源代码集对应的源代码集，其中包含 debug 和 release 构建类型或 demo 和 full 等自定义 flavor。它使得源代码集可以通过诸如 val androidDebug by getting { ... } 的表达式来访问。

新的 Android 源代码集布局利用了 Android 的 onVariants 来创建源代码集。这使得此类表达式无效，导致诸如 org.gradle.api.UnknownDomainObjectException: KotlinSourceSet with name 'androidDebug' not found 的错误。

为了解决此问题，请在你的 build.gradle.kts 文件中使用新的 invokeWhenCreated() API：

kotlin {
// ...
    @OptIn(ExperimentalKotlinGradlePluginApi::class)
    sourceSets.invokeWhenCreated("androidFreeDebug") {
// ...
    }
}