Kotlin 1.7 호환성 가이드

현대적인 언어 유지 및 _편리한 업데이트_는 Kotlin 언어 설계의 근본 원칙 중 하나입니다. 전자는 언어 발전을 저해하는 구조는 제거되어야 한다고 말하며, 후자는 코드 마이그레이션을 가능한 한 원활하게 하기 위해 이러한 제거를 미리 잘 알려야 한다고 말합니다.

대부분의 언어 변경 사항은 업데이트 변경 로그 또는 컴파일러 경고와 같은 다른 채널을 통해 이미 발표되었지만, 이 문서는 모든 변경 사항을 요약하여 Kotlin 1.6에서 Kotlin 1.7로 마이그레이션하기 위한 완전한 참조를 제공합니다.

기본 용어

이 문서에서는 몇 가지 유형의 호환성을 소개합니다.

• 소스: 소스 비호환 변경은 이전에는 (오류나 경고 없이) 잘 컴파일되던 코드가 더 이상 컴파일되지 않게 만듭니다.
• 바이너리: 두 바이너리 아티팩트(binary artifact)가 서로 교체될 때 로딩 또는 링크 오류가 발생하지 않으면 바이너리 호환된다고 합니다.
• 동작: 동일한 프로그램이 변경 사항을 적용하기 전과 후에 다른 동작을 보인다면 해당 변경은 동작 비호환이라고 합니다.

이러한 정의는 순수 Kotlin에만 적용된다는 점을 기억하세요. 다른 언어(예: Java) 관점에서 Kotlin 코드의 호환성은 이 문서의 범위에 해당하지 않습니다.

언어

안전 호출 결과는 항상 널 허용으로 만들기

Issue: KT-46860

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.7은 안전 호출의 리시버가 널 비허용인 경우에도 안전 호출 결과의 타입을 항상 널 허용으로 간주합니다.

Deprecation cycle:

• <1.3: 널 비허용 리시버에 대한 불필요한 안전 호출에 경고 보고
• 1.6.20: 불필요한 안전 호출 결과의 타입이 다음 버전에서 변경될 것이라는 추가 경고
• 1.7.0: 안전 호출 결과의 타입을 널 허용으로 변경, -XXLanguage:-SafeCallsAreAlwaysNullable을 사용하여 일시적으로 1.7 이전 동작으로 되돌릴 수 있습니다.

추상 상위 클래스 멤버에 대한 super 호출 위임 금지

Issues: KT-45508, KT-49017, KT-38078

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin은 상위 인터페이스에 기본 구현이 있더라도 명시적 또는 암시적 super 호출이 상위 클래스의 추상 멤버에 위임될 때 컴파일 오류를 보고합니다.

Deprecation cycle:

• 1.5.20: 모든 추상 멤버를 오버라이드하지 않는 비추상 클래스가 사용될 때 경고 도입
• 1.7.0: super 호출이 실제로 상위 클래스의 추상 멤버에 접근하는 경우 오류 보고
• 1.7.0: -Xjvm-default=all 또는 -Xjvm-default=all-compatibility 호환성 모드가 활성화된 경우 오류 보고; 프로그레시브 모드에서 오류 보고

• =1.8.0: 모든 경우에 오류 보고

비공개 주 생성자에서 선언된 공개 프로퍼티를 통해 비공개 타입 노출 금지

Issue: KT-28078

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin은 비공개 주 생성자에서 비공개 타입을 가진 공개 프로퍼티를 선언하는 것을 방지합니다. 다른 패키지에서 이러한 프로퍼티에 접근하면 IllegalAccessError가 발생할 수 있습니다.

Deprecation cycle:

• 1.3.20: 비공개 생성자에서 선언된, 비공개 타입을 가진 공개 프로퍼티에 경고 보고
• 1.6.20: 프로그레시브 모드에서 이 경고를 오류로 격상
• 1.7.0: 이 경고를 오류로 격상

열거형 이름으로 한정된 초기화되지 않은 열거형 엔트리에 대한 접근 금지

Issue: KT-41124

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.7은 열거형 정적 초기화 블록에서 열거형 이름으로 한정된 초기화되지 않은 열거형 엔트리에 대한 접근을 금지합니다.

Deprecation cycle:

• 1.7.0: 열거형 정적 초기화 블록에서 초기화되지 않은 열거형 엔트리에 접근할 때 오류 보고

when 조건 분기 및 루프 조건에서 복잡한 불리언 표현식의 상수 값 계산 금지

Issue: KT-39883

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin은 리터럴 true 및 false 외의 상수 불리언 표현식을 기반으로 when의 완전성 및 제어 흐름 가정을 더 이상 수행하지 않습니다.

Deprecation cycle:

• 1.5.30: when 분기 또는 루프 조건에서 복잡한 상수 불리언 표현식을 기반으로 when의 완전성 또는 제어 흐름 도달 가능성이 결정될 때 경고 보고
• 1.7.0: 이 경고를 오류로 격상

열거형, sealed, 불리언을 주어로 하는 when 문을 기본적으로 완전하게 만들기

Issue: KT-47709

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.7은 열거형, sealed, 불리언을 주어로 하는 when 문이 불완전할 경우 오류를 보고합니다.

Deprecation cycle:

• 1.6.0: 열거형, sealed, 불리언을 주어로 하는 when 문이 불완전할 때 경고 도입 (프로그레시브 모드에서는 오류)
• 1.7.0: 이 경고를 오류로 격상

주어를 가진 when 문의 혼란스러운 문법 사용 중단

Issue: KT-48385

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.6은 when 조건 표현식에서 몇 가지 혼란스러운 문법 구조를 사용 중단했습니다.

Deprecation cycle:

• 1.6.20: 영향을 받는 표현식에 사용 중단 경고 도입
• 1.8.0: 이 경고를 오류로 격상

• = 1.8: 일부 사용 중단된 구조를 새로운 언어 기능을 위해 재사용

타입 널 허용성 개선 향상

Issue: KT-48623

Component: Kotlin/JVM

Incompatible change type: 소스

Short summary: Kotlin 1.7은 Java 코드에서 타입 널 허용성 어노테이션을 로드하고 해석하는 방식을 변경합니다.

Deprecation cycle:

• 1.4.30: 더 정확한 타입 널 허용성이 오류로 이어질 수 있는 경우에 대한 경고 도입
• 1.7.0: 자바 타입의 더 정확한 널 허용성 추론, -XXLanguage:-TypeEnhancementImprovementsInStrictMode를 사용하여 일시적으로 1.7 이전 동작으로 되돌릴 수 있습니다.

다른 숫자 타입 간의 암시적 강제 변환 방지

Issue: KT-48645

Component: Kotlin/JVM

Incompatible change type: 동작

Short summary: Kotlin은 의미적으로 해당 타입으로의 다운캐스트만 필요한 경우 숫자 값을 자동으로 기본 숫자 타입으로 변환하는 것을 피합니다.

Deprecation cycle:

• < 1.5.30: 영향을 받는 모든 경우에서 이전 동작
• 1.5.30: 생성된 프로퍼티 델리게이트 접근자에서 다운캐스트 동작 수정, -Xuse-old-backend를 사용하여 일시적으로 1.5.30 이전 수정 동작으로 되돌릴 수 있습니다.

• = 1.7.20: 영향을 받는 다른 경우에서 다운캐스트 동작 수정

컴파일러 옵션 -Xjvm-default의 enable 및 compatibility 모드 사용 중단

Issue: KT-46329

Component: Kotlin/JVM

Incompatible change type: 소스

Short summary: Kotlin 1.6.20은 컴파일러 옵션 -Xjvm-default의 enable 및 compatibility 모드 사용에 대해 경고합니다.

Deprecation cycle:

• 1.6.20: 컴파일러 옵션 -Xjvm-default의 enable 및 compatibility 모드에 경고 도입

• = 1.8.0: 이 경고를 오류로 격상

후행 람다를 가진 suspend라는 이름의 함수 호출 금지

Issue: KT-22562

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.6은 단일 함수 타입을 후행 람다로 전달하는 suspend라는 이름의 사용자 함수 호출을 더 이상 허용하지 않습니다.

Deprecation cycle:

• 1.3.0: 이러한 함수 호출에 경고 도입
• 1.6.0: 이 경고를 오류로 격상
• 1.7.0: suspend가 { 앞에 올 경우 키워드로 파싱되도록 언어 문법 변경 도입

다른 모듈에 있는 기본 클래스 프로퍼티에 대한 스마트 캐스트 금지

Issue: KT-52629

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.7은 상위 클래스가 다른 모듈에 위치한 경우 상위 클래스의 프로퍼티에 대한 스마트 캐스트를 더 이상 허용하지 않습니다.

Deprecation cycle:

• 1.6.0: 다른 모듈에 있는 상위 클래스에 선언된 프로퍼티에 대한 스마트 캐스트에 경고 보고
• 1.7.0: 이 경고를 오류로 격상, -XXLanguage:-ProhibitSmartcastsOnPropertyFromAlienBaseClass를 사용하여 일시적으로 1.7 이전 동작으로 되돌릴 수 있습니다.

타입 추론 시 의미 있는 제약 조건 무시 금지

Issue: KT-52668

Component: 핵심 언어

Incompatible change type: 소스

Short summary: Kotlin 1.4-1.6은 잘못된 최적화로 인해 타입 추론 시 일부 타입 제약 조건을 무시했습니다. 이는 런타임에 ClassCastException을 유발하는 불안전한 코드를 작성하는 것을 허용할 수 있었습니다. Kotlin 1.7은 이러한 제약 조건을 고려하여 불안전한 코드를 금지합니다.

Deprecation cycle:

• 1.5.20: 모든 타입 추론 제약 조건이 고려되었을 때 타입 불일치가 발생할 표현식에 경고 보고
• 1.7.0: 모든 제약 조건을 고려하여 이 경고를 오류로 격상, -XXLanguage:-ProperTypeInferenceConstraintsProcessing을 사용하여 일시적으로 1.7 이전 동작으로 되돌릴 수 있습니다.

표준 라이브러리

컬렉션 min 및 max 함수의 반환 타입을 점진적으로 널 비허용으로 변경

Issue: KT-38854

Component: kotlin-stdlib

Incompatible change type: 소스

Short summary: 컬렉션 min 및 max 함수의 반환 타입이 Kotlin 1.7에서 널 비허용으로 변경됩니다.

Deprecation cycle:

• 1.4.0: ...OrNull 함수를 동의어로 도입하고 영향을 받는 API 사용 중단 (자세한 내용은 이슈 참조)
• 1.5.0: 영향을 받는 API의 사용 중단 수준을 오류로 격상
• 1.6.0: 사용 중단된 함수를 공개 API에서 숨기기
• 1.7.0: 영향을 받는 API를 널 비허용 반환 타입으로 재도입

부동 소수점 배열 함수: contains, indexOf, lastIndexOf 사용 중단

Issue: KT-28753

Component: kotlin-stdlib

Incompatible change type: 소스

Short summary: Kotlin은 전체 순서 대신 IEEE-754 순서를 사용하여 값을 비교하는 부동 소수점 배열 함수 contains, indexOf, lastIndexOf를 사용 중단합니다.

Deprecation cycle:

• 1.4.0: 영향을 받는 함수를 경고와 함께 사용 중단
• 1.6.0: 사용 중단 수준을 오류로 격상
• 1.7.0: 사용 중단된 함수를 공개 API에서 숨기기

kotlin.dom 및 kotlin.browser 패키지의 선언을 kotlinx.*로 마이그레이션

Issue: KT-39330

Component: kotlin-stdlib (JS)

Incompatible change type: 소스

Short summary: kotlin.dom 및 kotlin.browser 패키지의 선언이 stdlib에서 분리하기 위해 해당 kotlinx.* 패키지로 이동되었습니다.

Deprecation cycle:

• 1.4.0: kotlinx.dom 및 kotlinx.browser 패키지에 대체 API 도입
• 1.4.0: kotlin.dom 및 kotlin.browser 패키지의 API를 사용 중단하고 위의 새 API를 대체제로 제안
• 1.6.0: 사용 중단 수준을 오류로 격상

• = 1.8: stdlib에서 사용 중단된 함수 제거

• = 1.8: kotlinx.* 패키지의 API를 별도의 라이브러리로 이동

일부 JS 전용 API 사용 중단

Issue: KT-48587

Component: kotlin-stdlib (JS)

Incompatible change type: 소스

Short summary: stdlib에 있는 여러 JS 전용 함수가 제거를 위해 사용 중단되었습니다. 여기에는 String.concat(String), String.match(regex: String), String.matches(regex: String), 그리고 비교 함수를 받는 배열의 sort 함수(예: Array<out T>.sort(comparison: (a: T, b: T) -> Int))가 포함됩니다.

Deprecation cycle:

• 1.6.0: 영향을 받는 함수를 경고와 함께 사용 중단
• 1.8.0: 사용 중단 수준을 오류로 격상
• 1.9.0: 사용 중단된 함수를 공개 API에서 제거

도구

KotlinGradleSubplugin 클래스 제거

Issue: KT-48831

Component: Gradle

Incompatible change type: 소스

Short summary: KotlinGradleSubplugin 클래스를 제거합니다. 대신 KotlinCompilerPluginSupportPlugin 클래스를 사용하세요.

Deprecation cycle:

• 1.6.0: 사용 중단 수준을 오류로 격상
• 1.7.0: 사용 중단된 클래스 제거

useIR 컴파일러 옵션 제거

Issue: KT-48847

Component: Gradle

Incompatible change type: 소스

Short summary: 사용 중단되었고 숨겨진 useIR 컴파일러 옵션을 제거합니다.

Deprecation cycle:

• 1.5.0: 사용 중단 수준을 경고로 격상
• 1.6.0: 옵션 숨기기
• 1.7.0: 사용 중단된 옵션 제거

kapt.use.worker.api Gradle 프로퍼티 사용 중단

Issue: KT-48826

Component: Gradle

Incompatible change type: 소스

Short summary: Gradle Workers API를 통해 kapt를 실행할 수 있었던 kapt.use.worker.api 프로퍼티 (기본값: true)를 사용 중단합니다.

Deprecation cycle:

• 1.6.20: 사용 중단 수준을 경고로 격상

• = 1.8.0: 이 프로퍼티 제거

kotlin.experimental.coroutines Gradle DSL 옵션 및 kotlin.coroutines Gradle 프로퍼티 제거

Issue: KT-50494

Component: Gradle

Incompatible change type: 소스

Short summary: kotlin.experimental.coroutines Gradle DSL 옵션 및 kotlin.coroutines 프로퍼티를 제거합니다.

Deprecation cycle:

• 1.6.20: 사용 중단 수준을 경고로 격상
• 1.7.0: DSL 옵션, 이를 둘러싸는 experimental 블록, 그리고 프로퍼티 제거

useExperimentalAnnotation 컴파일러 옵션 사용 중단

Issue: KT-47763

Component: Gradle

Incompatible change type: 소스

Short summary: 모듈에서 API 사용을 선택(opt in)하는 데 사용되던 숨겨진 useExperimentalAnnotation() Gradle 함수를 제거합니다. 대신 optIn() 함수를 사용할 수 있습니다.

Deprecation cycle:

• 1.6.0: 사용 중단 옵션 숨기기
• 1.7.0: 사용 중단된 옵션 제거

kotlin.compiler.execution.strategy 시스템 프로퍼티 사용 중단

Issue: KT-51830

Component: Gradle

Incompatible change type: 소스

Short summary: 컴파일러 실행 전략을 선택하는 데 사용되던 kotlin.compiler.execution.strategy 시스템 프로퍼티를 사용 중단합니다. 대신 Gradle 프로퍼티 kotlin.compiler.execution.strategy 또는 컴파일 작업 프로퍼티 compilerExecutionStrategy를 사용하세요.

Deprecation cycle:

• 1.7.0: 사용 중단 수준을 경고로 격상

• 1.7.0: 프로퍼티 제거

kotlinOptions.jdkHome 컴파일러 옵션 제거

Issue: KT-46541

Component: Gradle

Incompatible change type: 소스

Short summary: 기본 JAVA_HOME 대신 지정된 위치에서 사용자 지정 JDK를 클래스패스에 포함하는 데 사용되던 kotlinOptions.jdkHome 컴파일러 옵션을 제거합니다. 대신 자바 툴체인을 사용하세요.

Deprecation cycle:

• 1.5.30: 사용 중단 수준을 경고로 격상

• 1.7.0: 옵션 제거

noStdlib 컴파일러 옵션 제거

Issue: KT-49011

Component: Gradle

Incompatible change type: 소스

Short summary: noStdlib 컴파일러 옵션을 제거합니다. Gradle 플러그인은 kotlin.stdlib.default.dependency=true 프로퍼티를 사용하여 Kotlin 표준 라이브러리의 존재 여부를 제어합니다.

Deprecation cycle:

• 1.5.0: 사용 중단 수준을 경고로 격상
• 1.7.0: 옵션 제거

kotlin2js 및 kotlin-dce-plugin 플러그인 제거

Issue: KT-48276

Component: Gradle

Incompatible change type: 소스

Short summary: kotlin2js 및 kotlin-dce-plugin 플러그인을 제거합니다. kotlin2js 대신 새로운 org.jetbrains.kotlin.js 플러그인을 사용하세요. 데드 코드 제거(DCE)는 Kotlin/JS Gradle 플러그인이 적절히 설정되었을 때 작동합니다.

Deprecation cycle:

• 1.4.0: 사용 중단 수준을 경고로 격상
• 1.7.0: 플러그인 제거

컴파일 작업 변경 사항

Issue: KT-32805

Component: Gradle

Incompatible change type: 소스

Short summary: Kotlin 컴파일 작업은 더 이상 Gradle AbstractCompile 작업을 상속하지 않으므로, sourceCompatibility 및 targetCompatibility 입력은 Kotlin 사용자 스크립트에서 더 이상 사용할 수 없습니다. SourceTask.stableSources 입력도 더 이상 사용할 수 없습니다. sourceFilesExtensions 입력은 제거되었습니다. 사용 중단된 Gradle destinationDir: File 출력은 destinationDirectory: DirectoryProperty 출력으로 대체되었습니다. KotlinCompile 작업의 classpath 프로퍼티는 사용 중단되었습니다.

Deprecation cycle:

• 1.7.0: 입력은 사용할 수 없고, 출력은 대체되었으며, classpath 프로퍼티는 사용 중단되었습니다.