Структура наборов исходного кода Android

Проверьте совместимость

Для новой структуры требуется Android Gradle plugin версии 7.0 или выше. Она поддерживается в Android Studio 2022.3 и более поздних версиях. Проверьте версию Android Gradle plugin и при необходимости обновите её.

Переименуйте наборы исходного кода Kotlin

При необходимости переименуйте наборы исходного кода в проекте по следующему шаблону:

{AndroidSourceSet.name} соответствует {KotlinSourceSet.name} следующим образом:

Переместите исходные файлы

При необходимости переместите исходные файлы в новые каталоги по следующему шаблону:

{AndroidSourceSet.name} соответствует {SourceDirectories included} следующим образом:

Переместите файл AndroidManifest.xml

Если в проекте есть файл AndroidManifest.xml, переместите его в новый каталог по следующему шаблону:

{AndroidSourceSet.name} соответствует {AndroidManifest.xml location} следующим образом:

Проверьте связь между тестами Android и общими тестами

Новая структура наборов исходного кода Android меняет связь между инструментированными тестами Android (в новой структуре переименованными в androidInstrumentedTest) и общими тестами.

Раньше по умолчанию использовалась связь dependsOn между androidAndroidTest и commonTest. Это означало следующее:

• Код из commonTest был доступен в androidAndroidTest.

• Объявления expect в commonTest должны были иметь соответствующие реализации actual в androidAndroidTest.

• Тесты, объявленные в commonTest, также запускались как инструментированные тесты Android.

В новой структуре наборов исходного кода Android связь dependsOn не добавляется по умолчанию. Если вы хотите сохранить прежнее поведение, вручную объявите следующую связь в файле build.gradle.kts:

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

Настройка реализации вариантов Android

Ранее плагин Kotlin Gradle заблаговременно создавал исходные наборы, соответствующие исходным наборам Android, содержащим debug и release типы сборки или пользовательские варианты, такие как demo и full. Эти исходные наборы становились доступными с помощью выражений, например val androidDebug by getting { ... }.

В новой структуре исходных наборов Android используются onVariants для их создания. Из-за этого такие выражения становятся недопустимыми и приводят к ошибкам, например org.gradle.api.UnknownDomainObjectException: KotlinSourceSet with name 'androidDebug' not found.

Чтобы обойти эту проблему, используйте новый API invokeWhenCreated() в файле build.gradle.kts:

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