Compose 컴파일러 마이그레이션 가이드

Compose 컴파일러는 Gradle 플러그인에 의해 보완되며, 이 플러그인은 설정을 간소화하고 컴파일러 옵션에 더 쉽게 접근할 수 있도록 합니다. Android Gradle 플러그인(AGP)과 함께 적용될 때, 이 Compose 컴파일러 플러그인은 AGP가 자동으로 제공하는 Compose 컴파일러의 좌표를 재정의합니다.

Compose 컴파일러는 Kotlin 2.0.0부터 Kotlin 리포지토리로 병합되었습니다. 이는 Compose 컴파일러가 Kotlin과 동시에 배포되고 항상 동일 버전의 Kotlin과 호환되므로, 프로젝트를 Kotlin 2.0.0 이상으로 마이그레이션하는 데 도움이 됩니다.

프로젝트에서 새로운 Compose 컴파일러 플러그인을 사용하려면, Compose를 사용하는 각 모듈에 이를 적용하세요. Jetpack Compose 프로젝트를 마이그레이션하는 방법에 대한 자세한 내용은 계속 읽어보세요. Compose Multiplatform 프로젝트의 경우, 멀티플랫폼 마이그레이션 가이드를 참조하세요.

Jetpack Compose 프로젝트 마이그레이션

1.9에서 Kotlin 2.0.0 이상으로 마이그레이션할 때, Compose 컴파일러를 처리하는 방식에 따라 프로젝트 구성을 조정해야 합니다. 구성 관리를 자동화하기 위해 Kotlin Gradle 플러그인과 Compose 컴파일러 Gradle 플러그인을 사용하는 것을 권장합니다.

Gradle 플러그인으로 Compose 컴파일러 관리

Android 모듈의 경우:

1. Compose 컴파일러 Gradle 플러그인을 Gradle 버전 카탈로그에 추가하세요:

[versions]
# ...
kotlin = "2.1.21"

[plugins]
# ...
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

2. Gradle 플러그인을 루트 build.gradle.kts 파일에 추가하세요:

plugins {
    // ...
    alias(libs.plugins.compose.compiler) apply false
}

3. Jetpack Compose를 사용하는 모든 모듈에 플러그인을 적용하세요:

plugins {
    // ...
    alias(libs.plugins.compose.compiler)
}

4. Jetpack Compose 컴파일러용 컴파일러 옵션을 사용하는 경우, composeCompiler {} 블록에 설정하세요. 참고 자료로 컴파일러 옵션 목록을 참조하세요.

5. Compose 컴파일러 아티팩트를 직접 참조하는 경우, 이러한 참조를 제거하고 Gradle 플러그인이 처리하도록 할 수 있습니다.

Gradle 플러그인 없이 Compose 컴파일러 사용

Gradle 플러그인을 사용하여 Compose 컴파일러를 관리하지 않는 경우, 프로젝트에서 이전 Maven 아티팩트에 대한 직접 참조를 업데이트하세요:

• androidx.compose.compiler:compiler를 org.jetbrains.kotlin:kotlin-compose-compiler-plugin-embeddable로 변경하세요.
• androidx.compose.compiler:compiler-hosted를 org.jetbrains.kotlin:kotlin-compose-compiler-plugin으로 변경하세요.

다음 단계

• Compose 컴파일러가 Kotlin 리포지토리로 이동하는 것에 대한 Google의 발표를 참조하세요.
• Jetpack Compose를 사용하여 Android 앱을 빌드하는 경우, 멀티플랫폼으로 만드는 방법에 대한 가이드를 확인하세요.