Android 源代码集布局

新的布局需要 Android Gradle plugin 7.0 或更高版本, 而且需要使用 Android Studio 2022.3 或更高版本. 请检查你的 Android Gradle plugin 版本, 如果需要的话, 请更新到新的版本.

如果需要, 请重命名你的项目中的源代码集, 遵循下面的模式:

{AndroidSourceSet.name} 与 {KotlinSourceSet.name} 的对应关系如下:

如果需要, 请将你的源代码文件移动到新的目录, 遵循下面的模式:

{AndroidSourceSet.name} 与 {SourceDirectories included} 的对应关系如下:

如果你的项目中有 AndroidManifest.xml 文件, 请移动到新的目录, 遵循下面的模式:

{AndroidSourceSet.name} 与 {AndroidManifest.xml location} 的对应关系如下:

新的 Android 源代码集布局改变了 Android 设备测试(Instrumented Test) (在新的布局中改名为 androidInstrumentedTest) 与 common 测试之间的关系.

以前, androidAndroidTest 与 commonTest 之间默认存在 dependsOn 关系. 这意味着:

• commonTest 中的代码可以在 androidAndroidTest 中访问.

• commonTest 中的 expect 声明, 在 androidAndroidTest 中必须有对应的 actual 实现.

• 在 commonTest 中声明的测试 也会作为 Android 设备测试(Instrumented Test)运行.

在新的 Android 源代码集布局中, 不会默认添加这个 dependsOn 关系. 如果你希望使用以前的行为, 请在你的 build.gradle.kts 文件中手动声明下面的关系:

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

在以前的版本中, Kotlin Gradle plugin 会在很早的阶段创建对应于 debug 和 release 构建类型的 Android 源代码集, 或对应于自定义 flavor 的 Android 源代码集, 例如 demo 和 full. 因此这些源代码集可以通过 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") {
// ...
    }
}