Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

Kotlin 1.7.20의 새로운 기능 ​

Kotlin 1.7.20용 IDE 지원은 IntelliJ IDEA 2021.3, 2022.1 및 2022.2에서 사용할 수 있습니다.

릴리스 날짜: 2022년 9월 29일

Kotlin 1.7.20 릴리스가 출시되었습니다! 다음은 이번 릴리스의 주요 내용입니다.

다음 동영상에서 변경 사항에 대한 간략한 개요를 확인할 수도 있습니다.

Kotlin K2 컴파일러 플러그인 지원 ​

Kotlin 팀은 K2 컴파일러를 계속 안정화하고 있습니다. K2는 아직 알파 버전이지만(Kotlin 1.7.0 릴리스에서 발표된 대로) 이제 여러 컴파일러 플러그인을 지원합니다. 새로운 컴파일러에 대한 Kotlin 팀의 업데이트를 확인하려면 이 YouTrack 이슈를 팔로우하세요.

이 1.7.20 릴리스부터 Kotlin K2 컴파일러는 다음 플러그인을 지원합니다.

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

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

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

Kotlin K2 컴파일러를 활성화하고 테스트하려면 다음 컴파일러 옵션을 사용하세요.

bash
-Xuse-k2

build.gradle(.kts) 파일에 다음과 같이 지정할 수 있습니다.

kotlin
tasks.withType<KotlinCompile> {
    kotlinOptions.useK2 = true
}
groovy
compileKotlin {
    kotlinOptions.useK2 = true
}

JVM 프로젝트에서 성능 향상을 확인하고 이전 컴파일러의 결과와 비교해 보세요.

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

어떤 형태의 피드백이든 정말 감사합니다.

언어 ​

Kotlin 1.7.20은 새로운 언어 기능에 대한 미리보기 버전을 도입하고, 빌더 타입 추론에 제한을 둡니다.

개방형 범위 생성을 위한 ..< 연산자 미리보기 ​

새로운 연산자는 실험적이며, IDE에서 제한적인 지원을 제공합니다.

이번 릴리스에서는 새로운 ..< 연산자를 도입합니다. Kotlin에는 값의 범위를 표현하기 위한 .. 연산자가 있습니다. 새로운 ..< 연산자는 until 함수처럼 작동하며 개방형 범위를 정의하는 데 도움이 됩니다.

저희 연구에 따르면 이 새로운 연산자는 개방형 범위를 더 잘 표현하고 상한(upper bound)이 포함되지 않는다는 것을 명확히 하는 데 더 효과적입니다.

다음은 when 표현식에서 ..< 연산자를 사용하는 예시입니다.

kotlin
when (value) {
    in 0.0..<0.25 -> // 첫 번째 사분면
    in 0.25..<0.5 -> // 두 번째 사분면
    in 0.5..<0.75 -> // 세 번째 사분면
    in 0.75..1.0 ->  // 마지막 사분면  <- 여기는 닫힌 범위에 주목
}

표준 라이브러리 API 변경 사항 ​

다음 새로운 타입과 연산이 공통 Kotlin 표준 라이브러리의 kotlin.ranges 패키지에 도입될 예정입니다.

새로운 OpenEndRange<T> 인터페이스 ​

개방형 범위를 나타내는 새로운 인터페이스는 기존 ClosedRange<T> 인터페이스와 매우 유사합니다.

kotlin
interface OpenEndRange<T : Comparable<T>> {
    // 하한
    val start: T
    // 상한, 범위에 포함되지 않음
    val endExclusive: T
    operator fun contains(value: T): Boolean = value >= start && value < endExclusive
    fun isEmpty(): Boolean = start >= endExclusive
}
기존 반복 가능한 범위에 OpenEndRange 구현 ​

개발자가 상한이 제외된 범위를 얻어야 할 때, 현재는 until 함수를 사용하여 동일한 값을 가진 닫힌 반복 가능한 범위를 효과적으로 생성합니다. OpenEndRange<T>를 사용하는 새로운 API에서 이러한 범위를 허용하기 위해, 기존 반복 가능한 범위인 IntRange, LongRange, CharRange, UIntRange, ULongRange에 해당 인터페이스를 구현하고자 합니다. 따라서 이들은 ClosedRange<T>와 OpenEndRange<T> 인터페이스를 동시에 구현하게 됩니다.

kotlin
class IntRange : IntProgression(...), ClosedRange<Int>, OpenEndRange<Int> {
    override val start: Int
    override val endInclusive: Int
    override val endExclusive: Int
}
표준 타입을 위한 rangeUntil 연산자 ​

rangeUntil 연산자는 현재 rangeTo 연산자에 의해 정의된 것과 동일한 타입 및 조합에 대해 제공될 것입니다. 우리는 프로토타입 목적을 위해 이를 확장 함수로 제공하지만, 일관성을 위해 개방형 범위 API를 안정화하기 전에 나중에 멤버로 만들 계획입니다.

..< 연산자 활성화 방법 ​

..< 연산자를 사용하거나 사용자 정의 타입에 해당 연산자 컨벤션을 구현하려면 -language-version 1.8 컴파일러 옵션을 활성화하세요.

표준 타입의 개방형 범위를 지원하기 위해 도입된 새로운 API 요소는 실험적 stdlib API에 대해 일반적으로 요구되는 것처럼 옵트인(opt-in)이 필요합니다: @OptIn(ExperimentalStdlibApi::class). 또는 -opt-in=kotlin.ExperimentalStdlibApi 컴파일러 옵션을 사용할 수도 있습니다.

이 KEEP 문서에서 새로운 연산자에 대해 자세히 알아보세요.

데이터 객체를 사용한 싱글톤 및 봉인된 클래스 계층의 향상된 문자열 표현 ​

데이터 객체는 실험적이며 현재 IDE에서 제한적인 지원을 제공합니다.

이번 릴리스에서는 새로운 종류의 object 선언인 data object를 도입합니다. 데이터 객체는 개념적으로 일반적인 object 선언과 동일하게 동작하지만, 기본적으로 깔끔한 toString 표현을 제공합니다.

kotlin
package org.example
object MyObject
data object MyDataObject

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

이로 인해 data object 선언은 봉인된 클래스 계층에서 data class 선언과 함께 사용하기에 완벽합니다. 이 스니펫에서 EndOfFile을 일반 object 대신 data object로 선언하는 것은 수동으로 toString을 오버라이드할 필요 없이 깔끔한 toString을 얻게 되어, 동반되는 data class 정의와의 대칭성을 유지한다는 의미입니다.

kotlin
sealed class ReadResult {
    data class Number(val value: Int) : ReadResult()
    data class Text(val value: String) : ReadResult()
    data object EndOfFile : ReadResult()
}

fun main() {
    println(ReadResult.Number(1)) // Number(value=1)
    println(ReadResult.Text("Foo")) // Text(value=Foo)
    println(ReadResult.EndOfFile) // EndOfFile
}

데이터 객체 활성화 방법 ​

코드에서 데이터 객체 선언을 사용하려면 -language-version 1.9 컴파일러 옵션을 활성화하세요. Gradle 프로젝트에서는 build.gradle(.kts)에 다음을 추가하여 활성화할 수 있습니다.

kotlin
tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
    // ...
    kotlinOptions.languageVersion = "1.9"
}
groovy
compileKotlin {
    // ...
    kotlinOptions.languageVersion = '1.9'
}

해당 KEEP 문서에서 데이터 객체에 대해 자세히 알아보고 구현에 대한 피드백을 공유해 주세요.

새로운 빌더 타입 추론 제한 사항 ​

Kotlin 1.7.20은 코드에 영향을 미칠 수 있는 빌더 타입 추론 사용에 몇 가지 주요 제한 사항을 적용합니다. 이러한 제한은 빌더 람다 함수를 포함하는 코드에 적용되며, 람다 자체를 분석하지 않고는 파라미터를 유추할 수 없는 경우입니다. 파라미터는 인수로 사용됩니다. 이제 컴파일러는 이러한 코드에 대해 항상 오류를 표시하고 타입을 명시적으로 지정하도록 요청할 것입니다.

이는 호환성을 깨는 변경 사항이지만, 저희 연구에 따르면 이러한 경우는 매우 드물며 제한 사항이 코드에 영향을 미치지 않아야 합니다. 만약 영향을 받는다면 다음 경우를 고려해 보세요.

  • 멤버를 숨기는 확장 함수가 있는 빌더 추론.

    코드에 빌더 추론 중에 사용될 동일한 이름을 가진 확장 함수가 포함되어 있으면 컴파일러가 오류를 표시할 것입니다.

    kotlin
    class Data {
    fun doSmth() {} // 1
}

fun <T> T.doSmth() {} // 2

fun test() {
    buildList {
        this.add(Data())
        this.get(0).doSmth() // 2로 해결되어 오류 발생
    }
}

    코드를 수정하려면 타입을 명시적으로 지정해야 합니다.

    kotlin
    class Data {
    fun doSmth() {} // 1
}

fun <T> T.doSmth() {} // 2

fun test() {
    buildList<Data> { // 타입 인수!
        this.add(Data())
        this.get(0).doSmth() // 1로 해결
    }
}

  • 여러 람다가 있고 타입 인수가 명시적으로 지정되지 않은 빌더 추론.

    빌더 추론에 두 개 이상의 람다 블록이 있는 경우, 이들은 타입에 영향을 미칩니다. 오류를 방지하기 위해 컴파일러는 타입을 지정하도록 요구합니다.

    kotlin
    fun <T: Any> buildList(
    first: MutableList<T>.() -> Unit, 
    second: MutableList<T>.() -> Unit
): List<T> {
    val list = mutableListOf<T>()
    list.first()
    list.second()
    return list 
}

fun main() {
    buildList(
        first = { // this: MutableList<String>
            add("")
        },
        second = { // this: MutableList<Int> 
            val i: Int = get(0)
            println(i)
        }
    )
}

    오류를 수정하려면 타입을 명시적으로 지정하고 타입 불일치를 해결해야 합니다.

    kotlin
    fun main() {
    buildList<Int>(
        first = { // this: MutableList<Int>
            add(0)
        },
        second = { // this: MutableList<Int>
            val i: Int = get(0)
            println(i)
        }
    )
}

위에 언급된 사례를 찾지 못했다면 저희 팀에 이슈를 제기해 주세요.

이 빌더 추론 업데이트에 대한 자세한 내용은 이 YouTrack 이슈를 참조하세요.

Kotlin/JVM ​

Kotlin 1.7.20은 제네릭 인라인 클래스를 도입하고, 위임된 프로퍼티에 대한 더 많은 바이트코드 최적화를 추가하며, kapt 스텁 생성 작업에서 IR을 지원하여 kapt와 함께 최신 Kotlin 기능을 모두 사용할 수 있도록 합니다.

제네릭 인라인 클래스 ​

제네릭 인라인 클래스는 실험적 기능입니다. 이 기능은 언제든지 제거되거나 변경될 수 있습니다. 옵트인(opt-in)이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다. YouTrack에서 이 기능에 대한 피드백을 주시면 감사하겠습니다.

Kotlin 1.7.20에서는 JVM 인라인 클래스의 기본 타입이 타입 파라미터가 될 수 있도록 허용합니다. 컴파일러는 이를 Any? 또는 일반적으로 타입 파라미터의 상한으로 매핑합니다.

다음 예시를 고려해 보세요.

kotlin
@JvmInline
value class UserId<T>(val value: T)

fun compute(s: UserId<String>) {} // 컴파일러는 fun compute-<hashcode>(s: Any?)를 생성합니다.

이 함수는 인라인 클래스를 파라미터로 받습니다. 파라미터는 타입 인수가 아닌 상한으로 매핑됩니다.

이 기능을 활성화하려면 -language-version 1.8 컴파일러 옵션을 사용하세요.

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

위임된 프로퍼티의 더 많은 최적화 사례 ​

Kotlin 1.6.0에서는 $delegate 필드를 생략하고 참조된 프로퍼티에 즉시 접근을 생성함으로써 프로퍼티에 위임하는 경우를 최적화했습니다. 1.7.20에서는 더 많은 경우에 이 최적화를 구현했습니다. 이제 위임자가 다음 중 하나인 경우 $delegate 필드가 생략됩니다.

  • 이름이 지정된 객체인 경우:

    kotlin
    object NamedObject {
    operator fun getValue(thisRef: Any?, property: KProperty<*>): String = ...
}

val s: String by NamedObject

  • 백킹 필드와 동일한 모듈에 기본 getter가 있는 최종 val 프로퍼티인 경우:

    kotlin
    val impl: ReadOnlyProperty<Any?, String> = ...

class A {
    val s: String by impl
}

  • 상수 표현식, enum 엔트리, this 또는 null인 경우. this의 예시는 다음과 같습니다.

    kotlin
    class A {
    operator fun getValue(thisRef: Any?, property: KProperty<*>) ...
 
    val s by this
}

위임된 프로퍼티에 대해 자세히 알아보세요.

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

kapt 스텁 생성 작업에서 JVM IR 백엔드 지원 ​

kapt 스텁 생성 작업에서 JVM IR 백엔드 지원은 실험적 기능입니다. 이 기능은 언제든지 변경될 수 있습니다. 옵트인(opt-in)이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다.

1.7.20 이전에는 kapt 스텁 생성 작업이 이전 백엔드를 사용했고, 반복 가능 어노테이션은 kapt에서 작동하지 않았습니다. Kotlin 1.7.20에서는 kapt 스텁 생성 작업에서 JVM IR 백엔드에 대한 지원을 추가했습니다. 이를 통해 반복 가능 어노테이션을 포함한 모든 최신 Kotlin 기능을 kapt와 함께 사용할 수 있게 됩니다.

kapt에서 IR 백엔드를 사용하려면 gradle.properties 파일에 다음 옵션을 추가하세요.

none
kapt.use.jvm.ir=true

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

Kotlin/Native ​

Kotlin 1.7.20은 새로운 Kotlin/Native 메모리 관리자가 기본적으로 활성화되어 제공되며, Info.plist 파일을 사용자 지정할 수 있는 옵션을 제공합니다.

새로운 Kotlin/Native 메모리 관리자가 기본적으로 활성화됨 ​

이번 릴리스는 새로운 메모리 관리자의 안정성과 성능을 더욱 향상시켜, 새로운 메모리 관리자를 베타 버전으로 승격할 수 있게 되었습니다.

이전 메모리 관리자는 kotlinx.coroutines 라이브러리 구현 문제를 포함하여 동시성 및 비동기 코드를 작성하는 것을 복잡하게 만들었습니다. 이는 동시성 제한이 iOS와 Android 플랫폼 간에 Kotlin 코드를 공유하는 데 문제를 야기하여 Kotlin Multiplatform Mobile의 채택을 막았습니다. 새로운 메모리 관리자는 마침내 Kotlin Multiplatform Mobile을 베타로 승격하는 길을 열었습니다.

새로운 메모리 관리자는 또한 컴파일 시간을 이전 릴리스와 비슷하게 만드는 컴파일러 캐시를 지원합니다. 새로운 메모리 관리자의 이점에 대한 자세한 내용은 미리보기 버전에 대한 원래 블로그 게시물을 참조하세요. 문서에서 더 많은 기술적 세부 정보를 확인할 수 있습니다.

구성 및 설정 ​

Kotlin 1.7.20부터 새로운 메모리 관리자가 기본값으로 설정됩니다. 추가 설정은 거의 필요하지 않습니다.

이미 수동으로 활성화한 경우, gradle.properties 파일에서 kotlin.native.binary.memoryModel=experimental 옵션을 제거하거나 build.gradle(.kts) 파일에서 binaryOptions["memoryModel"] = "experimental"을 제거할 수 있습니다.

필요한 경우 gradle.properties 파일에 kotlin.native.binary.memoryModel=strict 옵션을 사용하여 레거시 메모리 관리자로 다시 전환할 수 있습니다. 하지만 레거시 메모리 관리자에서는 컴파일러 캐시 지원이 더 이상 제공되지 않으므로 컴파일 시간이 길어질 수 있습니다.

동결(Freezing) ​

새로운 메모리 관리자에서는 동결(freezing)이 더 이상 사용되지 않습니다. (동결이 여전히 필요한) 레거시 관리자에서 코드가 작동해야 하는 경우가 아니라면 사용하지 마십시오. 이는 레거시 메모리 관리자를 계속 지원해야 하는 라이브러리 작성자나 새로운 메모리 관리자에서 문제가 발생했을 때 대체 수단이 필요한 개발자에게 유용할 수 있습니다.

이러한 경우, 새로운 메모리 관리자와 레거시 메모리 관리자 모두에 대한 코드를 일시적으로 지원할 수 있습니다. 더 이상 사용되지 않는 경고를 무시하려면 다음 중 하나를 수행하세요.

  • 더 이상 사용되지 않는 API 사용에 @OptIn(FreezingIsDeprecated::class) 어노테이션을 붙이세요.
  • Gradle의 모든 Kotlin 소스 세트에 languageSettings.optIn("kotlin.native.FreezingIsDeprecated")를 적용하세요.
  • 컴파일러 플래그 -opt-in=kotlin.native.FreezingIsDeprecated를 전달하세요.

Swift/Objective-C에서 Kotlin suspend 함수 호출 ​

새로운 메모리 관리자는 여전히 Swift 및 Objective-C에서 메인 스레드 외의 스레드에서 Kotlin suspend 함수를 호출하는 것을 제한하지만, 새로운 Gradle 옵션으로 이 제한을 해제할 수 있습니다.

이 제한은 코드가 원래 스레드에서 재개될 코루틴(continuation)을 디스패치하는 경우 때문에 레거시 메모리 관리자에서 처음 도입되었습니다. 이 스레드에 지원되는 이벤트 루프가 없으면 작업이 실행되지 않아 코루틴이 재개되지 않습니다.

특정 경우에는 이 제한이 더 이상 필요 없지만, 필요한 모든 조건을 쉽게 구현할 수는 없습니다. 이 때문에 새로운 메모리 관리자에서는 이 제한을 유지하되, 비활성화할 수 있는 옵션을 도입하기로 결정했습니다. 이를 위해 gradle.properties에 다음 옵션을 추가하세요.

none
kotlin.native.binary.objcExportSuspendFunctionLaunchThreadRestriction=none

kotlinx.coroutines의 native-mt 버전 또는 동일한 "원본 스레드로 디스패치" 접근 방식을 사용하는 다른 라이브러리를 사용하는 경우 이 옵션을 추가하지 마십시오.

Kotlin 팀은 이 옵션을 구현해준 Ahmed El-Helw에게 매우 감사합니다.

피드백 남기기 ​

이는 저희 생태계에 중요한 변화입니다. 더 나은 개선을 위해 여러분의 피드백을 주시면 감사하겠습니다.

프로젝트에서 새로운 메모리 관리자를 사용해보고 이슈 트래커인 YouTrack에 피드백을 공유해 주세요.

Info.plist 파일 사용자 지정 ​

프레임워크를 생성할 때 Kotlin/Native 컴파일러는 정보 속성 목록 파일인 Info.plist를 생성합니다. 이전에는 그 내용을 사용자 지정하기가 번거로웠습니다. Kotlin 1.7.20부터는 다음 속성들을 직접 설정할 수 있습니다.

속성이진 옵션
CFBundleIdentifierbundleId
CFBundleShortVersionStringbundleShortVersionString
CFBundleVersionbundleVersion

이를 위해 해당 이진 옵션을 사용하세요. 필요한 프레임워크에 -Xbinary=$option=$value 컴파일러 플래그를 전달하거나 binaryOption(option, value) Gradle DSL을 설정하세요.

Kotlin 팀은 이 기능을 구현해준 Mads Ager에게 매우 감사합니다.

Kotlin/JS ​

Kotlin/JS는 개발자 경험을 개선하고 성능을 향상시키는 몇 가지 개선 사항을 받았습니다.

  • 의존성 로딩 효율성 개선 덕분에 Klib 생성이 증분 빌드와 클린 빌드 모두에서 더 빨라졌습니다.
  • 개발 바이너리에 대한 증분 컴파일이 재작업되어 클린 빌드 시나리오에서 주요 개선, 더 빠른 증분 빌드, 안정성 수정 사항이 적용되었습니다.
  • 중첩 객체, 봉인된 클래스, 생성자에서 기본값이 있는 파라미터에 대한 .d.ts 생성을 개선했습니다.

Gradle ​

Kotlin Gradle 플러그인에 대한 업데이트는 새로운 Gradle 기능 및 최신 Gradle 버전과의 호환성에 중점을 둡니다.

Kotlin 1.7.20은 Gradle 7.1 지원을 위한 변경 사항을 포함합니다. 더 이상 사용되지 않는 메서드 및 프로퍼티가 제거되거나 대체되어 Kotlin Gradle 플러그인에서 발생하는 사용 중단 경고 수를 줄이고 Gradle 8.0의 향후 지원을 해제합니다.

하지만 주의가 필요할 수 있는 잠재적으로 호환성을 깨는 변경 사항도 있습니다.

타겟 구성 ​

  • org.jetbrains.kotlin.gradle.dsl.SingleTargetExtension은 이제 제네릭 파라미터인 SingleTargetExtension<T : KotlinTarget>를 가집니다.

  • kotlin.targets.fromPreset() 컨벤션은 더 이상 사용되지 않습니다. 대신 여전히 kotlin.targets { fromPreset() }을 사용할 수 있지만, 명시적으로 타겟을 설정하는 것을 권장합니다.

  • Gradle에 의해 자동 생성된 타겟 접근자는 더 이상 kotlin.targets { } 블록 내에서 사용할 수 없습니다. 대신 findByName("targetName") 메서드를 사용하십시오.

    kotlin.targets의 경우 (예: kotlin.targets.linuxX64), 이러한 접근자는 여전히 사용할 수 있습니다.

소스 디렉터리 구성 ​

Kotlin Gradle 플러그인은 이제 Java의 SourceSet 그룹에 Kotlin SourceDirectorySet을 kotlin 확장으로 추가합니다. 이를 통해 Java, Groovy, Scala에서 구성하는 방식과 유사하게 build.gradle.kts 파일에서 소스 디렉터리를 구성할 수 있습니다.

kotlin
sourceSets {
    main {
        kotlin {
            java.setSrcDirs(listOf("src/java"))
            kotlin.setSrcDirs(listOf("src/kotlin"))
        }
    }
}

더 이상 사용되지 않는 Gradle 컨벤션을 사용하고 Kotlin에 대한 소스 디렉터리를 지정할 필요가 없습니다.

kotlin 확장을 사용하여 KotlinSourceSet에 접근할 수도 있다는 점을 기억하세요.

kotlin
kotlin {
    sourceSets {
        main {
        // ...
        }
    }
}

JVM 툴체인 구성을 위한 새로운 메서드 ​

이번 릴리스에서는 JVM 툴체인 기능을 활성화하기 위한 새로운 jvmToolchain() 메서드를 제공합니다. implementation 또는 vendor와 같은 추가 구성 필드가 필요하지 않은 경우, Kotlin 확장에서 이 메서드를 사용할 수 있습니다.

kotlin
kotlin {
    jvmToolchain(17)
}

이는 추가 구성 없이 Kotlin 프로젝트 설정 프로세스를 간소화합니다. 이번 릴리스 이전에는 다음 방식으로만 JDK 버전을 지정할 수 있었습니다.

kotlin
kotlin {
    jvmToolchain {
        languageVersion.set(JavaLanguageVersion.of(17))
    }
}

표준 라이브러리 ​

Kotlin 1.7.20은 java.nio.file.Path 클래스에 대한 새로운 확장 함수를 제공하여 파일 트리를 탐색할 수 있도록 합니다.

  • walk()는 지정된 경로를 루트로 하는 파일 트리를 지연 로드(lazily) 탐색합니다.
  • fileVisitor()는 FileVisitor를 별도로 생성할 수 있도록 합니다. FileVisitor는 디렉터리와 파일을 탐색할 때의 동작을 정의합니다.
  • visitFileTree(fileVisitor: FileVisitor, ...)는 준비된 FileVisitor를 소비하고 내부적으로 java.nio.file.Files.walkFileTree()를 사용합니다.
  • visitFileTree(..., builderAction: FileVisitorBuilder.() -> Unit)는 builderAction으로 FileVisitor를 생성하고 visitFileTree(fileVisitor, ...) 함수를 호출합니다.
  • FileVisitor의 반환 타입인 FileVisitResult는 파일 처리를 계속하는 CONTINUE 기본값을 가집니다.

java.nio.file.Path의 새로운 확장 함수는 실험적입니다. 이 함수들은 언제든지 변경될 수 있습니다. 옵트인(opt-in)이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다.

새로운 확장 함수로 할 수 있는 몇 가지 작업은 다음과 같습니다.

  • FileVisitor를 명시적으로 생성한 다음 사용:

    kotlin
    val cleanVisitor = fileVisitor {
    onPreVisitDirectory { directory, attributes ->
        // 디렉터리 방문 시 일부 로직
        FileVisitResult.CONTINUE
    }

    onVisitFile { file, attributes ->
        // 파일 방문 시 일부 로직
        FileVisitResult.CONTINUE
    }
}

// 여기에 일부 로직이 올 수 있습니다

projectDirectory.visitFileTree(cleanVisitor)

  • builderAction으로 FileVisitor를 생성하고 즉시 사용:

    kotlin
    projectDirectory.visitFileTree {
// builderAction의 정의:
    onPreVisitDirectory { directory, attributes ->
        // 디렉터리 방문 시 일부 로직
        FileVisitResult.CONTINUE
    }

    onVisitFile { file, attributes ->
        // 파일 방문 시 일부 로직
        FileVisitResult.CONTINUE
    }
}

  • walk() 함수를 사용하여 지정된 경로를 루트로 하는 파일 트리를 탐색:

    kotlin
    @OptIn(kotlin.io.path.ExperimentalPathApi::class)
fun traverseFileTree() {
    val cleanVisitor = fileVisitor {
        onPreVisitDirectory { directory, _ ->
            if (directory.name == "build") {
                directory.toFile().deleteRecursively()
                FileVisitResult.SKIP_SUBTREE
            } else {
                FileVisitResult.CONTINUE
            }
        }

        onVisitFile { file, _ ->
            if (file.extension == "class") {
                file.deleteExisting()
            }
            FileVisitResult.CONTINUE
        }
    }

    val rootDirectory = createTempDirectory("Project")

    rootDirectory.resolve("src").let { srcDirectory ->
        srcDirectory.createDirectory()
        srcDirectory.resolve("A.kt").createFile()
        srcDirectory.resolve("A.class").createFile()
    }

    rootDirectory.resolve("build").let { buildDirectory ->
        buildDirectory.createDirectory()
        buildDirectory.resolve("Project.jar").createFile()
    }

 
// walk 함수 사용:
    val directoryStructure = rootDirectory.walk(PathWalkOption.INCLUDE_DIRECTORIES)
        .map { it.relativeTo(rootDirectory).toString() }
        .toList().sorted()
    assertPrints(directoryStructure, "[, build, build/Project.jar, src, src/A.class, src/A.kt]")

    rootDirectory.visitFileTree(cleanVisitor)

    val directoryStructureAfterClean = rootDirectory.walk(PathWalkOption.INCLUDE_DIRECTORIES)
        .map { it.relativeTo(rootDirectory).toString() }
        .toList().sorted()
    assertPrints(directoryStructureAfterClean, "[, src, src/A.kt]")
}

실험적 API에 대한 일반적인 경우와 같이, 새로운 확장 함수에는 옵트인(opt-in)이 필요합니다: @OptIn(kotlin.io.path.ExperimentalPathApi::class) 또는 @kotlin.io.path.ExperimentalPathApi. 또는 컴파일러 옵션 -opt-in=kotlin.io.path.ExperimentalPathApi를 사용할 수 있습니다.

YouTrack의 walk() 함수와 방문 확장 함수에 대한 피드백을 주시면 감사하겠습니다.

문서 업데이트 ​

이전 릴리스 이후, Kotlin 문서에 몇 가지 주목할 만한 변경 사항이 있었습니다.

개편 및 개선된 페이지 ​

  • 기본 타입 개요 – Kotlin에서 사용되는 기본 타입(숫자, 부울, 문자, 문자열, 배열, 부호 없는 정수)에 대해 알아보세요.
  • Kotlin 개발용 IDE – 공식 Kotlin 지원이 제공되는 IDE 및 커뮤니티 지원 플러그인이 있는 도구 목록을 확인하세요.

Kotlin 멀티플랫폼 저널의 새로운 글 ​

새롭고 업데이트된 튜토리얼 ​

릴리스 문서의 변경 사항 ​

각 릴리스에 대한 권장 kotlinx 라이브러리 목록은 더 이상 제공하지 않습니다. 이 목록에는 Kotlin 자체와 함께 권장되고 테스트된 버전만 포함되었습니다. 일부 라이브러리는 서로 의존하며 권장되는 Kotlin 버전과 다를 수 있는 특별한 kotlinx 버전을 필요로 한다는 점은 고려되지 않았습니다.

라이브러리가 서로 어떻게 연관되고 의존하는지에 대한 정보를 제공하여 프로젝트에서 Kotlin 버전을 업그레이드할 때 어떤 kotlinx 라이브러리 버전을 사용해야 하는지 명확히 알 수 있도록 방법을 모색 중입니다.

Kotlin 1.7.20 설치 ​

IntelliJ IDEA 2021.3, 2022.1, 2022.2는 Kotlin 플러그인을 1.7.20으로 자동 업데이트할 것을 제안합니다.

Android Studio Dolphin (213), Electric Eel (221), Flamingo (222)의 경우, Kotlin 플러그인 1.7.20은 예정된 Android Studio 업데이트와 함께 제공될 예정입니다.

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

Kotlin 1.7.20 호환성 가이드 ​

Kotlin 1.7.20은 증분 릴리스이지만, Kotlin 1.7.0에서 도입된 문제의 확산을 제한하기 위해 호환되지 않는 변경 사항이 여전히 존재합니다.

이러한 변경 사항에 대한 자세한 목록은 Kotlin 1.7.20 호환성 가이드에서 확인할 수 있습니다.

Copyright © 2025 Open AIDoc.