Kotlin 1.5.30의 새로운 기능
Kotlin 1.5.30은 향후 변경 사항 미리 보기, 플랫폼 지원 및 도구의 다양한 개선 사항, 새로운 표준 라이브러리 함수를 포함한 언어 업데이트를 제공합니다.
주요 개선 사항은 다음과 같습니다:
- 실험적
sealed when문, 옵트인 요구 사항 사용 변경 사항 등을 포함한 언어 기능 - 애플 실리콘(Apple silicon) 기본 지원
- Kotlin/JS IR 백엔드가 베타(Beta) 단계 도달
- 개선된 Gradle 플러그인 경험
변경 사항에 대한 간략한 개요는 출시 블로그 게시물과 다음 비디오에서도 확인할 수 있습니다:
언어 기능
Kotlin 1.5.30은 향후 언어 변경 사항을 미리 보여주고 옵트인 요구 사항 메커니즘과 타입 추론에 대한 개선 사항을 제공합니다:
- sealed 클래스 및 Boolean subject에 대한 완전한
when문 - 슈퍼타입으로서의
suspend함수 - 실험적 API의 암시적 사용에 대한 옵트인 요구
- 서로 다른 타겟에 옵트인 요구 사항 어노테이션 사용 변경 사항
- 재귀 제네릭 타입에 대한 타입 추론 개선
- 빌더 추론 제한 제거
sealed 클래스 및 Boolean subject에 대한 완전한 when 문
DANGER
sealed (완전한) when 문에 대한 지원은 Experimental입니다. 언제든지 변경되거나 중단될 수 있습니다.
옵트인이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
완전한 when 문은 subject의 모든 가능한 타입이나 값에 대한 브랜치, 또는 특정 타입에 대한 브랜치를 포함하고 나머지 경우를 다루기 위해 else 브랜치를 포함합니다.
저희는 when 표현식과 동작을 일관되게 만들기 위해 불완전한 when 문을 곧 금지할 예정입니다. 원활한 마이그레이션을 위해 컴파일러가 sealed 클래스 또는 Boolean에 대한 불완전한 when 문에 대해 경고를 보고하도록 구성할 수 있습니다. 이러한 경고는 Kotlin 1.6부터 기본으로 표시되며, 나중에는 에러가 됩니다.
NOTE
Enum은 이미 경고를 받습니다.
sealed class Mode {
object ON : Mode()
object OFF : Mode()
}
fun main() {
val x: Mode = Mode.ON
when (x) {
Mode.ON -> println("ON")
}
// WARNING: sealed 클래스/인터페이스의 불완전한 'when' 문은 1.7에서 금지될 예정입니다.
// 대신 'OFF' 또는 'else' 브랜치를 추가하세요.
val y: Boolean = true
when (y) {
true -> println("true")
}
// WARNING: Boolean의 불완전한 'when' 문은 1.7에서 금지될 예정입니다.
// 대신 'false' 또는 'else' 브랜치를 추가하세요.
}Kotlin 1.5.30에서 이 기능을 활성화하려면 언어 버전 1.6을 사용하세요. 프로그레시브 모드를 활성화하여 경고를 에러로 변경할 수도 있습니다.
kotlin {
sourceSets.all {
languageSettings.apply {
languageVersion = "1.6"
//progressiveMode = true // false by default
}
}
}kotlin {
sourceSets.all {
languageSettings {
languageVersion = '1.6'
//progressiveMode = true // false by default
}
}
}슈퍼타입으로서의 suspend 함수
DANGER
슈퍼타입으로서의 suspend 함수에 대한 지원은 Experimental입니다. 언제든지 변경되거나 중단될 수 있습니다.
옵트인이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
Kotlin 1.5.30은 suspend 함수 타입을 일부 제한 사항과 함께 슈퍼타입으로 사용할 수 있는 기능을 미리 제공합니다.
class MyClass: suspend () -> Unit {
override suspend fun invoke() { TODO() }
}이 기능을 활성화하려면 -language-version 1.6 컴파일러 옵션을 사용하세요:
kotlin {
sourceSets.all {
languageSettings.apply {
languageVersion = "1.6"
}
}
}kotlin {
sourceSets.all {
languageSettings {
languageVersion = '1.6'
}
}
}이 기능에는 다음과 같은 제약이 있습니다:
- 일반 함수 타입과
suspend함수 타입을 슈퍼타입으로 함께 사용할 수 없습니다. 이는 JVM 백엔드에서suspend함수 타입의 구현 세부 사항 때문입니다. JVM 백엔드에서는 마커 인터페이스가 있는 일반 함수 타입으로 표현됩니다. 마커 인터페이스 때문에 어떤 슈퍼 인터페이스가suspend이고 어떤 것이 일반적인지 구별할 방법이 없습니다. - 여러 개의
suspend함수 슈퍼타입을 사용할 수 없습니다. 타입 검사가 있는 경우 여러 개의 일반 함수 슈퍼타입도 사용할 수 없습니다.
실험적 API의 암시적 사용에 대한 옵트인 요구
DANGER
옵트인 요구 사항 메커니즘은 Experimental입니다.
언제든지 변경될 수 있습니다. 옵트인 방법 확인.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
라이브러리 작성자는 실험적 API를 옵트인 요구 사항으로 표시하여 사용자에게 실험적 상태임을 알릴 수 있습니다. 이 API를 사용하면 컴파일러가 경고 또는 에러를 발생시키며, 이를 억제하려면 명시적 동의가 필요합니다.
Kotlin 1.5.30에서는 컴파일러가 시그니처에 실험적 타입을 포함하는 모든 선언을 실험적인 것으로 취급합니다. 즉, 실험적 API의 암시적 사용에 대해서도 옵트인이 필요합니다. 예를 들어, 함수의 반환 타입이 실험적 API 요소로 표시되어 있다면, 해당 선언이 명시적으로 옵트인을 요구하도록 표시되지 않았더라도 함수를 사용하는 데 옵트인이 필요합니다.
// 라이브러리 코드
@RequiresOptIn(message = "This API is experimental.")
@Retention(AnnotationRetention.BINARY)
@Target(AnnotationTarget.CLASS)
annotation class MyDateTime // 옵트인 요구 사항 어노테이션
@MyDateTime
class DateProvider // 옵트인이 필요한 클래스
// 클라이언트 코드
// 경고: 실험적 API 사용
fun createDateSource(): DateProvider { /* ... */ }
fun getDate(): Date {
val dateSource = createDateSource() // 또한 경고: 실험적 API 사용
// ...
}옵트인 요구 사항에 대해 자세히 알아보세요.
서로 다른 타겟에 옵트인 요구 사항 어노테이션 사용 변경 사항
DANGER
옵트인 요구 사항 메커니즘은 Experimental입니다.
언제든지 변경될 수 있습니다. 옵트인 방법 확인.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
Kotlin 1.5.30은 서로 다른 타겟에 옵트인 요구 사항 어노테이션을 사용하고 선언하는 새로운 규칙을 제시합니다. 컴파일러는 컴파일 시점에 처리하기 어려운 사용 사례에 대해 이제 에러를 보고합니다. Kotlin 1.5.30에서:
- 사용 위치에서 지역 변수 및 값 매개변수를 옵트인 요구 사항 어노테이션으로 표시하는 것은 금지됩니다.
- 오버라이드(override)를 표시하는 것은 기본 선언도 표시된 경우에만 허용됩니다.
- 백킹 필드(backing field)와 게터(getter)를 표시하는 것은 금지됩니다. 대신 기본 프로퍼티를 표시할 수 있습니다.
TYPE및TYPE_PARAMETER어노테이션 타겟을 옵트인 요구 사항 어노테이션 선언 위치에서 설정하는 것은 금지됩니다.
옵트인 요구 사항에 대해 자세히 알아보세요.
재귀 제네릭 타입에 대한 타입 추론 개선
Kotlin과 Java에서는 타입 매개변수에서 자신을 참조하는 재귀 제네릭 타입을 정의할 수 있습니다. Kotlin 1.5.30에서는 Kotlin 컴파일러가 해당 타입 매개변수의 상한(upper bound)에만 기반하여 타입 인자를 추론할 수 있습니다. 이는 Java에서 빌더 API를 만들 때 자주 사용되는 재귀 제네릭 타입으로 다양한 패턴을 생성할 수 있게 합니다.
// Kotlin 1.5.20
val containerA = PostgreSQLContainer<Nothing>(DockerImageName.parse("postgres:13-alpine")).apply {
withDatabaseName("db")
withUsername("user")
withPassword("password")
withInitScript("sql/schema.sql")
}
// Kotlin 1.5.30
val containerB = PostgreSQLContainer(DockerImageName.parse("postgres:13-alpine"))
.withDatabaseName("db")
.withUsername("user")
.withPassword("password")
.withInitScript("sql/schema.sql")-Xself-upper-bound-inference 또는 -language-version 1.6 컴파일러 옵션을 전달하여 개선 사항을 활성화할 수 있습니다. 새로 지원되는 사용 사례의 다른 예시는 이 YouTrack 티켓에서 확인할 수 있습니다.
빌더 추론 제한 제거
빌더 추론(Builder inference)은 람다 인자 내부의 다른 호출에서 얻은 타입 정보를 기반으로 호출의 타입 인자를 추론할 수 있게 하는 특수한 타입 추론 방식입니다. 이는 buildList() 또는 sequence()와 같은 제네릭 빌더 함수를 호출할 때 유용합니다: buildList { add("string") }.
이러한 람다 인자 내부에서는 이전에 빌더 추론이 추론하려는 타입 정보를 사용하는 데 제한이 있었습니다. 즉, 타입을 지정할 수만 있고 가져올 수는 없었습니다. 예를 들어, 명시적으로 타입 인자를 지정하지 않고는 buildList()의 람다 인자 내부에서 get()을 호출할 수 없었습니다.
Kotlin 1.5.30은 -Xunrestricted-builder-inference 컴파일러 옵션을 사용하여 이러한 제한을 제거합니다. 이 옵션을 추가하여 제네릭 빌더 함수의 람다 인자 내부에서 이전에 금지되었던 호출을 활성화할 수 있습니다:
@kotlin.ExperimentalStdlibApi
val list = buildList {
add("a")
add("b")
set(1, null)
val x = get(1)
if (x != null) {
removeAt(1)
}
}
@kotlin.ExperimentalStdlibApi
val map = buildMap {
put("a", 1)
put("b", 1.1)
put("c", 2f)
}또한, 이 기능은 -language-version 1.6 컴파일러 옵션으로도 활성화할 수 있습니다.
Kotlin/JVM
Kotlin 1.5.30에서는 Kotlin/JVM에 다음 기능이 추가됩니다:
JVM 플랫폼의 Kotlin Gradle 플러그인 업데이트는 Gradle 섹션을 참조하세요.
어노테이션 클래스 인스턴스화
DANGER
어노테이션 클래스 인스턴스화는 Experimental입니다. 언제든지 변경되거나 중단될 수 있습니다.
옵트인이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
Kotlin 1.5.30부터는 이제 임의의 코드에서 어노테이션 클래스의 생성자를 호출하여 결과 인스턴스를 얻을 수 있습니다. 이 기능은 어노테이션 인터페이스 구현을 허용하는 Java 관습과 동일한 사용 사례를 다룹니다.
annotation class InfoMarker(val info: String)
fun processInfo(marker: InfoMarker) = ...
fun main(args: Array<String>) {
if (args.size != 0)
processInfo(getAnnotationReflective(args))
else
processInfo(InfoMarker("default"))
}이 기능을 활성화하려면 -language-version 1.6 컴파일러 옵션을 사용하세요. val이 아닌 매개변수나 보조 생성자와 다른 멤버를 정의하는 것과 같은 현재 어노테이션 클래스 제한 사항은 그대로 유지됩니다.
이 KEEP에서 어노테이션 클래스 인스턴스화에 대해 자세히 알아보세요.
널 가능성 어노테이션 지원 구성 개선
Kotlin 컴파일러는 Java에서 널 가능성 정보를 얻기 위해 다양한 유형의 널 가능성 어노테이션을 읽을 수 있습니다. 이 정보는 Kotlin에서 Java 코드를 호출할 때 널 가능성 불일치를 보고할 수 있도록 합니다.
Kotlin 1.5.30에서는 특정 유형의 널 가능성 어노테이션 정보에 기반하여 컴파일러가 널 가능성 불일치를 보고할지 여부를 지정할 수 있습니다. 컴파일러 옵션 -Xnullability-annotations=@<package-name>:<report-level>을 사용하면 됩니다. 인자에서 완전한 널 가능성 어노테이션 패키지 이름과 다음 보고 수준 중 하나를 지정하세요:
ignore는 널 가능성 불일치를 무시합니다.warn은 경고를 보고합니다.strict는 에러를 보고합니다.
지원되는 모든 널 가능성 어노테이션의 전체 목록과 완전한 패키지 이름을 참조하세요.
다음은 새로 지원되는 RxJava 3 널 가능성 어노테이션에 대한 에러 보고를 활성화하는 방법을 보여주는 예시입니다: [email protected]:strict. 기본적으로 모든 이러한 널 가능성 불일치는 경고로 처리됩니다.
Kotlin/Native
Kotlin/Native는 다양한 변경 사항과 개선 사항을 받았습니다:
- 애플 실리콘 지원
- CocoaPods Gradle 플러그인용 Kotlin DSL 개선
- Swift 5.5
async/await와의 Experimental 상호 운용성 - 객체 및 동반 객체(companion objects)에 대한 Swift/Objective-C 매핑 개선
- MinGW 타겟을 위한 임포트 라이브러리 없는 DLL 연결의 사용 중단
애플 실리콘 지원
Kotlin 1.5.30은 애플 실리콘(Apple silicon)에 대한 기본 지원을 도입합니다.
이전에는 Kotlin/Native 컴파일러 및 도구가 애플 실리콘 호스트에서 작동하려면 Rosetta 번역 환경이 필요했습니다. Kotlin 1.5.30부터는 번역 환경이 더 이상 필요하지 않습니다. 컴파일러 및 도구가 추가 작업 없이 애플 실리콘 하드웨어에서 실행될 수 있습니다.
또한 Kotlin 코드가 애플 실리콘에서 기본적으로 실행되도록 하는 새로운 타겟을 도입했습니다:
macosArm64iosSimulatorArm64watchosSimulatorArm64tvosSimulatorArm64
이들은 Intel 기반 및 애플 실리콘 호스트 모두에서 사용할 수 있습니다. 모든 기존 타겟도 애플 실리콘 호스트에서 사용할 수 있습니다.
1.5.30에서는 kotlin-multiplatform Gradle 플러그인에서 애플 실리콘 타겟에 대한 기본적인 지원만 제공합니다. 특히, 새로운 시뮬레이터 타겟은 ios, tvos, watchos 타겟 단축키에 포함되지 않습니다. 새로운 타겟에 대한 사용자 경험을 개선하기 위해 계속 노력할 것입니다.
CocoaPods Gradle 플러그인용 Kotlin DSL 개선
Kotlin/Native 프레임워크를 위한 새로운 매개변수
Kotlin 1.5.30은 Kotlin/Native 프레임워크를 위한 개선된 CocoaPods Gradle 플러그인 DSL을 도입합니다. 프레임워크 이름 외에 Pod 구성에서 다른 매개변수도 지정할 수 있습니다:
- 프레임워크의 동적 또는 정적 버전 지정
- 의존성 명시적 내보내기 활성화
- Bitcode 임베딩 활성화
새로운 DSL을 사용하려면 프로젝트를 Kotlin 1.5.30으로 업데이트하고 build.gradle(.kts) 파일의 cocoapods 섹션에 매개변수를 지정하세요:
cocoapods {
frameworkName = "MyFramework" // 이 속성은 더 이상 사용되지 않으며
// 향후 버전에서 제거될 예정입니다.
// 프레임워크 구성을 위한 새로운 DSL:
framework {
// 모든 Framework 속성이 지원됩니다.
// 프레임워크 이름 구성. 더 이상 사용되지 않는 'frameworkName' 대신 이 속성을 사용하세요.
baseName = "MyFramework"
// 동적 프레임워크 지원
isStatic = false
// 의존성 내보내기
export(project(":anotherKMMModule"))
transitiveExport = false // 이것이 기본값입니다.
// Bitcode 임베딩
embedBitcode(BITCODE)
}
}Xcode 구성에 대한 사용자 지정 이름 지원
Kotlin CocoaPods Gradle 플러그인은 Xcode 빌드 구성에서 사용자 지정 이름을 지원합니다. 이는 Xcode에서 빌드 구성에 Staging과 같은 특수 이름을 사용하는 경우에도 도움이 될 것입니다.
사용자 지정 이름을 지정하려면 build.gradle(.kts) 파일의 cocoapods 섹션에서 xcodeConfigurationToNativeBuildType 매개변수를 사용하세요:
cocoapods {
// 사용자 지정 Xcode 구성을 NativeBuildType에 매핑합니다.
xcodeConfigurationToNativeBuildType["CUSTOM_DEBUG"] = NativeBuildType.DEBUG
xcodeConfigurationToNativeBuildType["CUSTOM_RELEASE"] = NativeBuildType.RELEASE
}이 매개변수는 Podspec 파일에 나타나지 않습니다. Xcode가 Gradle 빌드 프로세스를 실행할 때 Kotlin CocoaPods Gradle 플러그인은 필요한 네이티브 빌드 타입을 선택합니다.
NOTE
Debug 및 Release 구성은 기본적으로 지원되므로 선언할 필요가 없습니다.
Swift 5.5 async/await와의 Experimental 상호 운용성
DANGER
Swift async/await와의 동시성 상호 운용성은 Experimental입니다. 언제든지 변경되거나 중단될 수 있습니다.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
저희는 Kotlin의 suspend 함수를 Objective-C 및 Swift에서 호출하는 지원을 1.4.0에 추가했으며, 이제 새로운 Swift 5.5 기능인 async 및 await 수식어를 사용한 동시성에 발맞춰 이를 개선하고 있습니다.
이제 Kotlin/Native 컴파일러는 널 가능성 반환 타입을 가진 suspend 함수에 대해 생성된 Objective-C 헤더에 _Nullable_result 속성을 내보냅니다. 이를 통해 Swift에서 적절한 널 가능성을 가진 async 함수로 호출할 수 있습니다.
이 기능은 실험적이며 향후 Kotlin과 Swift 모두의 변경 사항에 영향을 받을 수 있습니다. 현재로서는 특정 제한 사항이 있는 이 기능의 미리 보기를 제공하며, 여러분의 의견을 듣고 싶습니다. 현재 상태에 대한 자세한 내용은 이 YouTrack 이슈에서 확인하고 피드백을 남겨주세요.
객체 및 동반 객체(companion objects)에 대한 Swift/Objective-C 매핑 개선
이제 객체(objects) 및 동반 객체(companion objects)를 iOS 네이티브 개발자에게 더 직관적인 방식으로 얻을 수 있습니다. 예를 들어, Kotlin에 다음 객체가 있는 경우:
object MyObject {
val x = "Some value"
}
class MyClass {
companion object {
val x = "Some value"
}
}Swift에서 이들에 접근하려면 shared 및 companion 프로퍼티를 사용할 수 있습니다:
MyObject.shared
MyObject.shared.x
MyClass.companion
MyClass.Companion.sharedSwift/Objective-C 상호 운용성에 대해 자세히 알아보세요.
MinGW 타겟을 위한 임포트 라이브러리 없는 DLL 연결의 사용 중단
LLD는 LLVM 프로젝트의 링커로, 기본 ld.bfd보다 성능이 더 좋다는 장점 때문에 Kotlin/Native의 MinGW 타겟에서 사용할 계획입니다.
그러나 LLD의 최신 안정 버전은 MinGW (Windows) 타겟에 대한 DLL에 대한 직접 연결을 지원하지 않습니다. 이러한 연결에는 임포트 라이브러리 사용이 필요합니다. Kotlin/Native 1.5.30에서는 필요하지 않지만, 향후 MinGW의 기본 링커가 될 LLD와 이러한 사용법이 호환되지 않음을 알리기 위해 경고를 추가하고 있습니다.
LLD 링커로의 전환에 대한 여러분의 생각과 우려 사항을 이 YouTrack 이슈에 공유해 주세요.
Kotlin Multiplatform
1.5.30은 Kotlin Multiplatform에 다음과 같은 주목할 만한 업데이트를 제공합니다:
공유 네이티브 코드에서 사용자 지정 cinterop 라이브러리 사용 기능
Kotlin Multiplatform은 공유 소스 세트에서 플랫폼 종속적인 상호 운용 라이브러리를 사용할 수 있는 옵션을 제공합니다. 1.5.30 이전에는 Kotlin/Native 배포판과 함께 제공되는 플랫폼 라이브러리에서만 작동했습니다. 1.5.30부터는 사용자 지정 cinterop 라이브러리와 함께 사용할 수 있습니다. 이 기능을 활성화하려면 gradle.properties에 kotlin.mpp.enableCInteropCommonization=true 속성을 추가하세요:
kotlin.mpp.enableGranularSourceSetsMetadata=true
kotlin.native.enableDependencyPropagation=false
kotlin.mpp.enableCInteropCommonization=trueXCFrameworks 지원
모든 Kotlin Multiplatform 프로젝트는 이제 XCFrameworks를 출력 형식으로 가질 수 있습니다. Apple은 범용 (fat) 프레임워크의 대체품으로 XCFrameworks를 도입했습니다. XCFrameworks를 통해 다음을 수행할 수 있습니다:
- 모든 타겟 플랫폼 및 아키텍처에 대한 로직을 단일 번들로 모을 수 있습니다.
- App Store에 애플리케이션을 게시하기 전에 불필요한 모든 아키텍처를 제거할 필요가 없습니다.
XCFrameworks는 Apple M1 기기 및 시뮬레이터에서 Kotlin 프레임워크를 사용하려는 경우에 유용합니다.
XCFrameworks를 사용하려면 build.gradle(.kts) 스크립트를 업데이트하세요:
import org.jetbrains.kotlin.gradle.plugin.mpp.apple.XCFramework
plugins {
kotlin("multiplatform")
}
kotlin {
val xcf = XCFramework()
ios {
binaries.framework {
baseName = "shared"
xcf.add(this)
}
}
watchos {
binaries.framework {
baseName = "shared"
xcf.add(this)
}
}
tvos {
binaries.framework {
baseName = "shared"
xcf.add(this)
}
}
}import org.jetbrains.kotlin.gradle.plugin.mpp.apple.XCFrameworkConfig
plugins {
id 'org.jetbrains.kotlin.multiplatform'
}
kotlin {
def xcf = new XCFrameworkConfig(project)
ios {
binaries.framework {
baseName = "shared"
xcf.add(it)
}
}
watchos {
binaries.framework {
baseName = "shared"
xcf.add(it)
}
}
tvos {
binaries.framework {
baseName = "shared"
xcf.add(it)
}
}
}XCFrameworks를 선언하면 다음 새로운 Gradle 태스크가 등록됩니다:
assembleXCFrameworkassembleDebugXCFramework(추가적으로 dSYMs를 포함하는 디버그 아티팩트)assembleReleaseXCFramework
이 WWDC 비디오에서 XCFrameworks에 대해 자세히 알아보세요.
Android 아티팩트를 위한 새로운 기본 퍼블리싱 설정
maven-publish Gradle 플러그인을 사용하여 빌드 스크립트에서 Android variant 이름을 지정함으로써 Android 타겟을 위한 멀티플랫폼 라이브러리를 게시할 수 있습니다. Kotlin Gradle 플러그인은 자동으로 게시물을 생성합니다.
1.5.30 이전에는 생성된 게시 메타데이터에 게시된 각 Android variant에 대한 빌드 타입 속성이 포함되어 있었으며, 이는 라이브러리 소비자가 사용하는 동일한 빌드 타입하고만 호환되도록 했습니다. Kotlin 1.5.30은 새로운 기본 퍼블리싱 설정을 도입합니다:
- 프로젝트가 게시하는 모든 Android variant가 동일한 빌드 타입 속성을 가지면, 게시된 variant는 빌드 타입 속성을 가지지 않으며 모든 빌드 타입과 호환됩니다.
- 게시된 variant가 다른 빌드 타입 속성을 가지면,
release값을 가진 variant만 빌드 타입 속성 없이 게시됩니다. 이는 릴리스 variant가 소비자 측의 어떤 빌드 타입과도 호환되도록 하는 반면, 비-릴리스 variant는 일치하는 소비자 빌드 타입하고만 호환됩니다.
옵트아웃하고 모든 variant에 대한 빌드 타입 속성을 유지하려면, kotlin.android.buildTypeAttribute.keep=true Gradle 속성을 설정하면 됩니다.
Kotlin/JS
Kotlin/JS에는 1.5.30과 함께 두 가지 주요 개선 사항이 적용됩니다:
JS IR 컴파일러 백엔드가 베타(Beta) 단계 도달
Kotlin/JS용 IR 기반 컴파일러 백엔드는 1.4.0에서 알파(Alpha)로 도입되었으며, 이제 베타(Beta) 단계에 도달했습니다.
이전에 새로운 백엔드로 프로젝트를 마이그레이션하는 데 도움이 되는 JS IR 백엔드 마이그레이션 가이드를 게시했습니다. 이제 IntelliJ IDEA에서 필요한 변경 사항을 직접 표시해 주는 Kotlin/JS Inspection Pack IDE 플러그인을 소개합니다.
Kotlin/JS IR 백엔드를 사용하는 애플리케이션에 대한 향상된 디버깅 경험
Kotlin 1.5.30은 Kotlin/JS IR 백엔드를 위한 JavaScript 소스 맵 생성을 제공합니다. 이는 IR 백엔드가 활성화되었을 때 Kotlin/JS 디버깅 경험을 개선하여, 중단점(breakpoints), 단계별 실행(stepping), 적절한 소스 참조가 포함된 가독성 있는 스택 트레이스(stack traces)를 포함한 완전한 디버깅 지원을 제공합니다.
브라우저 또는 IntelliJ IDEA Ultimate에서 Kotlin/JS를 디버깅하는 방법에 대해 알아보세요.
Gradle
Kotlin Gradle 플러그인 사용자 경험을 개선하기 위한 저희의 목표의 일환으로, 다음 기능을 구현했습니다:
- Java 툴체인 지원, 여기에는 이전 Gradle 버전에서
UsesKotlinJavaToolchain인터페이스를 사용하여 JDK 홈을 지정하는 기능이 포함됩니다. - Kotlin 데몬의 JVM 인자를 명시적으로 지정하는 더 쉬운 방법
Java 툴체인 지원
Gradle 6.7은 "Java 툴체인 지원" 기능을 도입했습니다. 이 기능을 사용하면 다음을 수행할 수 있습니다:
- Gradle 자체와 다른 JDK 및 JRE를 사용하여 컴파일, 테스트 및 실행 가능 파일을 실행할 수 있습니다.
- 출시되지 않은 언어 버전으로 코드를 컴파일하고 테스트할 수 있습니다.
툴체인 지원을 통해 Gradle은 로컬 JDK를 자동 감지하고 빌드에 필요한 누락된 JDK를 설치할 수 있습니다. 이제 Gradle 자체는 어떤 JDK에서도 실행될 수 있으며 빌드 캐시 기능을 재사용할 수 있습니다.
Kotlin Gradle 플러그인은 Kotlin/JVM 컴파일 작업을 위한 Java 툴체인을 지원합니다. Java 툴체인은 다음을 수행합니다:
JVM 타겟에서 사용 가능한
jdkHome옵션을 설정합니다.사용자가
jvmTarget옵션을 명시적으로 설정하지 않은 경우,kotlinOptions.jvmTarget을 툴체인의 JDK 버전으로 설정합니다. 툴체인이 구성되지 않은 경우jvmTarget필드는 기본값을 사용합니다. JVM 타겟 호환성에 대해 자세히 알아보세요.kapt워커가 실행되는 JDK에 영향을 줍니다.
다음 코드를 사용하여 툴체인을 설정하세요. <MAJOR_JDK_VERSION> 플레이스홀더를 사용하려는 JDK 버전으로 바꾸세요:
kotlin {
jvmToolchain {
(this as JavaToolchainSpec).languageVersion.set(JavaLanguageVersion.of(<MAJOR_JDK_VERSION>)) // "8"
}
}kotlin {
jvmToolchain {
languageVersion.set(JavaLanguageVersion.of(<MAJOR_JDK_VERSION>)) // "8"
}
}kotlin 확장을 통해 툴체인을 설정하면 Java 컴파일 작업의 툴체인도 업데이트됩니다.
java 확장을 통해 툴체인을 설정할 수 있으며, Kotlin 컴파일 작업이 이를 사용합니다:
java {
toolchain {
languageVersion.set(JavaLanguageVersion.of(<MAJOR_JDK_VERSION>)) // "8"
}
}KotlinCompile 작업에 대한 JDK 버전 설정에 대한 정보는 Task DSL을 사용하여 JDK 버전 설정에 대한 문서를 참조하세요.
Gradle 버전 6.1부터 6.6까지는 JDK 홈을 설정하기 위해 UsesKotlinJavaToolchain 인터페이스를 사용하세요.
UsesKotlinJavaToolchain 인터페이스를 사용하여 JDK 홈을 지정하는 기능
kotlinOptions를 통해 JDK 설정을 지원하는 모든 Kotlin 작업은 이제 UsesKotlinJavaToolchain 인터페이스를 구현합니다. JDK 홈을 설정하려면 JDK 경로를 입력하고 <JDK_VERSION> 플레이스홀더를 바꾸세요:
project.tasks
.withType<UsesKotlinJavaToolchain>()
.configureEach {
it.kotlinJavaToolchain.jdk.use(
"/path/to/local/jdk",
JavaVersion.<LOCAL_JDK_VERSION>
)
}project.tasks
.withType(UsesKotlinJavaToolchain.class)
.configureEach {
it.kotlinJavaToolchain.jdk.use(
'/path/to/local/jdk',
JavaVersion.<LOCAL_JDK_VERSION>
)
}Gradle 버전 6.1부터 6.6까지는 UsesKotlinJavaToolchain 인터페이스를 사용하세요. Gradle 6.7부터는 대신 Java 툴체인을 사용하세요.
이 기능을 사용할 때, kapt 작업 워커는 프로세스 격리 모드만 사용하며, kapt.workers.isolation 속성은 무시됩니다.
Kotlin 데몬의 JVM 인자를 명시적으로 지정하는 더 쉬운 방법
Kotlin 1.5.30에는 Kotlin 데몬의 JVM 인자에 대한 새로운 로직이 있습니다. 다음 목록의 각 옵션은 그 앞에 오는 옵션을 재정의합니다:
아무것도 지정하지 않으면 Kotlin 데몬은 Gradle 데몬에서 인자를 상속합니다(이전과 동일). 예를 들어,
gradle.properties파일에서:noneorg.gradle.jvmargs=-Xmx1500m -Xms=500mGradle 데몬의 JVM 인자가
kotlin.daemon.jvm.options시스템 속성을 가지고 있다면, 이전과 같이 사용하세요:noneorg.gradle.jvmargs=-Dkotlin.daemon.jvm.options=-Xmx1500m -Xms=500mgradle.properties파일에kotlin.daemon.jvmargs속성을 추가할 수 있습니다:nonekotlin.daemon.jvmargs=-Xmx1500m -Xms=500mkotlin확장 프로그램에서 인자를 지정할 수 있습니다:
kotlin {
kotlinDaemonJvmArgs = listOf("-Xmx486m", "-Xms256m", "-XX:+UseParallelGC")
}
```
```groovy [Groovy]
kotlin {
kotlinDaemonJvmArgs = ["-Xmx486m", "-Xms256m", "-XX:+UseParallelGC"]
}
```
:::
* 특정 작업에 대한 인자를 지정할 수 있습니다:
::: code-group
```kotlin [Kotlin]
tasks
.matching { it.name == "compileKotlin" && it is CompileUsingKotlinDaemon }
.configureEach {
(this as CompileUsingKotlinDaemon).kotlinDaemonJvmArguments.set(listOf("-Xmx486m", "-Xms256m", "-XX:+UseParallelGC"))
}
```
```groovy [Groovy]
tasks
.matching {
it.name == "compileKotlin" && it instanceof CompileUsingKotlinDaemon
}
.configureEach {
kotlinDaemonJvmArguments.set(["-Xmx1g", "-Xms512m"])
}
```
:::
::: note
이 경우 작업 실행 시 새로운 Kotlin 데몬 인스턴스가 시작될 수 있습니다. [Kotlin 데몬과 JVM 인자 상호 작용](gradle-compilation-and-caches.md#setting-kotlin-daemon-s-jvm-arguments)에 대해 자세히 알아보세요.
:::
Kotlin 데몬에 대한 자세한 내용은 [Kotlin 데몬 및 Gradle과 함께 사용하는 방법](gradle-compilation-and-caches.md#the-kotlin-daemon-and-how-to-use-it-with-gradle)을 참조하세요.
## 표준 라이브러리
Kotlin 1.5.30은 표준 라이브러리의 `Duration` 및 `Regex` API에 대한 개선 사항을 제공합니다:
* [`Duration.toString()` 출력 변경](#changing-duration-tostring-output)
* [문자열에서 Duration 파싱](#parsing-duration-from-string)
* [특정 위치에서 Regex 매칭](#matching-with-regex-at-a-particular-position)
* [Regex를 시퀀스로 분할](#splitting-regex-to-a-sequence)
### `Duration.toString()` 출력 변경
::: warning
Duration API는 [Experimental](components-stability.md)입니다. 언제든지 변경되거나 중단될 수 있습니다.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 [YouTrack](https://youtrack.jetbrains.com/issues/KT)에 남겨주시면 감사하겠습니다.
:::
Kotlin 1.5.30 이전에는 [`Duration.toString()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/to-string.html) 함수가 가장 간결하고 가독성 있는 숫자 값을 생성하는 단위로 표현된 인수의 문자열 표현을 반환했습니다.
이제부터는 숫자 구성 요소의 조합으로 표현된 문자열 값을 반환하며, 각 구성 요소는 자체 단위를 가집니다.
각 구성 요소는 숫자 뒤에 단위의 약어 이름(`d`, `h`, `m`, `s`)이 옵니다. 예를 들어:
|**함수 호출 예시**|**이전 출력**|**현재 출력**|
| --- | --- | --- |
Duration.days(45).toString()|`45.0d`|`45d`|
Duration.days(1.5).toString()|`36.0h`|`1d 12h`|
Duration.minutes(1230).toString()|`20.5h`|`20h 30m`|
Duration.minutes(2415).toString()|`40.3h`|`1d 16h 15m`|
Duration.minutes(920).toString()|`920m`|`15h 20m`|
Duration.seconds(1.546).toString()|`1.55s`|`1.546s`|
Duration.milliseconds(25.12).toString()|`25.1ms`|`25.12ms`|
음수 Duration이 표현되는 방식도 변경되었습니다. 음수 Duration은 마이너스 부호(`-`)로 접두사가 붙고, 여러 구성 요소로 구성된 경우 괄호로 묶입니다: `-12m` 및 `-(1h 30m)`.
1초 미만의 짧은 Duration은 `ms` (밀리초), `us` (마이크로초), 또는 `ns` (나노초)와 같은 서브초 단위 중 하나로 단일 숫자로 표현됩니다: `140.884ms`, `500us`, `24ns`. 더 이상 과학적 표기법은 사용되지 않습니다.
Duration을 단일 단위로 표현하고 싶다면 오버로드된 `Duration.toString(unit, decimals)` 함수를 사용하세요.
::: note
직렬화 및 교환을 포함한 특정 경우에는 [`Duration.toIsoString()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/to-iso-string.html)을 사용하는 것이 좋습니다. `Duration.toIsoString()`은 `Duration.toString()` 대신 더 엄격한 [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) 형식을 사용합니다.
:::
### 문자열에서 Duration 파싱
::: warning
Duration API는 [Experimental](components-stability.md)입니다. 언제든지 변경되거나 중단될 수 있습니다.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 [이 이슈](https://github.com/Kotlin/KEEP/issues/190)에 남겨주시면 감사하겠습니다.
:::
Kotlin 1.5.30에는 Duration API에 새로운 함수가 추가되었습니다:
* 다음 출력 파싱을 지원하는 [`parse()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/parse.html):
* [`toString()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/to-string.html).
* [`toString(unit, decimals)`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/to-string.html).
* [`toIsoString()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/to-iso-string.html).
* `toIsoString()`이 생성하는 형식만 파싱하는 [`parseIsoString()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/parse-iso-string.html).
* 위의 함수와 유사하게 동작하지만 유효하지 않은 duration 형식에 대해 `IllegalArgumentException`을 던지는 대신 `null`을 반환하는 [`parseOrNull()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/parse-or-null.html) 및 [`parseIsoStringOrNull()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/parse-iso-string-or-null.html).
다음은 `parse()` 및 `parseOrNull()` 사용 예시입니다:
```kotlin
import kotlin.time.Duration
import kotlin.time.ExperimentalTime
@ExperimentalTime
fun main() {
val isoFormatString = "PT1H30M"
val defaultFormatString = "1h 30m"
val singleUnitFormatString = "1.5h"
val invalidFormatString = "1 hour 30 minutes"
println(Duration.parse(isoFormatString)) // "1h 30m"
println(Duration.parse(defaultFormatString)) // "1h 30m"
println(Duration.parse(singleUnitFormatString)) // "1h 30m"
//println(Duration.parse(invalidFormatString)) // 예외 발생
println(Duration.parseOrNull(invalidFormatString)) // "null"
}다음은 parseIsoString() 및 parseIsoStringOrNull() 사용 예시입니다:
import kotlin.time.Duration
import kotlin.time.ExperimentalTime
@ExperimentalTime
fun main() {
val isoFormatString = "PT1H30M"
val defaultFormatString = "1h 30m"
println(Duration.parseIsoString(isoFormatString)) // "1h 30m"
//println(Duration.parseIsoString(defaultFormatString)) // 예외 발생
println(Duration.parseIsoStringOrNull(defaultFormatString)) // "null"
}특정 위치에서 Regex 매칭
DANGER
Regex.matchAt() 및 Regex.matchesAt() 함수는 Experimental입니다. 언제든지 변경되거나 중단될 수 있습니다.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
새로운 Regex.matchAt() 및 Regex.matchesAt() 함수는 String 또는 CharSequence 내의 특정 위치에서 정규식이 정확히 일치하는지 확인하는 방법을 제공합니다.
matchesAt()는 boolean 결과를 반환합니다:
fun main(){
val releaseText = "Kotlin 1.5.30 is released!"
// 정규 표현식: 한 자리 숫자, 점, 한 자리 숫자, 점, 하나 이상의 숫자
val versionRegex = "\\d[.]\\d[.]\\d+".toRegex()
println(versionRegex.matchesAt(releaseText, 0)) // "false"
println(versionRegex.matchesAt(releaseText, 7)) // "true"
}matchAt()는 일치하는 항목을 찾으면 매칭 결과를 반환하고, 찾지 못하면 null을 반환합니다:
fun main(){
val releaseText = "Kotlin 1.5.30 is released!"
val versionRegex = "\\d[.]\\d[.]\\d+".toRegex()
println(versionRegex.matchAt(releaseText, 0)) // "null"
println(versionRegex.matchAt(releaseText, 7)?.value) // "1.5.30"
}Regex를 시퀀스로 분할
DANGER
Regex.splitToSequence() 및 CharSequence.splitToSequence(Regex) 함수는 Experimental입니다. 언제든지 변경되거나 중단될 수 있습니다.
평가 목적으로만 사용해야 합니다. 이에 대한 여러분의 피드백을 YouTrack에 남겨주시면 감사하겠습니다.
새로운 Regex.splitToSequence() 함수는 split()의 지연(lazy) 대응 함수입니다. 주어진 정규식의 일치 항목을 기준으로 문자열을 분할하지만, 그 결과를 Sequence로 반환하여 이 결과에 대한 모든 작업이 지연 실행됩니다.
fun main(){
val colorsText = "green, red , brown&blue, orange, pink&green"
val regex = "[,\\s]+".toRegex()
val mixedColor = regex.splitToSequence(colorsText)
.onEach { println(it) }
.firstOrNull { it.contains('&') }
println(mixedColor) // "brown&blue"
}유사한 함수가 CharSequence에도 추가되었습니다:
val mixedColor = colorsText.splitToSequence(regex)Serialization 1.3.0-RC
kotlinx.serialization 1.3.0-RC는 새로운 JSON 직렬화 기능을 제공합니다:
- Java IO 스트림 직렬화
- 기본값에 대한 프로퍼티 수준 제어
- 직렬화에서 null 값 제외 옵션
- 다형성 직렬화에서 사용자 지정 클래스 판별자(discriminators)
변경 로그에서 자세히 알아보세요.