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

소스 파일 이동

해당하는 경우, 다음 패턴에 따라 소스 파일을 새로운 디렉터리로 이동하세요:

이전 소스 세트 레이아웃	새로운 소스 세트 레이아웃
The layout had additional /kotlin SourceDirectories	src/{KotlinSourceSet.name}/kotlin

{AndroidSourceSet.name}는 포함된 {SourceDirectories}에 다음과 같이 매핑됩니다:

	이전 소스 세트 레이아웃	새로운 소스 세트 레이아웃
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 플레이버 구현 조정

이전에는 Kotlin Gradle 플러그인이 debug 및 release 빌드 유형 또는 demo 및 full과 같은 사용자 정의 플레이버를 포함하는 Android 소스 세트에 해당하는 소스 세트를 즉시 생성했습니다. 이는 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") {
// ...
    }
}