Android 소스 세트 레이아웃

새로운 Android 소스 세트 레이아웃은 Kotlin 1.8.0에서 도입되었으며 1.9.0에서 기본값이 되었습니다. 이 가이드를 통해 더 이상 사용되지 않는 레이아웃과 새로운 레이아웃 간의 주요 차이점을 이해하고 프로젝트를 마이그레이션하는 방법을 알아보세요.

팁

모든 제안 사항을 구현할 필요는 없으며, 특정 프로젝트에 적용 가능한 항목만 구현하면 됩니다.

호환성 확인

새로운 레이아웃은 Android Gradle plugin 7.0 이상이 필요하며 Android Studio 2022.3 이상에서 지원됩니다. Android Gradle plugin 버전을 확인하고 필요한 경우 업그레이드하세요.

Kotlin 소스 세트 이름 변경

해당하는 경우 프로젝트에서 다음과 같은 패턴으로 소스 세트 이름을 변경하세요.

이전 소스 세트 레이아웃	새 소스 세트 레이아웃
targetName + AndroidSourceSet.name	targetName + AndroidVariantType

{AndroidSourceSet.name}은 다음과 같이 {KotlinSourceSet.name}에 매핑됩니다.

	이전 소스 세트 레이아웃	새 소스 세트 레이아웃
main	androidMain	androidMain
test	androidTest	androidUnitTest
androidTest	androidAndroidTest	androidInstrumentedTest

소스 파일 이동

해당하는 경우 다음과 같은 패턴으로 소스 파일을 새 디렉토리로 이동하세요.

이전 소스 세트 레이아웃	새 소스 세트 레이아웃
레이아웃에 추가 /kotlin SourceDirectories가 있었습니다.	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 plugin이 debug 및 release 빌드 유형 또는 demo 및 full과 같은 사용자 정의 flavor를 포함하는 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") {
// ...
    }
}