Kotlin 버전 호환성 및 이전

이 페이지에서는 Navigation SDK의 Kotlin 버전 호환성에 관한 정보와 최신 버전으로 이전하는 방법을 안내합니다.

다음 표에는 최신 버전의 Navigation SDK에 필요한 Kotlin 버전과 권장되는 AGP 및 Gradle 버전이 간략하게 설명되어 있습니다.

Navigation SDK 버전 Kotlin 버전 (필수) Android Gradle 플러그인 (AGP) 및 Gradle 버전 (권장)
6.2 이상 2.1
  • AGP 8.7.3
  • Gradle 8.10.2
6.0~6.2 2.0
  • AGP 8.3.0
  • Gradle 8.4
5.1~5.99.1 1.9 JDK-8272564의 해결 방법이 있는 AGP 7.3 이상을 사용하는 것이 좋습니다.

Kotlin 버전 호환성

Kotlin 2.1은 Kotlin 2.0과의 이전 버전과의 호환성을 지원합니다. 즉, Navigation SDK와 함께 Kotlin 2.0을 이미 사용하고 있다면 호환성이 깨지는 변경사항을 모두 해결하지 않고도 Kotlin 2.1로 업그레이드할 수 있습니다. 하지만 이는 안정적인 언어 기능에만 적용됩니다. Kotlin 언어에서 알파, 베타 또는 실험용 기능을 사용하는 경우 업그레이드할 때 추가 변경사항이 필요할 수 있습니다.

전환 간소화: Kotlin 호환성 플래그

Kotlin은 호환성이 깨지는 변경사항을 제한하는 데 도움이 되는 두 가지 플래그를 제공합니다. https://kotlinlang.org/docs/compatibility-modes.html

언어 버전 X.Y

이 플래그는 이전 Kotlin 버전의 동작에 대한 호환성이 깨지는 변경사항을 되돌립니다. 예를 들어 Kotlin 2.0을 사용하는 경우 [ - language-version 2.0]을 지정하면 새로운 호환성 문제가 더 이상 적용되지 않습니다.

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

이 플래그는 apiVersion보다 최신 Kotlin 버전의 API가 사용될 때 Gradle 빌드 오류를 발생시킵니다.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

더욱 타겟팅된 접근 방식

Kotlin 호환성 플래그를 사용하는 것 외에도 Kotlin 출시 노트를 검토하고 업그레이드하는 버전에서 유지하려는 동작을 선택하는 것이 좋습니다. Kotlin은 각 버전의 호환성 가이드에서 호환성이 깨지는 변경사항 목록과 원래 동작을 유지하기 위해 설정할 수 있는 플래그를 제공합니다.

향후 Kotlin 업그레이드

Kotlin은 6개월마다 새 버전 (즉, 언어 출시)을 출시하며 Google은 일반적으로 그로부터 1~2개월 후에 최신 버전을 제품의 기본값으로 통합합니다. 이전 Kotlin 버전에는 Navigation SDK 고객이 최신 버전으로 업그레이드해야 하는 브레이킹 체인지가 포함되어 있습니다. 따라서 최신 Navigation SDK 버전을 채택할 때는 6개월마다 Kotlin 업그레이드를 계획하는 것이 좋습니다.