Android Driver SDK 6.0 이전 가이드

DriverStatusListener 인터페이스로 이전

Driver v5에서는 StatusListener 인터페이스를 지원 중단하고 DriverStatusListener를 대신한다고 발표했습니다. 올해 StatusListener 인터페이스가 공식적으로 삭제됩니다. 새 인터페이스로의 이전 가이드는 StatusListener 지원 중단을 참고하세요.

Kotlin 2.0으로 이전

Android 6.0 이상용 Driver SDK를 사용하는 경우 Kotlin 2.0으로 업그레이드해야 합니다. 이 페이지에서는 새 Kotlin 버전으로 원활하게 전환할 수 있도록 안내합니다.

Gradle 및 AGP 호환성

Kotlin 2.0에는 Gradle 및 Android Gradle 플러그인 (AGP) 버전에 관한 최소 및 최대 버전 요구사항이 있습니다. 프로젝트가 Kotlin 2.0의 다음 요구사항을 충족하는지 확인합니다.

Driver SDK 6.0 이상을 위한 AGP 최소 버전

Driver SDK 6.0과 함께 AGP 7.3 이상을 사용하는 것이 좋습니다.

전체 R8 모드

Driver SDK v6 이하에서는 전체 R8 모드를 지원하지 않습니다. 애플리케이션이 AGP 8.0 이상을 타겟팅하는 경우 전체 R8 모드를 명시적으로 사용 중지해야 합니다.

# settings.gradle
android.enableR8.fullMode=false

Kotlin 버전 호환성

Kotlin은 이전 언어 버전 3개와의 하위 호환성을 지원합니다. 즉, 이미 Driver SDK에서 Kotlin 1.7 이상을 사용하고 있다면 모든 중단 변경사항을 해결하지 않고도 Kotlin 2.0으로 업그레이드할 수 있습니다. 그러나 Kotlin 호환성은 안정적인 언어 기능에만 적용됩니다. Kotlin 언어에서 알파, 베타 또는 실험용 기능을 사용하는 경우 업그레이드 시 추가로 변경해야 할 수 있습니다.

Kotlin 호환성 플래그

이전 섹션에서 언급했듯이 Kotlin은 업그레이드 시 이전 언어 버전 최대 3개를 지원합니다. Kotlin은 중대한 변경사항을 제한하는 데 도움이 되는 두 가지 플래그를 제공합니다.

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

이 플래그는 종속 하위 코드가 Kotlin 2.0을 통합할 준비가 되기 전에 새 API가 사용되지 않도록 합니다.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

보다 타겟팅된 접근 방식

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