Kotlin 1.6.20 版中的新功能

语言功能

Kotlin/JVM 平台的上下文接受者(Context Receiver) 功能原型

interface LoggingContext {
    val log: Logger // 这个上下文提供一个 logger 的引用
}

context(LoggingContext)
fun startBusinessOperation() {
    // 你可以访问 log 属性, 因为 LoggingContext 是一个隐含的接受者
    log.info("Operation has started")
}

fun test(loggingContext: LoggingContext) {
    with(loggingContext) {
        // 你需要在这个作用范围内存在一个 LoggingContext, 作为隐含的接受者
        // 然后才能调用 startBusinessOperation()
        startBusinessOperation()
    }
}

要在你的项目中启用上下文接受者功能, 请使用 -Xcontext-receivers 编译器选项. 关于这个功能的详细描述, 以及它的语法, 请参见 KEEP.

明确非 null 类型

为了在扩展泛型的 Java 类和接口时提供更好的互操作性, Kotlin 1.6.20 允许你使用新的语法 T & Any, 将一个泛型类型参数标记为在使用端明确非 null. 这个语法来自交叉类型(Intersection Types) 的标记形式, 并且现在 & 左侧必须是上界可为 null 的类型参数, 右侧必须是非 null 的 Any:

fun <T> elvisLike(x: T, y: T & Any): T & Any = x ?: y

fun main() {
    // OK
    elvisLike<String>("", "").length
    // 错误: 'null' 不能作为一个非 null 类型的值
    elvisLike<String>("", null).length

    // OK
    elvisLike<String?>(null, "").length
    // 错误: 'null' 不能作为一个非 null 类型的值
    elvisLike<String?>(null, null).length
}

请将语言版本设置为 1.7, 来启用这个功能:

kotlin {
    sourceSets.all {
        languageSettings.apply {
            languageVersion = "1.7"
        }
    }
}

Kotlin/JVM

支持对函数式接口构造器的可调用引用

interface Printer {
    fun print()
}

fun Printer(block: () -> Unit): Printer = object : Printer { override fun print() = block() }

fun interface Printer {
    fun print()
}

它的构造器会隐含的创建, 任何使用 ::Printer 函数引用的代码都可以正确编译. 比如:

documentsStorage.addPrinter(::Printer)

为了保持二进制兼容性, 可以对旧的函数 Printer 标注 @Deprecated 注解, 废弃级别设置为 DeprecationLevel.HIDDEN:

@Deprecated(message = "Your message about the deprecation", level = DeprecationLevel.HIDDEN)
fun Printer(...) {...}

请使用编译器选项 -XXLanguage:+KotlinFunInterfaceConstructorReference 来启用这个功能.

Kotlin/Native

新内存管理器中内存清理阶段(Sweep Phase)的并发实现

-Xgc=cms

与 Swift async/await 的交互: 返回 Swift 的 Void 类型, 而不是 KotlinUnit 类型

我们继续改进了与 Swift's async/await 的交互(实验性功能) (从 Swift 5.5 开始可用). 在 Kotlin 1.6.20 中, 处理 Unit 返回类型的 suspend 函数的方式, 与以前的版本不同.

以前的版本中, 这样的函数在 Swift 中表达为返回 KotlinUnit 的 async 函数. 但是, 正确的返回类型应该是 Void, 与非挂起的函数类似.

为了避免破坏已有的代码, 我们引入一个 Gradle 属性, 让编译器将返回 Unit 的挂起函数, 翻译为 Swift 中的 Void 返回类型的 async 函数:

# gradle.properties
kotlin.native.binary.unitSuspendFunctionObjCExport=proper

使用 libbacktrace 的更好的栈追踪信息(Stack Trace)

Kotlin/Native 现在可以输出详细的栈追踪信息(Stack Trace), 其中包括文件位置和行号, 可以用于 linux* (linuxMips32 和 linuxMipsel32 除外) 和 androidNative* 编译目标上更好的进行错误调试.

fun main() = bar()
fun bar() = baz()
inline fun baz() {
    error("")
}

Uncaught Kotlin exception: kotlin.IllegalStateException: {...}

Uncaught Kotlin exception: kotlin.IllegalStateException: {...}

Uncaught Kotlin exception: kotlin.IllegalStateException: {...}

Uncaught Kotlin exception: kotlin.IllegalStateException: {...}

要使用 libbacktrace 输出更好的栈追踪信息, 请在 gradle.properties 中添加以下内容:

# gradle.properties
kotlin.native.binary.sourceInfoType=libbacktrace

支持独立的 Android 可执行文件

为了使用这个功能, 请在你的项目的 build.gradle(.kts) 中, 配置你的 androidNative 编译目标的 executable 代码段. 添加 the 以下 binary 选项:

kotlin {
    androidNativeX64("android") {
        binaries {
            executable {
                binaryOptions["androidProgramType"] = "standalone"
            }
        }
    }
}

binaryOptions["androidProgramType"] = "nativeActivity"

Kotlin Multiplatform

对跨平台项目的层级结构支持

配置与设置

如果你已经进行了手工转换, 你可以从 gradle.properties 中删除废弃的选项:

# gradle.properties
kotlin.mpp.enableGranularSourceSetsMetadata=true
kotlin.native.enableDependencyPropagation=false // 或 'true', 取决于你以前的设置

对于 Kotlin 1.6.20, 我们建议使用 Android Studio 2021.1.1 (Bumblebee) 或更高版本, 以获得最好的开发体验.
你可以也选择性禁用(opt out)这个功能. 要禁用层级结构支持, 请在 gradle.properties 中设置以下选项:
```
# gradle.properties
kotlin.mpp.hierarchicalStructureSupport=false
```

Kotlin CocoaPods Gradle plugin

kotlin {
    cocoapods {
        version = "1.0"
        name = "MyCocoaPod"
        extraSpecAttributes["social_media_url"] = 'https://twitter.com/kotlin'
        extraSpecAttributes["vendored_frameworks"] = 'CustomFramework.xcframework'
        extraSpecAttributes["libraries"] = 'xml'
    }
}

Kotlin/JS

IR 编译器对开发阶段二进制文件的增量编译

在这个模式下, 使用 compileDevelopmentExecutableKotlinJs Gradle task 构建开发阶段二进制文件时, 编译器会在模块层级缓存前一次编译的结果. 它会在后续的编译中对未变更的源代码文件使用缓存的编译结果, 让编译更加快速, 尤其是对小的变更. 注意, 这个改进仅仅针对开发阶段(缩短编辑-构建-调试循环的时间), 而不会影响产品 artifact 的构建.

要对开发阶段二进制文件启用增量编译, 请向项目的 gradle.properties 文件添加以下内容:

# gradle.properties
kotlin.incremental.js.ir=true // 默认为 false

IR 编译器默认对顶级属性(Top-Level Property)延迟初始化(Lazy initialization)

// 延迟初始化
val a = run {
    val result = // 假设这里是一段计算密集的代码
        println(result)
    result
} // 直到变量初次使用时才会执行 run

IR 编译器默认对项目模块输出单独的 JS 文件

以前的版本中, JS IR 编译器可以为项目模块生成单独的 .js 文件. 默认选项是 – 对整个项目生成单个 .js 文件. 这个文件可能会非常巨大, 不便于使用, 因为如果你想要使用你的项目的一个函数, 你不得不将整个 JS 文件作为依赖项. 生成多个文件可以提高灵活性, 减少这些依赖项的大小. 这个功能可以通过 -Xir-per-module 编译器选项来使用.

从 1.6.20 开始, JS IR 编译器默认为项目模块生成单独的 .js 文件.

编译项目为单个的 .js 文件, 现在可以通过以下 Gradle 属性来使用:

# gradle.properties
kotlin.js.ir.output.granularity=whole-program // 默认值为 `per-module`

在以前的版本中, 实验性的 per-module 模式 (可以通过 -Xir-per-module=true 选项启用)会在每个模块中调用 main() 函数. 这种行为与通常的单独 .js 模式不一致. 从 1.6.20 开始, 对这两种情况, main() 函数都只会在 main 模块中调用. 如果你确实需要在模块装载时运行某些代码, 你可以使用顶级属性(Top-Level Property), 并标注 @EagerInitialization 注解. 参见默认对顶级属性(Top-Level Property)延迟初始化(Lazy initialization) (IR).

安全性

在 klibs 中使用相对路径

一个 klib 格式的库包含源代码文件的序列化后的 IR 表达, 其中包含文件路径, 用于生成正确的调试信息. 在 Kotlin 1.6.20 以前, 保存的文件路径是绝对路径. 由于库作者可能不希望公开他们的绝对路径, 1.6.20 版本引入了一个替代选项.

如果你正在发布一个 klib, 并且希望在 artifact 中只使用源代码文件的相对路径, 现在你可以传递 -Xklib-relative-path-base 编译器选项, 参数是一个或多个源代码文件基准路径:

tasks.withType(org.jetbrains.kotlin.gradle.dsl.KotlinCompile::class).configureEach {
    // $base 是源代码文件的基准路径
    kotlinOptions.freeCompilerArgs += "-Xklib-relative-path-base=$base"
}

对 Kotlin/JS Gradle 项目保持 yarn.lock 文件

Kotlin/JS Gradle plugin 现在提供了保持 yarn.lock 文件的功能, 因此可以为你的项目锁定 npm 依赖项的版本, 而不需要额外的 Gradle 配置. 这个功能修改了默认的项目结构, 在项目的根目录下添加了自动生成的 kotlin-js-store 目录. 这个目录内保存 yarn.lock 文件.

我们强烈建议将 kotlin-js-store 目录及其内容提交到你的版本控制系统. 将这个锁文件提交到你的版本控制系统是一种推荐的实践(Recommended Practice), 因为可以保证你的应用程序在所有机器上都使用完全相同的依赖项树进行构建, 无论是在其他机器上的开发环境中, 还是在 CI/CD 服务中. 当项目在一台新机器上 check out 时, 锁文件也可以防止你的 npm 依赖项被静悄悄的更新, 这样会导致安全性问题.

Dependabot 之类的工具可以也解析你的 Kotlin/JS 项目的 yarn.lock 文件, 如果你依赖的任何 npm 包存在安全问题, 它会向你提示警告.

rootProject.plugins.withType<org.jetbrains.kotlin.gradle.targets.js.yarn.YarnPlugin> {
    rootProject.the<org.jetbrains.kotlin.gradle.targets.js.yarn.YarnRootExtension>().lockFileDirectory =
        project.rootDir.resolve("my-kotlin-js-store")
    rootProject.the<org.jetbrains.kotlin.gradle.targets.js.yarn.YarnRootExtension>().lockFileName = "my-yarn.lock"
}

默认使用 `--ignore-scripts` 安装 npm 依赖项

如果要回滚到旧的配置, 你可以明确的允许 Life Cycle 脚本执行, 方法是向 build.gradle(.kts) 文件添加以下设置:

rootProject.plugins.withType<org.jetbrains.kotlin.gradle.targets.js.yarn.YarnPlugin> {
    rootProject.the<org.jetbrains.kotlin.gradle.targets.js.yarn.YarnRootExtension>().ignoreScripts = false
}

Gradle

用于定义 Kotlin 编译器执行策略的属性

在 Kotlin 1.6.20 之前, 你可以使用系统属性 -Dkotlin.compiler.execution.strategy 来定义 Kotlin 编译器执行策略. 这个属性对于某些情况可以很便利. Kotlin 1.6.20 引入一个相同名称的 Gradle 属性, kotlin.compiler.execution.strategy, 以及编译 task 属性 compilerExecutionStrategy.

策略	Kotlin 编译器在哪里执行	增量编译	其它特征
Daemon	在 Kotlin 自己的 daemon 进程之内	是	默认策略. 可以在不同的 Gradle daemon 之间共用
In process	在 Gradle daemon 进程之内	否	可以与 Gradle daemon 共用 heap
Out of process	对每个编译都在单独的进程内	否	—

相应的, 对于 (系统属性和 Gradle 属性) kotlin.compiler.execution.strategy, 可以设置的值是:

在 gradle.properties 中, 使用 Gradle 属性 kotlin.compiler.execution.strategy:

# gradle.properties
kotlin.compiler.execution.strategy=out-of-process

对于 task 属性 compilerExecutionStrategy, 可以设置的值是:

在 build.gradle.kts 构建脚本中, 使用 task 属性 compilerExecutionStrategy:

import org.jetbrains.kotlin.gradle.dsl.KotlinCompile
import org.jetbrains.kotlin.gradle.tasks.KotlinCompilerExecutionStrategy

// ...

tasks.withType<KotlinCompile>().configureEach {
    compilerExecutionStrategy.set(KotlinCompilerExecutionStrategy.IN_PROCESS)
}

Kotlin 1.6.20 版中的新功能﻿

语言功能﻿

Kotlin/JVM 平台的上下文接受者(Context Receiver) 功能原型﻿

warning

明确非 null 类型﻿

warning

Kotlin/JVM﻿

用于接口的新的 @JvmDefaultWithCompatibility 注解﻿

-Xjvm-default 模式中的兼容性变更﻿

在 JVM 后端中支持单个模块的并行编译﻿

warning

note

支持对函数式接口构造器的可调用引用﻿

warning

Kotlin/Native﻿

新内存管理器的更新﻿

note

新内存管理器中内存清理阶段(Sweep Phase)的并发实现﻿

注解类的实例化﻿

与 Swift async/await 的交互: 返回 Swift 的 Void 类型, 而不是 KotlinUnit 类型﻿

warning

使用 libbacktrace 的更好的栈追踪信息(Stack Trace)﻿

warning

支持独立的 Android 可执行文件﻿

性能改进﻿

cinterop 模块导入时的错误处理改进﻿

支持 Xcode 13 库﻿

Kotlin Multiplatform﻿

对跨平台项目的层级结构支持﻿

在你的项目中更好的共用代码﻿

库作者的更多选择﻿

配置与设置﻿

提供你的反馈意见﻿

Kotlin CocoaPods Gradle plugin﻿

Kotlin/JS﻿

IR 编译器对开发阶段二进制文件的增量编译﻿

IR 编译器默认对顶级属性(Top-Level Property)延迟初始化(Lazy initialization)﻿

IR 编译器默认对项目模块输出单独的 JS 文件﻿

Char 类优化﻿

导出功能的改进, 对 TypeScript 声明生成的改进﻿

对异步的测试确保 @AfterTest﻿

安全性﻿

在 klibs 中使用相对路径﻿

对 Kotlin/JS Gradle 项目保持 yarn.lock 文件﻿

note

warning

默认使用 --ignore-scripts 安装 npm 依赖项﻿

note

Gradle﻿

用于定义 Kotlin 编译器执行策略的属性﻿

废弃用于 kapt 和 coroutines 的构建选项﻿

删除构建选项 kotlin.parallel.tasks.in.project﻿

Kotlin 1.6.20 版中的新功能

语言功能

Kotlin/JVM 平台的上下文接受者(Context Receiver) 功能原型

明确非 null 类型

Kotlin/JVM

用于接口的新的 @JvmDefaultWithCompatibility 注解

-Xjvm-default 模式中的兼容性变更

在 JVM 后端中支持单个模块的并行编译

支持对函数式接口构造器的可调用引用

Kotlin/Native

新内存管理器的更新

新内存管理器中内存清理阶段(Sweep Phase)的并发实现

注解类的实例化

与 Swift async/await 的交互: 返回 Swift 的 Void 类型, 而不是 KotlinUnit 类型

使用 libbacktrace 的更好的栈追踪信息(Stack Trace)

支持独立的 Android 可执行文件

性能改进

cinterop 模块导入时的错误处理改进

支持 Xcode 13 库

Kotlin Multiplatform

对跨平台项目的层级结构支持

在你的项目中更好的共用代码

库作者的更多选择

配置与设置

提供你的反馈意见

Kotlin CocoaPods Gradle plugin

Kotlin/JS

IR 编译器对开发阶段二进制文件的增量编译

IR 编译器默认对顶级属性(Top-Level Property)延迟初始化(Lazy initialization)

IR 编译器默认对项目模块输出单独的 JS 文件

Char 类优化

导出功能的改进, 对 TypeScript 声明生成的改进

对异步的测试确保 @AfterTest

安全性

在 klibs 中使用相对路径

对 Kotlin/JS Gradle 项目保持 yarn.lock 文件

默认使用 `--ignore-scripts` 安装 npm 依赖项

Gradle

用于定义 Kotlin 编译器执行策略的属性

废弃用于 kapt 和 coroutines 的构建选项

删除构建选项 kotlin.parallel.tasks.in.project