Kotlin 1.8.20의 새로운 기능

출시일: 2023년 4월 25일

Kotlin 1.8.20 릴리스가 공개되었으며, 다음은 주요 하이라이트입니다.

새로운 Kotlin K2 컴파일러 업데이트
새로운 실험적 Kotlin/Wasm 타겟
Gradle에서 기본적으로 새로운 JVM 증분 컴파일
Kotlin/Native 타겟 업데이트
Kotlin Multiplatform에서 Gradle 컴포짓 빌드 지원 미리 보기
Xcode에서 Gradle 오류 출력 개선
표준 라이브러리에서 AutoCloseable 인터페이스에 대한 실험적 지원
표준 라이브러리에서 Base64 인코딩에 대한 실험적 지원

이 비디오에서 변경 사항에 대한 간략한 개요를 확인할 수도 있습니다.

IDE 지원

1.8.20을 지원하는 Kotlin 플러그인은 다음 IDE에서 사용할 수 있습니다.

IDE	지원 버전
IntelliJ IDEA	2022.2.x, 2022.3.x, 2023.1.x
Android Studio	Flamingo (222)

Kotlin 아티팩트와 의존성을 올바르게 다운로드하려면 Gradle 설정을 구성하여 Maven Central 저장소를 사용하도록 해야 합니다.

새로운 Kotlin K2 컴파일러 업데이트

Kotlin 팀은 K2 컴파일러의 안정화 작업을 계속하고 있습니다. Kotlin 1.7.0 발표에서 언급했듯이, 여전히 알파(Alpha) 상태입니다. 이번 릴리스에서는 K2 베타(Beta)로 가는 길에 추가 개선 사항을 도입합니다.

1.8.20 릴리스부터 Kotlin K2 컴파일러는 다음 기능을 포함합니다.

직렬화(serialization) 플러그인의 프리뷰 버전이 있습니다.
JS IR 컴파일러에 대한 알파(Alpha) 지원을 제공합니다.
향후 릴리스될 새로운 언어 버전인 Kotlin 2.0을 소개합니다.

다음 비디오에서 새로운 컴파일러와 그 이점에 대해 자세히 알아보세요.

Kotlin K2 컴파일러 활성화 방법

Kotlin K2 컴파일러를 활성화하고 테스트하려면 다음 컴파일러 옵션과 함께 새 언어 버전을 사용하세요.

bash

-language-version 2.0

build.gradle(.kts) 파일에서 지정할 수 있습니다.

kotlin

kotlin {
   sourceSets.all {
       languageSettings {
           languageVersion = "2.0"
       }
   }
}

이전의 -Xuse-k2 컴파일러 옵션은 더 이상 사용되지 않습니다.

새로운 K2 컴파일러의 알파 버전은 JVM 및 JS IR 프로젝트에서만 작동합니다. Kotlin/Native 또는 다른 멀티플랫폼 프로젝트는 아직 지원하지 않습니다.

새로운 K2 컴파일러에 대한 피드백 남기기

피드백을 보내주시면 감사하겠습니다!

Kotlin Slack의 K2 개발자에게 직접 피드백을 제공하세요 – 초대 받기 및 #k2-early-adopters 채널에 참여하세요.
새로운 K2 컴파일러를 사용하면서 발생한 모든 문제는 이슈 트래커에 보고해 주세요.
JetBrains가 K2 사용에 대한 익명 데이터를 수집할 수 있도록 사용 통계 보내기 옵션을 활성화하세요.

언어

Kotlin이 계속 발전함에 따라, 1.8.20에서는 새로운 언어 기능의 프리뷰 버전을 소개합니다.

Enum 클래스 values 함수의 현대적이고 고성능 대체
데이터 클래스와의 대칭성을 위한 데이터 객체
인라인 클래스에서 본문(body)이 있는 보조 생성자에 대한 제한 해제 미리 보기

Enum 클래스 `values` 함수의 현대적이고 고성능 대체

이 기능은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다. 옵트인(opt-in)이 필요합니다(아래 세부 정보 참조). 평가 목적으로만 사용하세요. YouTrack을 통해 피드백을 주시면 감사하겠습니다.

Enum 클래스에는 정의된 enum 상수의 배열을 반환하는 합성(synthetic) values() 함수가 있습니다. 그러나 배열을 사용하면 Kotlin 및 Java에서 숨겨진 성능 문제가 발생할 수 있습니다. 또한 대부분의 API는 컬렉션을 사용하므로 결국 변환이 필요합니다. 이러한 문제를 해결하기 위해 values() 함수 대신 사용해야 하는 Enum 클래스용 entries 속성을 도입했습니다. entries 속성을 호출하면 미리 할당된 불변(immutable) enum 상수 목록을 반환합니다.

values() 함수는 여전히 지원되지만, 대신 entries 속성을 사용하는 것을 권장합니다.

kotlin

enum class Color(val colorName: String, val rgb: String) {
    RED("Red", "#FF0000"),
    ORANGE("Orange", "#FF7F00"),
    YELLOW("Yellow", "#FFFF00")
}

@OptIn(ExperimentalStdlibApi::class)
fun findByRgb(rgb: String): Color? = Color.entries.find { it.rgb == rgb }

`entries` 속성을 활성화하는 방법

이 기능을 사용해 보려면 @OptIn(ExperimentalStdlibApi)로 옵트인하고 -language-version 1.9 컴파일러 옵션을 활성화하세요. Gradle 프로젝트에서는 build.gradle(.kts) 파일에 다음을 추가하여 활성화할 수 있습니다.

KotlinGroovy

kotlin

tasks
    .withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask<*>>()
    .configureEach {
        compilerOptions
            .languageVersion
            .set(
                org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
            )
    }

groovy

tasks
    .withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask.class)
    .configureEach {
        compilerOptions.languageVersion =
            org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
    }

IntelliJ IDEA 2023.1부터는 이 기능을 옵트인한 경우, 적절한 IDE 검사가 values()에서 entries로의 변환을 알리고 빠른 수정(quick-fix)을 제공합니다.

제안에 대한 자세한 내용은 KEEP 노트를 참조하세요.

데이터 클래스와의 대칭성을 위한 데이터 객체 미리 보기

데이터 객체를 사용하면 싱글턴(singleton) 의미 체계와 깔끔한 toString() 표현을 가진 객체를 선언할 수 있습니다. 다음 코드 조각에서 data 키워드를 객체 선언에 추가하면 toString() 출력의 가독성이 어떻게 향상되는지 확인할 수 있습니다.

kotlin

package org.example
object MyObject
data object MyDataObject

fun main() {
    println(MyObject) // org.example.MyObject@1f32e575
    println(MyDataObject) // MyDataObject
}

특히 sealed 계층(예: sealed class 또는 sealed interface 계층)의 경우, data objects는 data class 선언과 함께 편리하게 사용될 수 있기 때문에 매우 적합합니다. 이 코드 조각에서 EndOfFile을 일반 object 대신 data object로 선언하면 수동으로 오버라이드할 필요 없이 깔끔한 toString을 얻을 수 있습니다. 이는 동반하는 데이터 클래스 정의와의 대칭성을 유지합니다.

kotlin

sealed interface ReadResult
data class Number(val number: Int) : ReadResult
data class Text(val text: String) : ReadResult
data object EndOfFile : ReadResult

fun main() {
    println(Number(7)) // Number(number=7)
    println(EndOfFile) // EndOfFile
}

데이터 객체의 의미 체계

Kotlin 1.7.20의 첫 번째 프리뷰 버전 이후, 데이터 객체의 의미 체계가 개선되었습니다. 컴파일러는 이제 자동으로 다음과 같은 편리한 함수들을 생성합니다.

toString

데이터 객체의 toString() 함수는 객체의 간단한 이름을 반환합니다.

kotlin

data object MyDataObject {
    val x: Int = 3
}

fun main() {
    println(MyDataObject) // MyDataObject
}

equals 및 hashCode

data object의 equals() 함수는 data object 타입을 가진 모든 객체가 동일하다고 간주되도록 보장합니다. 대부분의 경우, 런타임에는 데이터 객체의 단일 인스턴스만 존재할 것입니다(결국 data object는 싱글턴을 선언합니다). 그러나 동일한 타입의 다른 객체가 런타임에 생성되는 예외적인 경우(예: java.lang.reflect를 통한 플랫폼 리플렉션, 또는 이 API를 내부적으로 사용하는 JVM 직렬화 라이브러리를 통해)에는 객체가 동일하게 처리되도록 보장합니다.

data object는 구조적으로(== 연산자를 사용하여)만 비교하고, 참조적으로(=== 연산자)는 절대 비교하지 마세요. 이는 런타임에 데이터 객체의 인스턴스가 두 개 이상 존재할 때 발생할 수 있는 함정을 피하는 데 도움이 됩니다. 다음 코드 조각은 이 특정 예외적인 경우를 보여줍니다.

kotlin

import java.lang.reflect.Constructor

data object MySingleton

fun main() {
    val evilTwin = createInstanceViaReflection()

    println(MySingleton) // MySingleton
    println(evilTwin) // MySingleton

    // 라이브러리가 MySingleton의 두 번째 인스턴스를 강제로 생성하더라도, `equals` 메서드는 true를 반환합니다.
    println(MySingleton == evilTwin) // true

    // data object를 === 로 비교하지 마세요.
    println(MySingleton === evilTwin) // false
}

fun createInstanceViaReflection(): MySingleton {
    // Kotlin 리플렉션은 data object의 인스턴스화를 허용하지 않습니다.
    // 이것은 "강제로"(즉, Java 플랫폼 리플렉션) 새로운 MySingleton 인스턴스를 생성합니다.
    // 직접 시도하지 마세요!
    return (MySingleton.javaClass.declaredConstructors[0].apply { isAccessible = true } as Constructor<MySingleton>).newInstance()
}

생성된 hashCode() 함수의 동작은 equals() 함수의 동작과 일관되므로, data object의 모든 런타임 인스턴스는 동일한 해시 코드를 가집니다.

데이터 객체에 대한 `copy` 및 `componentN` 함수 없음

data object와 data class 선언은 종종 함께 사용되며 일부 유사점이 있지만, data object에 대해서는 생성되지 않는 함수들이 있습니다.

data object 선언은 싱글턴 객체로 사용되도록 의도되었으므로 copy() 함수는 생성되지 않습니다. 싱글턴 패턴은 클래스의 인스턴스화를 단일 인스턴스로 제한하며, 인스턴스 복사본 생성을 허용하는 것은 해당 제한을 위반할 것입니다.

또한 data class와 달리 data object에는 데이터 속성이 없습니다. 이러한 객체를 비구조화(destructure)하려는 시도는 의미가 없으므로 componentN() 함수는 생성되지 않습니다.

이 기능에 대한 여러분의 피드백을 YouTrack으로 보내주시면 감사하겠습니다.

데이터 객체 미리 보기를 활성화하는 방법

이 기능을 사용해 보려면 -language-version 1.9 컴파일러 옵션을 활성화하세요. Gradle 프로젝트에서는 build.gradle(.kts) 파일에 다음을 추가하여 활성화할 수 있습니다.

KotlinGroovy

kotlin

tasks
    .withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask<*>>()
    .configureEach {
        compilerOptions
            .languageVersion
            .set(
                org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
            )
    }

groovy

tasks
    .withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask.class)
    .configureEach {
        compilerOptions.languageVersion =
            org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
    }

인라인 클래스에서 본문이 있는 보조 생성자에 대한 제한 해제 미리 보기

이 기능은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다. 옵트인(opt-in)이 필요합니다(아래 세부 정보 참조). 평가 목적으로만 사용하세요. YouTrack을 통해 피드백을 주시면 감사하겠습니다.

Kotlin 1.8.20은 인라인 클래스에서 본문(body)이 있는 보조 생성자 사용에 대한 제한을 해제합니다.

기존 인라인 클래스는 명확한 초기화 의미 체계를 위해 init 블록이나 보조 생성자 없이 공개 주 생성자만 허용했습니다. 결과적으로, 기본 값을 캡슐화하거나 제약이 있는 값을 나타내는 인라인 클래스를 생성하는 것이 불가능했습니다.

이러한 문제는 Kotlin 1.4.30에서 init 블록에 대한 제한이 해제되면서 해결되었습니다. 이제 한 단계 더 나아가 프리뷰 모드에서 본문이 있는 보조 생성자를 허용합니다.

kotlin

@JvmInline
value class Person(private val fullName: String) {
    // Kotlin 1.4.30부터 허용:
    init { 
        check(fullName.isNotBlank()) {
            "Full name shouldn't be empty"
        }
    }

    // Kotlin 1.8.20부터 프리뷰 가능:
    constructor(name: String, lastName: String) : this("$name $lastName") {
        check(lastName.isNotBlank()) {
            "Last name shouldn't be empty"
        }
    }
}

본문이 있는 보조 생성자를 활성화하는 방법

KotlinGroovy

kotlin

tasks
    .withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask<*>>()
    .configureEach {
        compilerOptions
            .languageVersion
            .set(
                org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
            )
    }

groovy

tasks
    .withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask.class)
    .configureEach {
        compilerOptions.languageVersion =
            org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
    }

이 기능을 사용해 보시고 YouTrack에 모든 보고서를 제출하여 Kotlin 1.9.0에서 이 기능을 기본값으로 만드는 데 도움을 주시기를 권장합니다.

Kotlin 인라인 클래스의 개발에 대한 자세한 내용은 이 KEEP을 참조하세요.

새로운 Kotlin/Wasm 타겟

Kotlin/Wasm (Kotlin WebAssembly)은 이번 릴리스에서 실험적으로 전환됩니다. Kotlin 팀은 WebAssembly가 유망한 기술이라고 생각하며, 이를 통해 Kotlin의 모든 이점을 활용할 수 있는 더 나은 방법을 찾고자 합니다.

WebAssembly 이진 형식은 자체 가상 머신을 사용하여 실행되므로 플랫폼에 독립적입니다. 거의 모든 최신 브라우저가 이미 WebAssembly 1.0을 지원합니다. WebAssembly를 실행하기 위한 환경을 설정하려면 Kotlin/Wasm 타겟이 사용하는 실험적 가비지 컬렉션 모드를 활성화하기만 하면 됩니다. 자세한 지침은 Kotlin/Wasm 활성화 방법에서 찾을 수 있습니다.

새로운 Kotlin/Wasm 타겟의 다음과 같은 장점을 강조하고자 합니다.

Kotlin/Wasm은 LLVM을 사용할 필요가 없으므로 wasm32 Kotlin/Native 타겟에 비해 컴파일 속도가 더 빠릅니다.
Wasm 가비지 컬렉션 덕분에 wasm32 타겟에 비해 JS와의 상호 운용성 및 브라우저 통합이 더 쉽습니다.
Wasm은 압축되고 파싱하기 쉬운 바이트코드를 가지고 있어 Kotlin/JS 및 JavaScript에 비해 애플리케이션 시작이 잠재적으로 더 빠릅니다.
Wasm은 정적 타입 언어이므로 Kotlin/JS 및 JavaScript에 비해 애플리케이션 런타임 성능이 향상됩니다.

1.8.20 릴리스부터 실험 프로젝트에서 Kotlin/Wasm을 사용할 수 있습니다. Kotlin 표준 라이브러리(stdlib)와 테스트 라이브러리(kotlin.test)를 Kotlin/Wasm용으로 즉시 제공합니다. IDE 지원은 향후 릴리스에서 추가될 예정입니다.

이 YouTube 비디오에서 Kotlin/Wasm에 대해 자세히 알아보세요.

Kotlin/Wasm 활성화 방법

Kotlin/Wasm을 활성화하고 테스트하려면 build.gradle.kts 파일을 업데이트하세요.

kotlin

plugins {
    kotlin("multiplatform") version "1.8.20"
}

kotlin {
    wasm {
        binaries.executable()
        browser {
        }
    }
    sourceSets {
        val commonMain by getting
        val commonTest by getting {
            dependencies {
                implementation(kotlin("test"))
            }
        }
        val wasmMain by getting
        val wasmTest by getting
    }
}

Kotlin/Wasm 예제 GitHub 저장소를 확인하세요.

Kotlin/Wasm 프로젝트를 실행하려면 타겟 환경의 설정을 업데이트해야 합니다.

ChromeFirefoxEdge

버전 109의 경우:
--js-flags=--experimental-wasm-gc 명령줄 인수를 사용하여 애플리케이션을 실행합니다.
버전 110 이상:
1. 브라우저에서 chrome://flags/#enable-webassembly-garbage-collection으로 이동합니다.
2. WebAssembly Garbage Collection을 활성화합니다.
3. 브라우저를 다시 시작합니다.

버전 109 이상:

브라우저에서 about:config로 이동합니다.
javascript.options.wasm_function_references 및 javascript.options.wasm_gc 옵션을 활성화합니다.
브라우저를 다시 시작합니다.

버전 109 이상:

--js-flags=--experimental-wasm-gc 명령줄 인수를 사용하여 애플리케이션을 실행합니다.

Kotlin/Wasm에 대한 피드백 남기기

피드백을 보내주시면 감사하겠습니다!

Kotlin Slack의 개발자에게 직접 피드백을 제공하세요 – 초대 받기 및 #webassembly 채널에 참여하세요.
Kotlin/Wasm을 사용하면서 발생한 모든 문제는 이 YouTrack 이슈에 보고해 주세요.

Kotlin/JVM

Kotlin 1.8.20은 Java 합성(synthetic) 속성 참조 미리 보기 및 kapt 스텁(stub) 생성 태스크에서 JVM IR 백엔드 기본 지원을 도입합니다.

Java 합성 속성 참조 미리 보기

이 기능은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다. 평가 목적으로만 사용하세요. YouTrack을 통해 피드백을 주시면 감사하겠습니다.

Kotlin 1.8.20은 Java 합성 속성에 대한 참조를 생성하는 기능을 도입합니다. 예를 들어, 다음 Java 코드와 같습니다.

java

public class Person {
    private String name;
    private int age;

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public int getAge() {
        return age;
    }
}

Kotlin은 항상 age가 합성 속성인 person.age를 작성할 수 있도록 허용했습니다. 이제 Person::age 및 person::age에 대한 참조도 생성할 수 있습니다. name에 대해서도 동일하게 작동합니다.

kotlin

val persons = listOf(Person("Jack", 11), Person("Sofie", 12), Person("Peter", 11))
    persons
        // Java 합성 속성 참조 호출:
        .sortedBy(Person::age)
        // Kotlin 속성 구문을 통해 Java getter 호출:
        .forEach { person -> println(person.name) }

Java 합성 속성 참조를 활성화하는 방법

KotlinGroovy

kotlin

tasks
    .withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask<*>>()
    .configureEach {
        compilerOptions
            .languageVersion
            .set(
                org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
            )
    }

groovy

tasks
    .withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask.class)
    .configureEach {
        compilerOptions.languageVersion =
            org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
    }

kapt 스텁 생성 태스크에서 JVM IR 백엔드 기본 지원

Kotlin 1.7.20에서 우리는 kapt 스텁 생성 태스크에서 JVM IR 백엔드 지원을 도입했습니다. 이번 릴리스부터는 이 지원이 기본적으로 작동합니다. 더 이상 gradle.properties에 kapt.use.jvm.ir=true를 지정하여 활성화할 필요가 없습니다. 이 기능에 대한 여러분의 피드백을 YouTrack으로 보내주시면 감사하겠습니다.

Kotlin/Native

Kotlin 1.8.20에는 Kotlin/Native 타겟 지원 변경 사항, Objective-C와의 상호 운용성, CocoaPods Gradle 플러그인 개선 사항 등 다양한 업데이트가 포함되어 있습니다.

Kotlin/Native 타겟 업데이트
레거시 메모리 관리자 지원 중단
@import 지시어를 사용하는 Objective-C 헤더 지원
Cocoapods Gradle 플러그인에서 링크 전용 모드 지원
UIKit에서 Objective-C 확장을 클래스 멤버로 임포트
컴파일러에서 컴파일러 캐시 관리 재구현
Cocoapods Gradle 플러그인에서 useLibraries() 지원 중단

Kotlin/Native 타겟 업데이트

Kotlin 팀은 Kotlin/Native에서 지원하는 타겟 목록을 재검토하고, 이를 티어(tier)로 분할하고, Kotlin 1.8.20부터 일부 타겟에 대한 지원을 중단하기로 결정했습니다. 지원 및 지원 중단 예정 타겟의 전체 목록은 Kotlin/Native 타겟 지원 섹션을 참조하세요.

다음 타겟은 Kotlin 1.8.20에서 지원 중단 예정이며 1.9.20에서 제거될 예정입니다.

iosArm32
watchosX86
wasm32
mingwX86
linuxArm32Hfp
linuxMips32
linuxMipsel32

나머지 타겟의 경우, 이제 Kotlin/Native 컴파일러에서 타겟이 얼마나 잘 지원되고 테스트되는지에 따라 세 가지 지원 티어가 있습니다. 타겟은 다른 티어로 이동할 수 있습니다. 예를 들어, Kotlin Multiplatform에 중요하므로 향후 iosArm64에 대한 완전한 지원을 제공하기 위해 최선을 다할 것입니다.

라이브러리 작성자라면 이러한 타겟 티어가 CI 도구에서 어떤 타겟을 테스트하고 어떤 타겟을 건너뛸지 결정하는 데 도움이 될 수 있습니다. Kotlin 팀은 kotlinx.coroutines와 같은 공식 Kotlin 라이브러리를 개발할 때 동일한 접근 방식을 사용할 것입니다.

이러한 변경 사항의 이유에 대해 자세히 알아보려면 블로그 게시물을 확인하세요.

레거시 메모리 관리자 지원 중단

1.8.20부터 레거시 메모리 관리자는 더 이상 사용되지 않으며 1.9.20에서 제거될 예정입니다. 새로운 메모리 관리자는 1.7.20부터 기본적으로 활성화되었으며, 추가적인 안정성 업데이트 및 성능 개선이 이루어지고 있습니다.

여전히 레거시 메모리 관리자를 사용하고 있다면, gradle.properties에서 kotlin.native.binary.memoryModel=strict 옵션을 제거하고 마이그레이션 가이드에 따라 필요한 변경 사항을 적용하세요.

새로운 메모리 관리자는 wasm32 타겟을 지원하지 않습니다. 이 타겟은 이번 릴리스부터 지원 중단 예정이며 1.9.20에서 제거될 예정입니다.

`@import` 지시어를 사용하는 Objective-C 헤더 지원

이 기능은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다. 옵트인(opt-in)이 필요합니다(아래 세부 정보 참조). 평가 목적으로만 사용하세요. YouTrack을 통해 피드백을 주시면 감사하겠습니다.

Kotlin/Native는 이제 @import 지시어를 사용하는 Objective-C 헤더를 임포트할 수 있습니다. 이 기능은 자동 생성된 Objective-C 헤더를 가진 Swift 라이브러리나 Swift로 작성된 CocoaPods 의존성 클래스를 사용할 때 유용합니다.

이전에는 cinterop 도구가 -fmodules 옵션에 대한 지원이 부족했기 때문에 @import 지시어를 통해 Objective-C 모듈에 의존하는 헤더를 분석하지 못했습니다.

Kotlin 1.8.20부터 @import를 사용하여 Objective-C 헤더를 사용할 수 있습니다. 이를 위해 정의 파일에서 compilerOpts로 -fmodules 옵션을 컴파일러에 전달하세요. CocoaPods 통합을 사용하는 경우, pod() 함수의 구성 블록에서 cinterop 옵션을 다음과 같이 지정하세요.

kotlin

kotlin {
    ios()

    cocoapods {
        summary = "CocoaPods test library"
        homepage = "https://github.com/JetBrains/kotlin"

        ios.deploymentTarget = "13.5"

        pod("PodName") {
            extraOpts = listOf("-compiler-option", "-fmodules")
        }
    }
}

이것은 매우 기대되었던 기능이며, 향후 릴리스에서 이 기능을 기본값으로 만드는 데 도움이 되도록 YouTrack에 대한 여러분의 피드백을 환영합니다.

Cocoapods Gradle 플러그인에서 링크 전용 모드 지원

Kotlin 1.8.20부터 동적 프레임워크와 함께 Pod 의존성을 링크에만 사용하고 cinterop 바인딩을 생성하지 않을 수 있습니다. 이는 cinterop 바인딩이 이미 생성된 경우에 유용할 수 있습니다.

라이브러리와 앱이라는 두 개의 모듈이 있는 프로젝트를 고려해 보세요. 라이브러리는 Pod에 의존하지만 프레임워크를 생성하지 않고 .klib만 생성합니다. 앱은 라이브러리에 의존하고 동적 프레임워크를 생성합니다. 이 경우, 이 프레임워크를 라이브러리가 의존하는 Pod와 연결해야 하지만, 라이브러리에 대해 cinterop 바인딩이 이미 생성되었으므로 cinterop 바인딩이 필요하지 않습니다.

이 기능을 활성화하려면 Pod에 대한 의존성을 추가할 때 linkOnly 옵션 또는 빌더 속성을 사용하세요.

kotlin

cocoapods {
    summary = "CocoaPods test library"
    homepage = "https://github.com/JetBrains/kotlin"

    pod("Alamofire", linkOnly = true) {
        version = "5.7.0"
    }
}

이 옵션을 정적 프레임워크와 함께 사용하면 Pod가 정적 프레임워크 링크에 사용되지 않으므로 Pod 의존성이 완전히 제거됩니다.

UIKit에서 Objective-C 확장을 클래스 멤버로 임포트

Xcode 14.1부터 일부 Objective-C 클래스의 메서드가 카테고리 멤버로 이동되었습니다. 이로 인해 다른 Kotlin API가 생성되었고, 이 메서드들은 메서드 대신 Kotlin 확장으로 임포트되었습니다.

이로 인해 UIKit을 사용하여 메서드를 오버라이드할 때 문제가 발생했을 수 있습니다. 예를 들어, Kotlin에서 UIVIew를 서브클래싱할 때 drawRect() 또는 layoutSubviews() 메서드를 오버라이드하는 것이 불가능해졌습니다.

1.8.20부터 NSView 및 UIView 클래스와 동일한 헤더에 선언된 카테고리 멤버는 이 클래스들의 멤버로 임포트됩니다. 이는 NSView 및 UIView에서 서브클래싱된 메서드가 다른 메서드와 마찬가지로 쉽게 오버라이드될 수 있음을 의미합니다.

모든 것이 잘 진행된다면, 모든 Objective-C 클래스에 대해 이 동작을 기본적으로 활성화할 계획입니다.

컴파일러에서 컴파일러 캐시 관리 재구현

컴파일러 캐시의 발전을 가속화하기 위해 컴파일러 캐시 관리를 Kotlin Gradle 플러그인에서 Kotlin/Native 컴파일러로 이동했습니다. 이는 컴파일 시간 및 컴파일러 캐시 유연성 개선을 포함한 여러 중요한 개선 작업의 장애물을 제거합니다.

문제가 발생하여 이전 동작으로 돌아가야 하는 경우, kotlin.native.cacheOrchestration=gradle Gradle 속성을 사용하세요.

YouTrack에서 이에 대한 피드백을 주시면 감사하겠습니다.

Cocoapods Gradle 플러그인에서 `useLibraries()` 지원 중단

Kotlin 1.8.20은 정적 라이브러리용 CocoaPods 통합에 사용되는 useLibraries() 함수의 지원 중단 주기를 시작합니다.

우리는 정적 라이브러리를 포함하는 Pod에 대한 의존성을 허용하기 위해 useLibraries() 함수를 도입했습니다. 시간이 지남에 따라 이 경우는 매우 드물어졌습니다. 대부분의 Pod는 소스로 배포되며, Objective-C 프레임워크 또는 XCFramework는 이진 배포에 일반적인 선택입니다.

이 함수가 인기가 없으며 Kotlin CocoaPods Gradle 플러그인 개발을 복잡하게 만드는 문제를 발생시키므로, 지원을 중단하기로 결정했습니다.

프레임워크 및 XCFrameworks에 대한 자세한 내용은 최종 네이티브 이진 파일 빌드를 참조하세요.

Kotlin Multiplatform

Kotlin 1.8.20은 Kotlin Multiplatform에 대한 다음 업데이트를 통해 개발자 경험을 개선하고자 합니다.

소스 세트 계층 설정의 새로운 접근 방식
Kotlin Multiplatform에서 Gradle 컴포짓 빌드 지원 미리 보기
Xcode에서 Gradle 오류 출력 개선

소스 세트 계층 설정의 새로운 접근 방식

소스 세트 계층에 대한 새로운 접근 방식은 실험적입니다. 향후 Kotlin 릴리스에서 사전 통지 없이 변경될 수 있습니다. 옵트인(opt-in)이 필요합니다(아래 세부 정보 참조). YouTrack을 통해 피드백을 주시면 감사하겠습니다.

Kotlin 1.8.20은 멀티플랫폼 프로젝트에서 소스 세트 계층을 설정하는 새로운 방법인 기본 타겟 계층을 제공합니다. 이 새로운 접근 방식은 설계상의 결함이 있는 ios와 같은 타겟 바로가기(shortcut)를 대체하기 위한 것입니다.

기본 타겟 계층의 아이디어는 간단합니다. 프로젝트가 컴파일되는 모든 타겟을 명시적으로 선언하면 Kotlin Gradle 플러그인이 지정된 타겟을 기반으로 공유 소스 세트를 자동으로 생성합니다.

프로젝트 설정

간단한 멀티플랫폼 모바일 앱의 다음 예시를 고려해 보세요.

kotlin

@OptIn(ExperimentalKotlinGradlePluginApi::class)
kotlin {
    // 기본 타겟 계층 활성화:
    targetHierarchy.default()

    android()
    iosArm64()
    iosSimulatorArm64()
}

기본 타겟 계층을 모든 가능한 타겟과 그 공유 소스 세트에 대한 템플릿으로 생각할 수 있습니다. 코드에서 최종 타겟인 android, iosArm64, iosSimulatorArm64를 선언하면 Kotlin Gradle 플러그인이 템플릿에서 적합한 공유 소스 세트를 찾아 생성해 줍니다. 결과 계층은 다음과 같습니다.

기본 타겟 계층 사용 예시

녹색 소스 세트는 실제로 프로젝트에 생성되어 존재하며, 기본 템플릿의 회색 소스 세트는 무시됩니다. 보시다시피, Kotlin Gradle 플러그인은 예를 들어 watchos 타겟이 프로젝트에 없으므로 watchos 소스 세트를 생성하지 않았습니다.

watchosArm64와 같은 watchOS 타겟을 추가하면 watchos 소스 세트가 생성되고 apple, native, common 소스 세트의 코드가 watchosArm64로도 컴파일됩니다.

기본 타겟 계층에 대한 완전한 스키마는 문서에서 찾을 수 있습니다.

이 예시에서 apple 및 native 소스 세트는 iosArm64 및 iosSimulatorArm64 타겟으로만 컴파일됩니다. 따라서 이름에도 불구하고 전체 iOS API에 접근할 수 있습니다. 이는 native와 같은 소스 세트의 경우 직관적이지 않을 수 있습니다. 이 소스 세트에서는 모든 네이티브 타겟에서 사용 가능한 API만 접근할 수 있을 것으로 예상할 수 있기 때문입니다. 이 동작은 향후 변경될 수 있습니다.

바로가기를 대체하는 이유

소스 세트 계층을 생성하는 것은 장황하고 오류가 발생하기 쉬우며 초보자에게는 불친절할 수 있습니다. 이전 솔루션은 계층의 일부를 생성하는 ios와 같은 바로가기를 도입하는 것이었습니다. 그러나 바로가기를 사용해 본 결과 큰 설계상의 결함이 있음이 입증되었습니다. 바로가기는 변경하기 어렵습니다.

예를 들어 ios 바로가기는 iosArm64 및 iosX64 타겟만 생성하는데, 이는 혼란을 줄 수 있고 iosSimulatorArm64 타겟도 필요한 M1 기반 호스트에서 작업할 때 문제를 일으킬 수 있습니다. 그러나 iosSimulatorArm64 타겟을 추가하는 것은 사용자 프로젝트에 매우 혼란스러운 변경이 될 수 있습니다.

iosMain 소스 세트에서 사용되는 모든 의존성은 iosSimulatorArm64 타겟을 지원해야 합니다. 그렇지 않으면 의존성 해결이 실패합니다.
iosMain에서 사용되는 일부 네이티브 API는 새 타겟을 추가할 때 사라질 수 있습니다(물론 iosSimulatorArm64의 경우에는 그럴 가능성이 낮습니다).
Intel 기반 MacBook에서 작은 토이 프로젝트를 작성하는 경우와 같이, 이 변경 사항이 필요하지 않을 수도 있습니다.

바로가기가 계층 구성 문제를 해결하지 못한다는 것이 명확해졌고, 그래서 우리는 어느 시점부터 새로운 바로가기 추가를 중단했습니다.

기본 타겟 계층은 언뜻 바로가기와 비슷하게 보일 수 있지만, 중요한 차이점이 있습니다. 사용자는 타겟 집합을 명시적으로 지정해야 합니다. 이 집합은 프로젝트가 어떻게 컴파일되고 게시되며 의존성 해결에 어떻게 참여하는지를 정의합니다. 이 집합이 고정되어 있으므로 Kotlin Gradle 플러그인의 기본 구성 변경은 생태계에 훨씬 적은 혼란을 야기해야 하며, 도구 지원 마이그레이션을 제공하는 것이 훨씬 쉬울 것입니다.

기본 계층을 활성화하는 방법

이 새로운 기능은 실험적입니다. Kotlin Gradle 빌드 스크립트의 경우 @OptIn(ExperimentalKotlinGradlePluginApi::class)로 옵트인해야 합니다.

자세한 내용은 계층적 프로젝트 구조를 참조하세요.

피드백 남기기

이는 멀티플랫폼 프로젝트에 대한 중요한 변경 사항입니다. 더 나은 기능을 만들 수 있도록 피드백을 주시면 감사하겠습니다.

Kotlin Multiplatform에서 Gradle 컴포짓 빌드 지원 미리 보기

이 기능은 Kotlin Gradle 플러그인 1.8.20부터 Gradle 빌드에서 지원됩니다. IDE 지원의 경우, IntelliJ IDEA 2023.1 Beta 2 (231.8109.2) 이상 및 모든 Kotlin IDE 플러그인과 함께 Kotlin Gradle 플러그인 1.8.20을 사용하세요.

1.8.20부터 Kotlin Multiplatform은 Gradle 컴포짓 빌드를 지원합니다. 컴포짓 빌드를 사용하면 별도의 프로젝트 빌드 또는 동일한 프로젝트의 일부를 단일 빌드에 포함할 수 있습니다.

일부 기술적인 문제로 인해 Kotlin Multiplatform에서 Gradle 컴포짓 빌드를 사용하는 것은 부분적으로만 지원되었습니다. Kotlin 1.8.20은 더 다양한 프로젝트에서 작동해야 하는 개선된 지원 미리 보기를 포함합니다. 이를 시도하려면 gradle.properties에 다음 옵션을 추가하세요.

none

kotlin.mpp.import.enableKgpDependencyResolution=true

이 옵션은 새로운 임포트 모드의 미리 보기를 활성화합니다. 컴포짓 빌드 지원 외에도, 주요 버그 수정 및 임포트 안정성을 위한 개선 사항이 포함되어 있어 멀티플랫폼 프로젝트에서 더 원활한 임포트 경험을 제공합니다.

알려진 문제

여전히 안정화가 필요한 미리 보기 버전이며, 그 과정에서 임포트 관련 문제가 발생할 수 있습니다. 다음은 Kotlin 1.8.20 최종 릴리스 전에 해결할 계획인 몇 가지 알려진 문제입니다.

IntelliJ IDEA 2023.1 EAP용 Kotlin 1.8.20 플러그인은 아직 사용할 수 없습니다. 그럼에도 불구하고, 이 IDE에서 Kotlin Gradle 플러그인 버전을 1.8.20으로 설정하고 컴포짓 빌드를 시도할 수 있습니다.
프로젝트에 rootProject.name이 지정된 빌드가 포함된 경우, 컴포짓 빌드가 Kotlin 메타데이터를 해결하지 못할 수 있습니다. 해결 방법 및 자세한 내용은 이 Youtrack 이슈를 참조하세요.

이를 시도해 보시고 YouTrack에 모든 보고서를 제출하여 Kotlin 1.9.0에서 기본값으로 만드는 데 도움을 주시기를 권장합니다.

Xcode에서 Gradle 오류 출력 개선

Xcode에서 멀티플랫폼 프로젝트를 빌드하는 데 문제가 있었다면 "Command PhaseScriptExecution failed with a nonzero exit code" 오류가 발생했을 수 있습니다. 이 메시지는 Gradle 호출이 실패했음을 알리지만, 문제를 감지하는 데는 그다지 도움이 되지 않습니다.

Kotlin 1.8.20부터 Xcode는 Kotlin/Native 컴파일러의 출력을 파싱할 수 있습니다. 또한 Gradle 빌드가 실패할 경우, Xcode에서 근본 원인 예외(root cause exception)로 인한 추가 오류 메시지를 볼 수 있습니다. 대부분의 경우, 이는 근본적인 문제를 식별하는 데 도움이 될 것입니다.

Xcode에서 Gradle 오류 출력 개선

새로운 동작은 Xcode 통합을 위한 표준 Gradle 태스크(예: 멀티플랫폼 프로젝트의 iOS 프레임워크를 Xcode의 iOS 애플리케이션에 연결할 수 있는 embedAndSignAppleFrameworkForXcode)에 대해 기본적으로 활성화됩니다. 또한 kotlin.native.useXcodeMessageStyle Gradle 속성을 사용하여 활성화(또는 비활성화)할 수 있습니다.

Kotlin/JavaScript

Kotlin 1.8.20은 TypeScript 정의를 생성하는 방식을 변경합니다. 또한 디버깅 경험을 개선하기 위해 설계된 변경 사항도 포함됩니다.

Gradle 플러그인에서 Dukat 통합 제거
소스 맵의 Kotlin 변수 및 함수 이름
TypeScript 정의 파일 생성에 대한 옵트인

Gradle 플러그인에서 Dukat 통합 제거

Kotlin 1.8.20에서 우리는 Kotlin/JavaScript Gradle 플러그인에서 실험적 Dukat 통합을 제거했습니다. Dukat 통합은 TypeScript 선언 파일(.d.ts)을 Kotlin 외부 선언으로 자동 변환하는 것을 지원했습니다.

Dukat 도구를 대신 사용하여 TypeScript 선언 파일(.d.ts)을 Kotlin 외부 선언으로 계속 변환할 수 있습니다.

Dukat 도구는 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다.

소스 맵의 Kotlin 변수 및 함수 이름

디버깅을 돕기 위해, 변수 및 함수에 대해 Kotlin 코드에서 선언한 이름을 소스 맵에 추가하는 기능을 도입했습니다. 1.8.20 이전에는 이러한 이름이 소스 맵에서 사용할 수 없었으므로 디버거에서는 항상 생성된 JavaScript의 변수 및 함수 이름을 보았습니다.

build.gradle.kts 파일에서 sourceMapNamesPolicy를 사용하거나 -source-map-names-policy 컴파일러 옵션을 사용하여 추가되는 내용을 구성할 수 있습니다. 아래 표는 가능한 설정을 나열합니다.

설정	설명	예시 출력
`simple-names`	변수 이름과 간단한 함수 이름이 추가됩니다. (기본값)	`main`
`fully-qualified-names`	변수 이름과 완전한 자격의 함수 이름이 추가됩니다.	`com.example.kjs.playground.main`
`no`	변수 또는 함수 이름이 추가되지 않습니다.	N/A

build.gradle.kts 파일의 예시 구성은 다음과 같습니다.

kotlin

tasks.withType<org.jetbrains.kotlin.gradle.tasks.Kotlin2JsCompile>().configureEach {
    compilercompileOptions.sourceMapNamesPolicy.set(org.jetbrains.kotlin.gradle.dsl.JsSourceMapNamesPolicy.SOURCE_MAP_NAMES_POLICY_FQ_NAMES) // or SOURCE_MAP_NAMES_POLICY_NO, or SOURCE_MAP_NAMES_POLICY_SIMPLE_NAMES
}

Chromium 기반 브라우저에서 제공하는 것과 같은 디버깅 도구는 소스 맵에서 원본 Kotlin 이름을 가져와 스택 트레이스의 가독성을 향상시킬 수 있습니다. 즐거운 디버깅 되세요!

소스 맵에 변수 및 함수 이름 추가 기능은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다.

TypeScript 정의 파일 생성에 대한 옵트인

이전에는 실행 파일을 생성하는 프로젝트(binaries.executable())가 있는 경우, Kotlin/JS IR 컴파일러가 @JsExport로 표시된 모든 최상위 선언을 수집하여 .d.ts 파일에 TypeScript 정의를 자동으로 생성했습니다.

모든 프로젝트에 유용한 것은 아니므로 Kotlin 1.8.20에서는 이 동작을 변경했습니다. TypeScript 정의를 생성하려면 Gradle 빌드 파일에서 명시적으로 구성해야 합니다. js 섹션의 build.gradle.kts.file에 generateTypeScriptDefinitions()를 추가하세요. 예를 들어:

kotlin

kotlin {
    js {
        binaries.executable()
        browser {
        }
        generateTypeScriptDefinitions()
    }
}

TypeScript 정의(.d.ts) 생성은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다.

Gradle

Kotlin 1.8.20은 멀티플랫폼 플러그인의 일부 특수 케이스를 제외하고 Gradle 6.8부터 7.6까지 완벽하게 호환됩니다. 최신 Gradle 릴리스 버전까지도 사용할 수 있지만, 그렇게 할 경우 지원 중단 경고가 발생하거나 일부 새로운 Gradle 기능이 작동하지 않을 수 있다는 점을 유의해야 합니다.

이번 버전에는 다음과 같은 변경 사항이 있습니다.

새로운 Gradle 플러그인 버전 정렬
Gradle에서 기본적으로 새로운 JVM 증분 컴파일
컴파일 태스크 출력의 정밀 백업
모든 Gradle 버전에 대한 지연 Kotlin/JVM 태스크 생성
컴파일 태스크의 destinationDirectory 비기본 위치
HTTP 통계 서비스에 컴파일러 인수를 보고하지 않는 옵트아웃 기능

새로운 Gradle 플러그인 버전 정렬

Gradle은 함께 작동해야 하는 의존성이 항상 버전이 정렬되도록 하는 방법을 제공합니다. Kotlin 1.8.20도 이 접근 방식을 채택했습니다. 기본적으로 작동하므로 활성화하기 위해 구성을 변경하거나 업데이트할 필요가 없습니다. 또한 Kotlin Gradle 플러그인의 전이적 의존성 해결을 위한 이 해결 방법에 더 이상 의존할 필요가 없습니다.

YouTrack에서 이 기능에 대한 여러분의 피드백을 주시면 감사하겠습니다.

Gradle에서 기본적으로 새로운 JVM 증분 컴파일

Kotlin 1.7.0부터 사용 가능했던 증분 컴파일에 대한 새로운 접근 방식이 이제 기본적으로 작동합니다. 더 이상 활성화하기 위해 gradle.properties에 kotlin.incremental.useClasspathSnapshot=true를 지정할 필요가 없습니다.

이에 대한 여러분의 피드백을 주시면 감사하겠습니다. YouTrack에 이슈를 제기할 수 있습니다.

컴파일 태스크 출력의 정밀 백업

컴파일 태스크 출력의 정밀 백업은 실험적입니다. 사용하려면 gradle.properties에 kotlin.compiler.preciseCompilationResultsBackup=true를 추가하세요. YouTrack을 통해 피드백을 주시면 감사하겠습니다.

Kotlin 1.8.20부터 정밀 백업을 활성화할 수 있습니다. 이 기능은 증분 컴파일에서 Kotlin이 다시 컴파일하는 클래스만 백업합니다. 완전 백업과 정밀 백업 모두 컴파일 오류 후 빌드를 증분적으로 다시 실행하는 데 도움이 됩니다. 정밀 백업은 완전 백업에 비해 빌드 시간을 절약합니다. 완전 백업은 특히 큰 프로젝트에서 또는 많은 태스크가 백업을 수행할 때, 그리고 프로젝트가 느린 HDD에 있는 경우 상당한 빌드 시간을 소요할 수 있습니다.

이 최적화는 실험적입니다. gradle.properties 파일에 kotlin.compiler.preciseCompilationResultsBackup Gradle 속성을 추가하여 활성화할 수 있습니다.

none

kotlin.compiler.preciseCompilationResultsBackup=true

JetBrains에서 정밀 백업 사용 예시

다음 차트에서 완전 백업과 비교한 정밀 백업 사용 예시를 확인할 수 있습니다.

완전 백업과 정밀 백업 비교

첫 번째 및 두 번째 차트는 Kotlin 프로젝트에서 정밀 백업이 Kotlin Gradle 플러그인 빌드에 미치는 영향을 보여줍니다.

많은 모듈이 의존하는 모듈에 작은 ABI 변경(새로운 public 메서드 추가)을 적용한 후.
다른 모듈이 의존하지 않는 모듈에 작은 비-ABI 변경(private 함수 추가)을 적용한 후.

세 번째 차트는 많은 모듈이 의존하는 Kotlin/JS 모듈에 작은 비-ABI 변경(private 함수 추가)을 적용한 후 Space 프로젝트에서 웹 프론트엔드를 빌드하는 데 정밀 백업이 미치는 영향을 보여줍니다.

이 측정은 Apple M1 Max CPU가 장착된 컴퓨터에서 수행되었으며, 컴퓨터마다 약간 다른 결과가 나올 수 있습니다. 성능에 영향을 미치는 요소는 다음을 포함하되 이에 국한되지 않습니다.

Kotlin 데몬 및 Gradle 데몬의 웜업(warm-up) 정도.
디스크 속도.
CPU 모델 및 사용률.
변경 사항이 영향을 미치는 모듈 및 모듈의 크기.
변경 사항이 ABI 변경인지 비-ABI 변경인지 여부.

빌드 보고서를 통한 최적화 평가

프로젝트 및 시나리오에 대한 최적화의 영향을 컴퓨터에서 추정하려면 Kotlin 빌드 보고서를 사용할 수 있습니다. gradle.properties 파일에 다음 속성을 추가하여 텍스트 파일 형식으로 보고서를 활성화하세요.

none

kotlin.build.report.output=file

정밀 백업 활성화 전 보고서의 관련 부분 예시는 다음과 같습니다.

none

Task ':kotlin-gradle-plugin:compileCommonKotlin' finished in 0.59 s
<...>
Time metrics:
 Total Gradle task time: 0.59 s
 Task action before worker execution: 0.24 s
  Backup output: 0.22 s // 이 숫자에 주목하세요.
<...>

정밀 백업 활성화 후 보고서의 관련 부분 예시는 다음과 같습니다.

none

Task ':kotlin-gradle-plugin:compileCommonKotlin' finished in 0.46 s
<...>
Time metrics:
 Total Gradle task time: 0.46 s
 Task action before worker execution: 0.07 s
  Backup output: 0.05 s // 시간이 줄었습니다.
 Run compilation in Gradle worker: 0.32 s
  Clear jar cache: 0.00 s
  Precise backup output: 0.00 s // 정밀 백업과 관련됨
  Cleaning up the backup stash: 0.00 s // 정밀 백업과 관련됨
<...>

모든 Gradle 버전에 대한 지연 Kotlin/JVM 태스크 생성

Gradle 7.3 이상에서 org.jetbrains.kotlin.gradle.jvm 플러그인을 사용하는 프로젝트의 경우, Kotlin Gradle 플러그인은 더 이상 compileKotlin 태스크를 즉시 생성 및 구성하지 않습니다. 하위 Gradle 버전에서는 단순히 모든 태스크를 등록하고 드라이 런(dry run)에서는 구성하지 않습니다. Gradle 7.3 이상을 사용할 때도 동일한 동작이 적용됩니다.

컴파일 태스크의 `destinationDirectory` 비기본 위치

다음 중 하나를 수행하는 경우 빌드 스크립트를 일부 추가 코드로 업데이트하세요.

Kotlin/JVM KotlinJvmCompile/KotlinCompile 태스크의 destinationDirectory 위치를 오버라이드합니다.
지원 중단된 Kotlin/JS/Non-IR 변형을 사용하고 Kotlin2JsCompile 태스크의 destinationDirectory를 오버라이드합니다.

JAR 파일에서 sourceSets.main.outputs에 sourceSets.main.kotlin.classesDirectories를 명시적으로 추가해야 합니다.

groovy

tasks.jar(type: Jar) {
    from sourceSets.main.outputs
    from sourceSets.main.kotlin.classesDirectories
}

HTTP 통계 서비스에 컴파일러 인수를 보고하지 않는 옵트아웃 기능

이제 Kotlin Gradle 플러그인이 HTTP 빌드 보고서에 컴파일러 인수를 포함할지 여부를 제어할 수 있습니다. 때로는 플러그인이 이러한 인수를 보고할 필요가 없을 수도 있습니다. 프로젝트에 모듈이 많으면 보고서의 컴파일러 인수가 매우 커지고 그다지 도움이 되지 않을 수 있습니다. 이제 이를 비활성화하여 메모리를 절약할 수 있는 방법이 있습니다. gradle.properties 또는 local.properties에서 kotlin.build.report.include_compiler_arguments=(true|false) 속성을 사용하세요.

YouTrack에서 이 기능에 대한 여러분의 피드백을 주시면 감사하겠습니다.

표준 라이브러리

Kotlin 1.8.20은 Kotlin/Native 개발에 특히 유용한 몇 가지 새로운 기능을 포함하여 다양한 새로운 기능을 추가합니다.

AutoCloseable 인터페이스 지원
Base64 인코딩 및 디코딩 지원
Kotlin/Native에서 @Volatile 지원
Kotlin/Native에서 정규식 사용 시 스택 오버플로우 버그 수정

`AutoCloseable` 인터페이스 지원

새로운 AutoCloseable 인터페이스는 실험적이며, 사용하려면 @OptIn(ExperimentalStdlibApi::class) 또는 컴파일러 인수 -opt-in=kotlin.ExperimentalStdlibApi로 옵트인해야 합니다.

AutoCloseable 인터페이스가 공통 표준 라이브러리에 추가되어 모든 라이브러리에서 리소스를 닫기 위한 하나의 공통 인터페이스를 사용할 수 있습니다. Kotlin/JVM에서 AutoCloseable 인터페이스는 java.lang.AutoClosable의 별칭입니다.

또한 확장 함수 use()가 이제 포함되어, 선택된 리소스에서 주어진 블록 함수를 실행한 다음 예외 발생 여부와 관계없이 올바르게 닫습니다.

공통 표준 라이브러리에는 AutoCloseable 인터페이스를 구현하는 public 클래스가 없습니다. 아래 예시에서는 XMLWriter 인터페이스를 정의하고, 이 인터페이스를 구현하는 리소스가 있다고 가정합니다. 예를 들어, 이 리소스는 파일을 열고 XML 콘텐츠를 작성한 다음 닫는 클래스일 수 있습니다.

kotlin

interface XMLWriter : AutoCloseable {
    fun document(encoding: String, version: String, content: XMLWriter.() -> Unit)
    fun element(name: String, content: XMLWriter.() -> Unit)
    fun attribute(name: String, value: String)
    fun text(value: String)
}

fun writeBooksTo(writer: XMLWriter) {
    writer.use { xml ->
        xml.document(encoding = "UTF-8", version = "1.0") {
            element("bookstore") {
                element("book") {
                    attribute("category", "fiction")
                    element("title") { text("Harry Potter and the Prisoner of Azkaban") }
                    element("author") { text("J. K. Rowling") }
                    element("year") { text("1999") }
                    element("price") { text("29.99") }
                }
                element("book") {
                    attribute("category", "programming")
                    element("title") { text("Kotlin in Action") }
                    element("author") { text("Dmitry Jemerov") }
                    element("author") { text("Svetlana Isakova") }
                    element("year") { text("2017") }
                    element("price") { text("25.19") }
                }
            }
        }
    }
}

Base64 인코딩 지원

새로운 인코딩 및 디코딩 기능은 실험적이며, 사용하려면 @OptIn(ExperimentalEncodingApi::class) 또는 컴파일러 인수 -opt-in=kotlin.io.encoding.ExperimentalEncodingApi로 옵트인해야 합니다.

Base64 인코딩 및 디코딩에 대한 지원이 추가되었습니다. 서로 다른 인코딩 스키마를 사용하고 다른 동작을 보여주는 3개의 클래스 인스턴스를 제공합니다. 표준 Base64 인코딩 스키마에는 Base64.Default 인스턴스를 사용하세요.

"URL 및 파일 이름 안전" 인코딩 스키마에는 Base64.UrlSafe 인스턴스를 사용하세요.

MIME 인코딩 스키마에는 Base64.Mime 인스턴스를 사용하세요. Base64.Mime 인스턴스를 사용하면 모든 인코딩 함수는 76자마다 줄 구분자를 삽입합니다. 디코딩의 경우, 모든 불법 문자는 건너뛰어지며 예외를 발생시키지 않습니다.

Base64.Default 인스턴스는 Base64 클래스의 동반 객체입니다. 결과적으로 Base64.Default.encode() 및 Base64.Default.decode() 대신 Base64.encode() 및 Base64.decode()를 통해 함수를 호출할 수 있습니다.

kotlin

val foBytes = "fo".map { it.code.toByte() }.toByteArray()
Base64.Default.encode(foBytes) // "Zm8="
// 또는:
// Base64.encode(foBytes)

val foobarBytes = "foobar".map { it.code.toByte() }.toByteArray()
Base64.UrlSafe.encode(foobarBytes) // "Zm9vYmFy"

Base64.Default.decode("Zm8=") // foBytes
// 또는:
// Base64.decode("Zm8=")

Base64.UrlSafe.decode("Zm9vYmFy") // foobarBytes

바이트를 기존 버퍼로 인코딩 또는 디코딩하고, 제공된 Appendable 타입 객체에 인코딩 결과를 추가하는 추가 함수를 사용할 수 있습니다.

Kotlin/JVM에서는 입력 및 출력 스트림으로 Base64 인코딩 및 디코딩을 수행할 수 있도록 encodingWith() 및 decodingWith() 확장 함수도 추가했습니다.

Kotlin/Native에서 `@Volatile` 지원

Kotlin/Native에서 @Volatile은 실험적입니다. 언제든지 삭제되거나 변경될 수 있습니다. 옵트인(opt-in)이 필요합니다(아래 세부 정보 참조). 평가 목적으로만 사용하세요. YouTrack을 통해 피드백을 주시면 감사하겠습니다.

var 속성에 @Volatile을 어노테이션하면, 백킹 필드가 마킹되어 이 필드에 대한 모든 읽기 또는 쓰기가 원자적이며, 쓰기는 항상 다른 스레드에 가시화됩니다.

1.8.20 이전에는 kotlin.jvm.Volatile 어노테이션이 공통 표준 라이브러리에서 사용할 수 있었습니다. 그러나 이 어노테이션은 JVM에서만 유효합니다. Kotlin/Native에서 사용하면 무시되어 오류가 발생할 수 있습니다.

1.8.20에서는 JVM과 Kotlin/Native 모두에서 사용할 수 있는 공통 어노테이션 kotlin.concurrent.Volatile을 도입했습니다.

활성화 방법

KotlinGroovy

kotlin

tasks
    .withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask<*>>()
    .configureEach {
        compilerOptions
            .languageVersion
            .set(
                org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
            )
    }

groovy

tasks
    .withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompilationTask.class)
    .configureEach {
        compilerOptions.languageVersion =
            org.jetbrains.kotlin.gradle.dsl.KotlinVersion.KOTLIN_1_9
    }

Kotlin/Native에서 정규식 사용 시 스택 오버플로우 버그 수정

이전 Kotlin 버전에서는 정규식 패턴이 매우 간단하더라도 정규식 입력에 많은 수의 문자가 포함된 경우 충돌이 발생할 수 있었습니다. 1.8.20에서는 이 문제가 해결되었습니다. 자세한 내용은 KT-46211을 참조하세요.

직렬화 업데이트

Kotlin 1.8.20은 Kotlin K2 컴파일러용 알파(Alpha) 지원과 동반 객체를 통한 암시적 직렬 변환기 사용자 정의 금지를 제공합니다.

Kotlin K2 컴파일러용 프로토타입 직렬화 컴파일러 플러그인

K2용 직렬화 컴파일러 플러그인 지원은 알파(Alpha) 상태입니다. 사용하려면 Kotlin K2 컴파일러를 활성화하세요.

1.8.20부터 직렬화 컴파일러 플러그인이 Kotlin K2 컴파일러와 함께 작동합니다. 사용해 보시고 피드백을 공유해 주세요!

동반 객체를 통한 암시적 직렬 변환기 사용자 정의 금지

현재 @Serializable 어노테이션으로 클래스를 직렬화 가능하게 선언하는 동시에, 동반 객체에 @Serializer 어노테이션으로 사용자 정의 직렬 변환기를 선언하는 것이 가능합니다.

예시:

kotlin

import kotlinx.serialization.*

@Serializable
class Foo(val a: Int) {
    @Serializer(Foo::class)
    companion object {
        // KSerializer<Foo>의 사용자 정의 구현
    }
}

이 경우 @Serializable 어노테이션에서 어떤 직렬 변환기가 사용되는지 명확하지 않습니다. 실제로는 Foo 클래스에 사용자 정의 직렬 변환기가 사용됩니다.

이러한 혼란을 방지하기 위해 Kotlin 1.8.20에서는 이러한 시나리오가 감지될 때 컴파일러 경고를 도입했습니다. 이 경고는 이 문제를 해결하기 위한 가능한 마이그레이션 경로를 포함합니다.

코드에서 이러한 구문을 사용하는 경우, 다음으로 업데이트하는 것을 권장합니다.

kotlin

import kotlinx.serialization.*

@Serializable(Foo.Companion::class)
class Foo(val a: Int) {
    // @Serializer(Foo::class)를 사용하든 안 하든 상관 없음
    companion object: KSerializer<Foo> {
        // KSerializer<Foo>의 사용자 정의 구현
    }
}

이 접근 방식을 사용하면 Foo 클래스가 동반 객체에 선언된 사용자 정의 직렬 변환기를 사용하는 것이 명확해집니다. 자세한 내용은 YouTrack 티켓을 참조하세요.

Kotlin 2.0에서는 컴파일 경고를 컴파일러 오류로 승격할 계획입니다. 이 경고가 표시되면 코드를 마이그레이션하는 것을 권장합니다.

문서 업데이트

Kotlin 문서에는 몇 가지 주목할 만한 변경 사항이 있었습니다.

Spring Boot 및 Kotlin 시작하기 – 데이터베이스를 사용하여 간단한 애플리케이션을 생성하고 Spring Boot 및 Kotlin 기능에 대해 자세히 알아보세요.
스코프 함수 – 표준 라이브러리의 유용한 스코프 함수로 코드를 단순화하는 방법을 알아보세요.
CocoaPods 통합 – CocoaPods와 함께 작업할 환경을 설정합니다.

Kotlin 1.8.20 설치

IDE 버전 확인

IntelliJ IDEA 2022.2 및 2022.3은 Kotlin 플러그인을 버전 1.8.20으로 자동 업데이트를 제안합니다. IntelliJ IDEA 2023.1에는 Kotlin 플러그인 1.8.20이 내장되어 있습니다.

Android Studio Flamingo (222) 및 Giraffe (223)는 다음 릴리스에서 Kotlin 1.8.20을 지원할 예정입니다.

새로운 명령줄 컴파일러는 GitHub 릴리스 페이지에서 다운로드할 수 있습니다.

Gradle 설정 구성

Kotlin 아티팩트와 의존성을 올바르게 다운로드하려면 settings.gradle(.kts) 파일을 업데이트하여 Maven Central 저장소를 사용하도록 해야 합니다.

kotlin

pluginManagement {
    repositories {
        mavenCentral()
        gradlePluginPortal()
    }
}

저장소가 지정되지 않으면 Gradle은 사용 중단된 JCenter 저장소를 사용하며, 이로 인해 Kotlin 아티팩트 관련 문제가 발생할 수 있습니다.

Spring Boot를 사용하여 데이터베이스와 RESTful 웹 서비스 만들기

Kotlin 1.8.20의 새로운 기능 ​

IDE 지원 ​

새로운 Kotlin K2 컴파일러 업데이트 ​

Kotlin K2 컴파일러 활성화 방법 ​

새로운 K2 컴파일러에 대한 피드백 남기기 ​

언어 ​

Enum 클래스 values 함수의 현대적이고 고성능 대체 ​

entries 속성을 활성화하는 방법 ​

데이터 클래스와의 대칭성을 위한 데이터 객체 미리 보기 ​

데이터 객체의 의미 체계 ​

toString ​

equals 및 hashCode ​

데이터 객체에 대한 copy 및 componentN 함수 없음 ​

데이터 객체 미리 보기를 활성화하는 방법 ​

인라인 클래스에서 본문이 있는 보조 생성자에 대한 제한 해제 미리 보기 ​

본문이 있는 보조 생성자를 활성화하는 방법 ​

새로운 Kotlin/Wasm 타겟 ​

Kotlin/Wasm 활성화 방법 ​

Kotlin/Wasm에 대한 피드백 남기기 ​

Kotlin/JVM ​

Java 합성 속성 참조 미리 보기 ​

Java 합성 속성 참조를 활성화하는 방법 ​

kapt 스텁 생성 태스크에서 JVM IR 백엔드 기본 지원 ​

Kotlin/Native ​

Kotlin/Native 타겟 업데이트 ​

레거시 메모리 관리자 지원 중단 ​

@import 지시어를 사용하는 Objective-C 헤더 지원 ​

Cocoapods Gradle 플러그인에서 링크 전용 모드 지원 ​

UIKit에서 Objective-C 확장을 클래스 멤버로 임포트 ​

컴파일러에서 컴파일러 캐시 관리 재구현 ​

Cocoapods Gradle 플러그인에서 useLibraries() 지원 중단 ​

Kotlin Multiplatform ​

소스 세트 계층 설정의 새로운 접근 방식 ​

프로젝트 설정 ​

바로가기를 대체하는 이유 ​

기본 계층을 활성화하는 방법 ​

피드백 남기기 ​

Kotlin Multiplatform에서 Gradle 컴포짓 빌드 지원 미리 보기 ​

알려진 문제 ​

Xcode에서 Gradle 오류 출력 개선 ​

Kotlin/JavaScript ​

Gradle 플러그인에서 Dukat 통합 제거 ​

소스 맵의 Kotlin 변수 및 함수 이름 ​

TypeScript 정의 파일 생성에 대한 옵트인 ​

Gradle ​

새로운 Gradle 플러그인 버전 정렬 ​

Gradle에서 기본적으로 새로운 JVM 증분 컴파일 ​

컴파일 태스크 출력의 정밀 백업 ​

JetBrains에서 정밀 백업 사용 예시 ​

빌드 보고서를 통한 최적화 평가 ​

모든 Gradle 버전에 대한 지연 Kotlin/JVM 태스크 생성 ​

컴파일 태스크의 destinationDirectory 비기본 위치 ​

HTTP 통계 서비스에 컴파일러 인수를 보고하지 않는 옵트아웃 기능 ​

표준 라이브러리 ​

AutoCloseable 인터페이스 지원 ​

Base64 인코딩 지원 ​

Kotlin/Native에서 @Volatile 지원 ​

활성화 방법 ​

Kotlin/Native에서 정규식 사용 시 스택 오버플로우 버그 수정 ​

직렬화 업데이트 ​

Kotlin K2 컴파일러용 프로토타입 직렬화 컴파일러 플러그인 ​

동반 객체를 통한 암시적 직렬 변환기 사용자 정의 금지 ​

문서 업데이트 ​

Kotlin 1.8.20 설치 ​

IDE 버전 확인 ​

Gradle 설정 구성 ​

Kotlin 1.8.20의 새로운 기능

IDE 지원

새로운 Kotlin K2 컴파일러 업데이트

Kotlin K2 컴파일러 활성화 방법

새로운 K2 컴파일러에 대한 피드백 남기기

언어

Enum 클래스 `values` 함수의 현대적이고 고성능 대체

`entries` 속성을 활성화하는 방법

데이터 클래스와의 대칭성을 위한 데이터 객체 미리 보기

데이터 객체의 의미 체계

toString

equals 및 hashCode

데이터 객체에 대한 `copy` 및 `componentN` 함수 없음

데이터 객체 미리 보기를 활성화하는 방법

인라인 클래스에서 본문이 있는 보조 생성자에 대한 제한 해제 미리 보기

본문이 있는 보조 생성자를 활성화하는 방법

새로운 Kotlin/Wasm 타겟

Kotlin/Wasm 활성화 방법

Kotlin/Wasm에 대한 피드백 남기기

Kotlin/JVM

Java 합성 속성 참조 미리 보기

Java 합성 속성 참조를 활성화하는 방법

kapt 스텁 생성 태스크에서 JVM IR 백엔드 기본 지원

Kotlin/Native

Kotlin/Native 타겟 업데이트

레거시 메모리 관리자 지원 중단

`@import` 지시어를 사용하는 Objective-C 헤더 지원

Cocoapods Gradle 플러그인에서 링크 전용 모드 지원

UIKit에서 Objective-C 확장을 클래스 멤버로 임포트

컴파일러에서 컴파일러 캐시 관리 재구현

Cocoapods Gradle 플러그인에서 `useLibraries()` 지원 중단

Kotlin Multiplatform

소스 세트 계층 설정의 새로운 접근 방식

프로젝트 설정

바로가기를 대체하는 이유

기본 계층을 활성화하는 방법

피드백 남기기

Kotlin Multiplatform에서 Gradle 컴포짓 빌드 지원 미리 보기

알려진 문제

Xcode에서 Gradle 오류 출력 개선

Kotlin/JavaScript

Gradle 플러그인에서 Dukat 통합 제거

소스 맵의 Kotlin 변수 및 함수 이름

TypeScript 정의 파일 생성에 대한 옵트인

Gradle

새로운 Gradle 플러그인 버전 정렬

Gradle에서 기본적으로 새로운 JVM 증분 컴파일

컴파일 태스크 출력의 정밀 백업

JetBrains에서 정밀 백업 사용 예시

빌드 보고서를 통한 최적화 평가

모든 Gradle 버전에 대한 지연 Kotlin/JVM 태스크 생성

컴파일 태스크의 `destinationDirectory` 비기본 위치

HTTP 통계 서비스에 컴파일러 인수를 보고하지 않는 옵트아웃 기능

표준 라이브러리

`AutoCloseable` 인터페이스 지원

Base64 인코딩 지원

Kotlin/Native에서 `@Volatile` 지원

활성화 방법

Kotlin/Native에서 정규식 사용 시 스택 오버플로우 버그 수정

직렬화 업데이트

Kotlin K2 컴파일러용 프로토타입 직렬화 컴파일러 플러그인

동반 객체를 통한 암시적 직렬 변환기 사용자 정의 금지

문서 업데이트

Kotlin 1.8.20 설치

IDE 버전 확인

Gradle 설정 구성