Kotlin 1.4.20 版中的新功能

Java 15 编译目标

现在 Kotlin/JVM 编译目标可以使用 Java 15.

invokedynamic 字符串拼接

warning

invokedynamic 字符串拼接是 实验性功能. 这个功能随时可能抛弃或改变. 使用这个功能需要使用者同意(Opt-in)(详情请参见下文). 请注意, 只为评估和试验目的来使用这个功能. 希望你能通过我们的 问题追踪系统 提供你的反馈意见.

对于 JVM 9 以上版本的编译目标, Kotlin 1.4.20 能够将字符串拼接编译为 动态调用(dynamic invocation), 进而改善性能.

现在, 这个功能特性还是实验性功能, 包含以下使用场景:

• String.plus: 操作符形式(a + b), 明确调用形式(a.plus(b)), 以及方法参照形式((a::plus)(b)).

• toString: 在内联类和数据类中.

• 字符串模板, 带单个非常数参数的情况除外(参见 KT-42457).

要启用 invokedynamic 字符串拼接功能, 请添加 -Xstring-concat 编译器参数, 指定以下值:

• indy-with-constants, 对字符串执行 invokedynamic 拼接, 使用 StringConcatFactory.makeConcatWithConstants().

• indy: 对字符串执行 invokedynamic 拼接, 使用 StringConcatFactory.makeConcat().

• inline: 切换回原来的拼接方法, 使用 StringBuilder.append().

Gradle DSL 的变更

Kotlin/JS 的 Gradle DSL 有了很多更新, 可以简化项目的配置和自定义. 这些更新包括 webpack 配置的调整, 自动生成的 package.json 文件的修正, 以及对传递依赖的控制的改进.

browser {
    commonWebpackConfig {
        cssSupport.enabled = true
    }
    binaries.executable()
}

kotlin {
    js(BOTH) {
        compilations["main"].packageJson {
            customField("hello", mapOf("one" to 1, "two" to 2))
        }
    }
}

rootProject.plugins.withType<YarnPlugin> {
    rootProject.the<YarnRootExtension>().apply {
        resolution("react", "16.0.0")
        resolution("processor/decamelize", "3.0.0")
    }
}

rootProject.plugins.withType<YarnPlugin> {
    rootProject.the<YarnRootExtension>().disableGranularWorkspaces()
}

新的向导模板

在创建项目阶段, 为了提供更方便的方法来自定义你的项目, Kotlin 项目创建向导为 Kotlin/JS 应用程序提供了新的模板:

• Browser 应用程序 - 一个最小的 Kotlin/JS Gradle 项目, 运行在浏览器内.

• React 应用程序 - 一个 React 应用程序, 使用适当的 kotlin-wrappers. 它提供参数来集成样式表(style sheet), 导航组件, 或状态容器.

• Node.js 应用程序 - 一个最小的项目, 运行在 Node.js 环境内. 它提供参数来包含实验性的 kotlinx-nodejs 包.

IR 编译器忽略编译错误

warning

忽略编译错误 模式是 实验性功能. 这个功能随时可能抛弃或改变. 使用这个功能需要使用者同意(Opt-in)(详情请参见下文). 请注意, 只为评估和试验目的来使用这个功能. 希望你能通过我们的 问题追踪系统 提供你的反馈意见.

Kotlin/JS 的 IR 编译器 有一个新的实验性模式 - 带错误编译 模式. 在这种模式下, 即使你的代码包含错误也可以运行, 比如, 你可能希望试验某部分功能, 虽然整个应用程序还未完成.

这个模式有两种错误宽容策略:

• SEMANTIC: 编译器会接受那些语法正确, 但语义不正确的代码, 比如 val x: String = 3.

• SYNTAX: 编译器会接受任何代码, 即使包含语法错误.

要允许带错误编译, 请添加 -Xerror-tolerance-policy= 编译器参数, 指定上述值.

更多详情请参见 Kotlin/JS IR 编译器.

逃逸分析(Escape analysis)

warning

逃逸分析机制是 实验性功能. 这个功能随时可能抛弃或改变. 请注意, 只为评估和试验目的来使用这个功能. 希望你能通过我们的 问题追踪系统 提供你的反馈意见.

Kotlin/Native 有了一个新的 逃逸分析(escape analysis) 机制的原型. 它会将特定的对象分配在栈(stack)中, 而不是分配在堆(heap)中, 因此改进了运行期性能. 在我们的基准测试中, 这个机制表现出 10% 的平均性能改进, 我们还会继续改进它, 让它能够更多的提高程序运行速度.

对发布构建(release build) (使用 -opt 编译器参数), 会在单独的编译阶段中运行逃逸分析.

如果你希望禁用逃逸分析, 请使用 -Xdisable-phases=EscapeAnalysis 编译器参数.

性能改进与 bug 修复

Kotlin/Native 的很多组件有了性能改进和 bug 修复, 包括 1.4.0 中添加的部分, 比如, 代码共用机制.

包装 Objective-C 异常(需要使用者同意)

warning

Objective-C 异常包装机制是 实验性功能. 这个功能随时可能抛弃或改变. 使用这个功能需要使用者同意(Opt-in)(详情请参见下文). 请注意, 只为评估和试验目的来使用这个功能. 希望你能通过我们的 问题追踪系统 提供你的反馈意见.

Kotlin/Native 现在可以处理 Objective-C 代码在运行期抛出的异常, 避免程序崩溃.

你可以同意使用(opt in) 将 NSException 包装为 Kotlin 的 ForeignException 类型的异常. 这些异常会保存原来的 NSException 的引用. 因此你可以得到原始错误的信息, 并进行正确的处理.

要启用 Objective-C 异常的包装, 请在 cinterop 调用中指定 -Xforeign-exception-mode objc-wrap 参数, 或对 .def 文件添加 foreignExceptionMode = objc-wrap 属性. 如果你使用 CocoaPods 集成, 请在一个依赖项的 pod {} 构建脚本代码段中指定参数, 比如:

pod("foo") {
    extraOpts = listOf("-Xforeign-exception-mode", "objc-wrap")
}

不启用这个功能时, 默认行为仍然保持不变: 当 Objective-C 代码抛出异常时, 程序会终止.

CocoaPods plugin 改进

Kotlin 1.4.20 继续改进与 CocoaPods 的集成. 你可以试用以下新功能特性:

• 任务执行的改进

• DSL 扩展

• 与 Xcode 集成的更新

支持 Xcode 12 库

对随 Xcode 12 一起发布的新库, 我们添加了支持. 现在你可以在 Kotlin 代码中使用这些库.

跨平台库发布的结构更新

从 Kotlin 1.4.20 开始, 不再有单独的元数据发布. 元数据 artifact 现在包含在 root 发布之内, 它代表整个库, 并且在添加为共通源代码集的依赖项时, 会自动解析为适当的平台相关 artifact.

更多详情请参见 发布跨平台库.

用于 java.nio.file.Path 的扩展

warning

用于 java.nio.file.Path 的扩展是 实验性功能. 这个功能随时可能抛弃或改变. 使用这个功能需要使用者同意(Opt-in)(详情请参见下文). 请注意, 只为评估和试验目的来使用这个功能. 希望你能通过我们的 问题追踪系统 提供你的反馈意见.

标准库提供用于 java.nio.file.Path 的实验性的扩展. 现在可以通过符合 Kotlin 习惯的方式来使用现代的 JVM 文件 API, 与 kotlin.io 包中的 java.io.File 扩展类似.

// 使用除 (/) 操作符构造路径
val baseDir = Path("/base")
val subDir = baseDir / "subdirectory"

// 列出目录中的文件
val kotlinFiles: List<Path> = Path("/home/user").listDirectoryEntries("*.kt")

这些扩展在 kotlin-stdlib-jdk7 模块的 kotlin.io.path 包内. 要使用这些扩展, 需要对实验性的注解 @ExperimentalPathApi 标注 使用者同意(opt-in).

String.replace 函数性能改进

String.replace() 的新实现提高了这个函数的执行速度. 大小写相关的版本使用一种基于 indexOf 的手动替换循环, 大小写无关的版本使用正规表达式匹配.

废弃合成视图(synthetic view)

以前 Kotlin Android Extensions plugin 中曾有过 合成视图(synthetic view), 用来简化与 UI 元素的交互, 并减少样板代码. 现在 Google 提供了一种原生机制来完成相同的工作 - Android Jetpack 的 视图绑定, 因此我们废弃了合成视图, 请改用这个新功能.

我们从 kotlin-android-extensions 中抽取了 Parcelable 实现代码生成器, 并对这个 plugin 的其他部分(也就是合成视图)开始了废弃周期. 这些功能现在还能继续工作, 但会有废弃警告信息. 将来, 你需要为你的项目使用其他解决方案. 这里有一篇 指南, 可以帮助你将 Android 项目从合成视图(synthetic view) 迁移到视图绑定(view binding).

Parcelable 实现代码生成器的新 plugin

Parcelable 实现代码生成器移动到了新的 kotlin-parcelize plugin 中. 请使用这个 plugin 而不是原来的 kotlin-android-extensions.

note

在同一个模块中, kotlin-parcelize 和 kotlin-android-extensions 不能同时使用.

@Parcelize 注解移动到了 kotlinx.parcelize 包中.

更多详情请参见 Android 文档 中的 Parcelable 实现代码生成器.