Kotlin 1.6 호환성 가이드
언어 현대성 유지 및 _편안한 업데이트_는 Kotlin 언어 설계의 근본 원칙 중 하나입니다. 전자는 언어 발전을 방해하는 구성 요소는 제거되어야 한다고 말하며, 후자는 코드 마이그레이션을 최대한 원활하게 하기 위해 이러한 제거는 사전에 잘 전달되어야 한다고 말합니다.
대부분의 언어 변경 사항은 업데이트 변경 로그나 컴파일러 경고와 같은 다른 채널을 통해 이미 발표되었지만, 이 문서는 모든 내용을 요약하여 Kotlin 1.5에서 Kotlin 1.6으로 마이그레이션하기 위한 완전한 참고 자료를 제공합니다.
기본 용어
이 문서에서는 여러 유형의 호환성을 소개합니다:
- 소스: 소스 비호환성 변경은 (오류나 경고 없이) 잘 컴파일되던 코드가 더 이상 컴파일되지 않게 합니다.
- 바이너리: 두 바이너리 아티팩트가 서로 교환될 때 로딩 또는 연결 오류를 발생시키지 않는다면 바이너리 호환성이 있다고 말합니다.
- 동작: 동일한 프로그램이 변경 사항을 적용하기 전후에 다른 동작을 보인다면 동작 비호환성이 있다고 말합니다.
이러한 정의는 순수 Kotlin에 대해서만 주어진다는 점을 기억하십시오. 다른 언어 관점(예: Java)에서의 Kotlin 코드 호환성은 이 문서의 범위를 벗어납니다.
언어
enum, sealed, Boolean 타입을 subject로 사용하는 when 문을 기본적으로 완전하게 만듭니다
이슈: KT-47709
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 enum, sealed 또는 Boolean 타입을 subject로 사용하는
when문이 완전하지 않은 경우 경고를 발생시킵니다.지원 중단 주기:
- 1.6.0: enum, sealed 또는 Boolean 타입을 subject로 사용하는
when문이 완전하지 않을 때 경고를 도입합니다 (점진적 모드에서는 오류).- 1.7.0: 이 경고를 오류로 상향 조정합니다.
when-with-subject에서 혼동을 주는 문법 지원 중단
이슈: KT-48385
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는
when조건 표현식에서 혼동을 주는 몇 가지 문법 구성 요소를 지원 중단합니다.지원 중단 주기:
- 1.6.20: 영향을 받는 표현식에 지원 중단 경고를 도입합니다.
- 1.8.0: 이 경고를 오류로 상향 조정합니다.
= 1.8: 일부 지원 중단된 구성 요소를 새로운 언어 기능으로 재사용합니다.
컴패니언 및 중첩 객체의 상위 생성자 호출에서 클래스 멤버에 대한 접근 금지
이슈: KT-25289
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 컴패니언 및 일반 객체의 상위 생성자 호출 인수가 포함 선언을 참조하는 경우 오류를 보고합니다.
지원 중단 주기:
- 1.5.20: 문제가 되는 인수에 대한 경고를 도입합니다.
- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-ProhibitSelfCallsInNestedObjects를 사용하여 일시적으로 1.6 이전 동작으로 되돌릴 수 있습니다.
타입 널러블성 향상 개선
이슈: KT-48623
구성 요소: Kotlin/JVM
호환성 변경 유형: 소스
요약: Kotlin 1.7에서는 Java 코드에서 타입 널러블성 어노테이션을 로드하고 해석하는 방식을 변경합니다.
지원 중단 주기:
- 1.4.30: 더 정확한 타입 널러블성으로 인해 오류가 발생할 수 있는 경우에 대한 경고를 도입합니다.
- 1.7.0: Java 타입의 널러블성을 더 정확하게 추론하며,
-XXLanguage:-TypeEnhancementImprovementsInStrictMode를 사용하여 일시적으로 1.7 이전 동작으로 되돌릴 수 있습니다.
다른 숫자 타입 간의 암시적 타입 강제 변환 방지
이슈: KT-48645
구성 요소: Kotlin/JVM
호환성 변경 유형: 동작
요약: Kotlin은 숫자 값을 의미상 해당 타입으로의 다운캐스트만 필요한 경우 자동으로 기본 숫자 타입으로 변환하는 것을 피합니다.
지원 중단 주기:
- < 1.5.30: 영향을 받는 모든 경우에서 이전 동작.
- 1.5.30: 생성된 프로퍼티 위임 접근자에서 다운캐스트 동작을 수정하며,
-Xuse-old-backend를 사용하여 일시적으로 1.5.30 이전 수정 동작으로 되돌릴 수 있습니다.= 1.6.20: 영향을 받는 다른 경우에서 다운캐스트 동작을 수정합니다.
컨테이너 어노테이션이 JLS를 위반하는 반복 가능한 어노테이션 클래스 선언 금지
이슈: KT-47928
구성 요소: Kotlin/JVM
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 반복 가능한 어노테이션의 컨테이너 어노테이션이 JLS 9.6.3과 동일한 요구 사항(배열 타입 값 메서드, 보존(retention), 대상(target))을 충족하는지 확인합니다.
지원 중단 주기:
- 1.5.30: JLS 요구 사항을 위반하는 반복 가능한 컨테이너 어노테이션 선언에 경고를 도입합니다 (점진적 모드에서는 오류).
- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-RepeatableAnnotationContainerConstraints를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
반복 가능한 어노테이션 클래스 내부에 Container라는 이름의 중첩 클래스 선언 금지
이슈: KT-47971
구성 요소: Kotlin/JVM
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 Kotlin에서 선언된 반복 가능한 어노테이션에 미리 정의된 이름
Container를 가진 중첩 클래스가 없는지 확인합니다.지원 중단 주기:
- 1.5.30: Kotlin 반복 가능한 어노테이션 클래스 내부에
Container라는 이름의 중첩 클래스에 경고를 도입합니다 (점진적 모드에서는 오류).- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-RepeatableAnnotationContainerConstraints를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
인터페이스 프로퍼티를 재정의하는 주 생성자의 프로퍼티에 @JvmField 사용 금지
이슈: KT-32753
구성 요소: Kotlin/JVM
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 인터페이스 프로퍼티를 재정의하는 주 생성자에 선언된 프로퍼티에
@JvmField어노테이션을 사용하는 것을 금지합니다.지원 중단 주기:
- 1.5.20: 주 생성자의 이러한 프로퍼티에
@JvmField어노테이션에 대한 경고를 도입합니다.- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-ProhibitJvmFieldOnOverrideFromInterfaceInPrimaryConstructor를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
컴파일러 옵션 -Xjvm-default의 enable 및 compatibility 모드 지원 중단
이슈: KT-46329
구성 요소: Kotlin/JVM
호환성 변경 유형: 소스
요약: Kotlin 1.6.20에서는
-Xjvm-default컴파일러 옵션의enable및compatibility모드 사용에 대해 경고를 발생시킵니다.지원 중단 주기:
- 1.6.20:
-Xjvm-default컴파일러 옵션의enable및compatibility모드에 경고를 도입합니다.= 1.8.0: 이 경고를 오류로 상향 조정합니다.
public-ABI 인라인 함수에서 super 호출 금지
이슈: KT-45379
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 public 또는 protected 인라인 함수 및 프로퍼티에서
super한정자로 함수를 호출하는 것을 금지합니다.지원 중단 주기:
- 1.5.0: public 또는 protected 인라인 함수 또는 프로퍼티 접근자에서
super호출에 대한 경고를 도입합니다.- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-ProhibitSuperCallsFromPublicInline를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
public 인라인 함수에서 protected 생성자 호출 금지
이슈: KT-48860
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 public 또는 protected 인라인 함수 및 프로퍼티에서 protected 생성자를 호출하는 것을 금지합니다.
지원 중단 주기:
- 1.4.30: public 또는 protected 인라인 함수 또는 프로퍼티 접근자에서 protected 생성자 호출에 대한 경고를 도입합니다.
- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-ProhibitProtectedConstructorCallFromPublicInline를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
파일 내 private 타입에서 private 중첩 타입 노출 금지
이슈: KT-20094
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6에서는 파일 내 private 타입에서 private 중첩 타입 및 내부 클래스를 노출하는 것을 금지합니다.
지원 중단 주기:
- 1.5.0: 파일 내 private 타입에서 노출되는 private 타입에 대한 경고를 도입합니다.
- 1.6.0: 이 경고를 오류로 상향 조정하며,
-XXLanguage:-PrivateInFileEffectiveVisibility를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
타입에 대한 어노테이션의 경우, 일부 케이스에서 어노테이션 대상이 분석되지 않음
이슈: KT-28449
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6부터는 타입에 적용할 수 없는 어노테이션이 타입에 사용되는 것을 더 이상 허용하지 않습니다.
지원 중단 주기:
- 1.5.20: 점진적 모드에서 오류를 도입합니다.
- 1.6.0: 오류를 도입하며,
-XXLanguage:-ProperCheckAnnotationsTargetInTypeUsePositions를 사용하여 일시적으로 오류 보고를 비활성화할 수 있습니다.
후행 람다를 사용하는 suspend라는 이름의 함수 호출 금지
이슈: KT-22562
구성 요소: 코어 언어
호환성 변경 유형: 소스
요약: Kotlin 1.6부터는 단일 함수 타입 인수가 후행 람다로 전달되는
suspend라는 이름의 함수 호출을 더 이상 허용하지 않습니다.지원 중단 주기:
- 1.3.0: 이러한 함수 호출에 대한 경고를 도입합니다.
- 1.6.0: 이 경고를 오류로 상향 조정합니다.
= 1.7.0:
{앞에suspend가 키워드로 파싱되도록 언어 문법을 변경합니다.
표준 라이브러리
minus/removeAll/retainAll에서 취약한 contains 최적화 제거
이슈: KT-45438
구성 요소: kotlin-stdlib
호환성 변경 유형: 동작
요약: Kotlin 1.6에서는 컬렉션/이터러블/배열/시퀀스에서 여러 요소를 제거하는 함수 및 연산자의 인수에 대해 더 이상 Set으로 변환을 수행하지 않습니다.
지원 중단 주기:
- < 1.6: 이전 동작: 일부 경우 인수를 Set으로 변환했습니다.
- 1.6.0: 함수의 인수가 컬렉션인 경우 더 이상
Set으로 변환되지 않습니다. 컬렉션이 아닌 경우List로 변환될 수 있습니다. 이전 동작은 JVM에서kotlin.collections.convert_arg_to_set_in_removeAll=true시스템 프로퍼티를 설정하여 일시적으로 되돌릴 수 있습니다.= 1.7: 위의 시스템 프로퍼티는 더 이상 영향을 미치지 않습니다.
Random.nextLong의 값 생성 알고리즘 변경
이슈: KT-47304
구성 요소: kotlin-stdlib
호환성 변경 유형: 동작
요약: Kotlin 1.6에서는
Random.nextLong함수의 값 생성 알고리즘을 변경하여 지정된 범위를 벗어나는 값이 생성되는 것을 방지합니다.지원 중단 주기:
- 1.6.0: 동작이 즉시 수정됩니다.
컬렉션 min 및 max 함수의 반환 타입을 점진적으로 널 불가능으로 변경
이슈: KT-38854
구성 요소: kotlin-stdlib
호환성 변경 유형: 소스
요약: Kotlin 1.7에서는 컬렉션
min및max함수의 반환 타입이 널 불가능으로 변경됩니다.지원 중단 주기:
- 1.4.0:
...OrNull함수를 동의어로 도입하고 영향을 받는 API를 지원 중단합니다 (자세한 내용은 이슈 참조).- 1.5.0: 영향을 받는 API의 지원 중단 수준을 오류로 상향 조정합니다.
- 1.6.0: 지원 중단된 함수를 공개 API에서 숨깁니다.
= 1.7: 영향을 받는 API를 널 불가능 반환 타입으로 다시 도입합니다.
부동 소수점 배열 함수: contains, indexOf, lastIndexOf 지원 중단
이슈: KT-28753
구성 요소: kotlin-stdlib
호환성 변경 유형: 소스
요약: Kotlin은 전체 순서 대신 IEEE-754 순서로 값을 비교하는 부동 소수점 배열 함수
contains,indexOf,lastIndexOf를 지원 중단합니다.지원 중단 주기:
- 1.4.0: 영향을 받는 함수를 경고와 함께 지원 중단합니다.
- 1.6.0: 지원 중단 수준을 오류로 상향 조정합니다.
= 1.7: 지원 중단된 함수를 공개 API에서 숨깁니다.
kotlin.dom 및 kotlin.browser 패키지의 선언을 kotlinx.*로 마이그레이션
이슈: KT-39330
구성 요소: kotlin-stdlib (JS)
호환성 변경 유형: 소스
요약:
kotlin.dom및kotlin.browser패키지의 선언이 stdlib에서 추출될 준비를 위해 해당kotlinx.*패키지로 이동됩니다.지원 중단 주기:
- 1.4.0:
kotlinx.dom및kotlinx.browser패키지에 대체 API를 도입합니다.- 1.4.0:
kotlin.dom및kotlin.browser패키지의 API를 지원 중단하고 위에서 언급한 새 API를 대체제로 제안합니다.- 1.6.0: 지원 중단 수준을 오류로 상향 조정합니다.
= 1.7: stdlib에서 지원 중단된 함수를 제거합니다.
= 1.7:
kotlinx.*패키지의 API를 별도의 라이브러리로 이동합니다.
Kotlin/JS에서 Regex.replace 함수를 인라인하지 않도록 변경
이슈: KT-27738
구성 요소: kotlin-stdlib (JS)
호환성 변경 유형: 소스
요약: 함수형
transform매개변수를 가진Regex.replace함수는 Kotlin/JS에서 더 이상 인라인되지 않습니다.지원 중단 주기:
- 1.6.0: 영향을 받는 함수에서
inline한정자를 제거합니다.
교체 문자열에 그룹 참조가 포함된 경우 JVM과 JS에서 Regex.replace 함수의 동작 차이
이슈: KT-28378
구성 요소: kotlin-stdlib (JS)
호환성 변경 유형: 동작
요약: Kotlin/JS의
Regex.replace함수에서 교체 패턴 문자열이 Kotlin/JVM과 동일한 패턴 구문을 따릅니다.지원 중단 주기:
- 1.6.0: Kotlin/JS stdlib의
Regex.replace에서 교체 패턴 처리를 변경합니다.
JS Regex에서 유니코드 대소문자 폴딩 사용
이슈: KT-45928
구성 요소: kotlin-stdlib (JS)
호환성 변경 유형: 동작
요약: Kotlin/JS의
Regex클래스는 유니코드 규칙에 따라 문자를 검색하고 비교하기 위해 기본 JS 정규 표현식 엔진을 호출할 때unicode플래그를 사용합니다. 이는 JS 환경의 특정 버전 요구 사항을 가져오고 정규식 패턴 문자열의 불필요한 이스케이프에 대한 더 엄격한 유효성 검사를 유발합니다.지원 중단 주기:
- 1.5.0: JS
Regex클래스의 대부분 함수에서 유니코드 대소문자 폴딩을 활성화합니다.- 1.6.0:
Regex.replaceFirst함수에서 유니코드 대소문자 폴딩을 활성화합니다.
일부 JS 전용 API 지원 중단
이슈: KT-48587
구성 요소: kotlin-stdlib (JS)
호환성 변경 유형: 소스
요약: stdlib의 여러 JS 전용 함수가 제거를 위해 지원 중단됩니다. 여기에는
String.concat(String),String.match(regex: String),String.matches(regex: String)및 비교 함수를 인수로 받는 배열의sort함수(예:Array<out T>.sort(comparison: (a: T, b: T) -> Int))가 포함됩니다.지원 중단 주기:
- 1.6.0: 영향을 받는 함수를 경고와 함께 지원 중단합니다.
- 1.7.0: 지원 중단 수준을 오류로 상향 조정합니다.
- 1.8.0: 지원 중단된 함수를 공개 API에서 제거합니다.
Kotlin/JS 클래스의 공개 API에서 구현 및 상호 운용성 관련 함수 숨기기
이슈: KT-48587
구성 요소: kotlin-stdlib (JS)
호환성 변경 유형: 소스, 바이너리
요약:
HashMap.createEntrySet및AbstactMutableCollection.toJSON함수의 가시성이 internal로 변경됩니다.지원 중단 주기:
- 1.6.0: 함수를 internal로 만들어 공개 API에서 제거합니다.
도구
KotlinGradleSubplugin 클래스 지원 중단
이슈: KT-48830
구성 요소: Gradle
호환성 변경 유형: 소스
요약:
KotlinGradleSubplugin클래스는KotlinCompilerPluginSupportPlugin을 선호하여 지원 중단됩니다.지원 중단 주기:
- 1.6.0: 지원 중단 수준을 오류로 상향 조정합니다.
= 1.7.0: 지원 중단된 클래스를 제거합니다.
kotlin.useFallbackCompilerSearch 빌드 옵션 제거
이슈: KT-46719
구성 요소: Gradle
호환성 변경 유형: 소스
요약: 지원 중단된
kotlin.useFallbackCompilerSearch빌드 옵션을 제거합니다.지원 중단 주기:
- 1.5.0: 지원 중단 수준을 경고로 상향 조정합니다.
- 1.6.0: 지원 중단된 옵션을 제거합니다.
여러 컴파일러 옵션 제거
이슈: KT-48847
구성 요소: Gradle
호환성 변경 유형: 소스
요약: 지원 중단된
noReflect및includeRuntime컴파일러 옵션을 제거합니다.지원 중단 주기:
- 1.5.0: 지원 중단 수준을 오류로 상향 조정합니다.
- 1.6.0: 지원 중단된 옵션을 제거합니다.
useIR 컴파일러 옵션 지원 중단
이슈: KT-48847
구성 요소: Gradle
호환성 변경 유형: 소스
요약: 지원 중단된
useIR컴파일러 옵션을 숨깁니다.지원 중단 주기:
- 1.5.0: 지원 중단 수준을 경고로 상향 조정합니다.
- 1.6.0: 옵션을 숨깁니다.
= 1.7.0: 지원 중단된 옵션을 제거합니다.
kapt.use.worker.api Gradle 프로퍼티 지원 중단
이슈: KT-48826
구성 요소: Gradle
호환성 변경 유형: 소스
요약: Gradle Workers API를 통해 kapt를 실행할 수 있도록 허용했던
kapt.use.worker.api프로퍼티(기본값: true)를 지원 중단합니다.지원 중단 주기:
- 1.6.20: 지원 중단 수준을 경고로 상향 조정합니다.
= 1.8.0: 이 프로퍼티를 제거합니다.
kotlin.parallel.tasks.in.project Gradle 프로퍼티 제거
이슈: KT-46406
구성 요소: Gradle
호환성 변경 유형: 소스
요약:
kotlin.parallel.tasks.in.project프로퍼티를 제거합니다.지원 중단 주기:
- 1.5.20: 지원 중단 수준을 경고로 상향 조정합니다.
- 1.6.20: 이 프로퍼티를 제거합니다.
kotlin.experimental.coroutines Gradle DSL 옵션 및 kotlin.coroutines Gradle 프로퍼티 지원 중단
이슈: KT-50369
구성 요소: Gradle
호환성 변경 유형: 소스
요약:
kotlin.experimental.coroutinesGradle DSL 옵션 및kotlin.coroutines프로퍼티를 지원 중단합니다.지원 중단 주기:
- 1.6.20: 지원 중단 수준을 경고로 상향 조정합니다.
= 1.7.0: DSL 옵션 및 프로퍼티를 제거합니다.