Skip to content

Kotlin 1.5.20 有哪些新特性

发布日期:2021 年 6 月 24 日

Kotlin 1.5.20 修复了 1.5.0 新特性中发现的问题,同时还包括各种工具改进。

你可以在发布博客文章和此视频中找到更改概述:

Kotlin/JVM

Kotlin 1.5.20 在 JVM 平台获得以下更新:

通过 invokedynamic 进行字符串连接

Kotlin 1.5.20 在 JVM 9+ 目标平台上将字符串连接编译为动态调用invokedynamic),从而与现代 Java 版本保持同步。 更精确地说,它使用 StringConcatFactory.makeConcatWithConstants() 进行字符串连接。

要切换回旧版本中通过 StringBuilder.append() 进行连接的方式,请添加编译器选项 -Xstring-concat=inline

了解如何在 GradleMaven命令行编译器中添加编译器选项。

支持 JSpecify 可空性注解

Kotlin 编译器可以读取各种类型的可空性注解,以便将可空性信息从 Java 传递给 Kotlin。1.5.20 版本引入了对 JSpecify 项目的支持,该项目包含标准统一的 Java 可空性注解集。

通过 JSpecify,你可以提供更详细的可空性信息,以帮助 Kotlin 保持空安全与 Java 互操作。你可以为声明、包或模块作用域设置默认可空性,指定参数化可空性等等。你可以在 JSpecify 用户指南中找到更多详细信息。

以下是 Kotlin 如何处理 JSpecify 注解的示例:

java
// JavaClass.java
import org.jspecify.nullness.*;

@NullMarked
public class JavaClass {
  public String notNullableString() { return ""; }
  public @Nullable String nullableString() { return ""; }
}
kotlin
// Test.kt
fun kotlinFun() = with(JavaClass()) {
  notNullableString().length // OK
  nullableString().length    // Warning: receiver nullability mismatch
}

在 1.5.20 中,根据 JSpecify 提供的可空性信息,所有可空性不匹配的情况都将报告为警告。 在使用 JSpecify 时,使用 -Xjspecify-annotations=strict-Xtype-enhancement-improvements-strict-mode 编译器选项来启用严格模式(带错误报告)。 请注意,JSpecify 项目正在积极开发中。其 API 和实现可能随时发生重大变化。

详细了解空安全和平台类型

支持在同时包含 Kotlin 和 Java 代码的模块中调用 Java 的 Lombok 生成方法

Lombok 编译器插件是实验性的。 它可能随时被废弃或更改。仅供评估目的使用。 我们非常感谢你在 YouTrack 上提供反馈。

Kotlin 1.5.20 引入了一个实验性的 Lombok 编译器插件。该插件可以在同时包含 Kotlin 和 Java 代码的模块中生成和使用 Java 的 Lombok 声明。Lombok 注解仅在 Java 源代码中有效,如果你在 Kotlin 代码中使用它们,则会被忽略。

该插件支持以下注解:

  • @Getter@Setter
  • @NoArgsConstructor@RequiredArgsConstructor@AllArgsConstructor
  • @Data
  • @With
  • @Value

我们正在继续开发此插件。要了解详细的当前状态,请访问 Lombok 编译器插件的 README

目前,我们没有支持 @Builder 注解的计划。但是,如果你在 YouTrack 中投票支持 @Builder,我们可以考虑这一点。

了解如何配置 Lombok 编译器插件

Kotlin/Native

Kotlin/Native 1.5.20 提供了新特性和工具改进的预览:

选择性导出 KDoc 注释到生成的 Objective-C 头文件

导出 KDoc 注释到生成的 Objective-C 头文件的能力是实验性的。 它可能随时被废弃或更改。 需要选择启用(详见下文),且仅供评估目的使用。 我们非常感谢你在 YouTrack 上提供反馈。

你现在可以设置 Kotlin/Native 编译器,将 Kotlin 代码中的文档注释 (KDoc) 导出到由此生成的 Objective-C 框架,使其对框架的使用者可见。

例如,以下带有 KDoc 的 Kotlin 代码:

kotlin
/**
 * Prints the sum of the arguments.
 * Properly handles the case when the sum doesn't fit in 32-bit integer.
 */
fun printSum(a: Int, b: Int) = println(a.toLong() + b)

生成以下 Objective-C 头文件:

objc
/**
 * Prints the sum of the arguments.
 * Properly handles the case when the sum doesn't fit in 32-bit integer.
 */
+ (void)printSumA:(int32_t)a b:(int32_t)b __attribute__((swift_name("printSum(a:b:)")));

这同样适用于 Swift。

要试用此将 KDoc 注释导出到 Objective-C 头文件的能力,请使用 -Xexport-kdoc 编译器选项。将以下行添加到你要导出注释的 Gradle 项目的 build.gradle(.kts) 文件中:

kotlin
kotlin {
    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget> {
        compilations.get("main").kotlinOptions.freeCompilerArgs += "-Xexport-kdoc"
    }
}
groovy
kotlin {
    targets.withType(org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget) {
        compilations.get("main").kotlinOptions.freeCompilerArgs += "-Xexport-kdoc"
    }
}

如果你能通过此 YouTrack 票证 与我们分享你的反馈,我们将不胜感激。

编译器错误修复

Kotlin/Native 编译器在 1.5.20 中收到了多项错误修复。你可以在更新日志中找到完整列表。

有一个影响兼容性的重要错误修复:在以前的版本中,包含不正确 UTF 代理对的字符串常量在编译期间会丢失其值。现在这些值被保留了。应用程序开发者可以安全地更新到 1.5.20 – 不会发生任何问题。但是,用 1.5.20 编译的库与早期编译器版本不兼容。 有关详细信息,请参见此 YouTrack 问题

改进 Array.copyInto() 在单个数组内的性能

我们改进了当 Array.copyInto() 的源和目标是同一个数组时它的工作方式。现在,由于针对此用例的内存管理优化,此类操作的完成速度提高了多达 20 倍(取决于复制对象的数量)。

Kotlin/JS

随着 1.5.20 的发布,我们正在发布一份指南,它将帮助你将项目迁移到新的基于 IR 的 Kotlin/JS 后端

JS IR 后端迁移指南

新的 JS IR 后端迁移指南指出了你在迁移过程中可能遇到的问题并提供了解决方案。如果你发现指南中未涵盖的任何问题,请向我们的问题跟踪器报告。

Gradle

Kotlin 1.5.20 引入了以下可以改善 Gradle 体验的特性:

Kapt 中注解处理器类加载器的缓存

Kapt 中注解处理器类加载器的缓存是实验性的。 它可能随时被废弃或更改。仅供评估目的使用。 我们非常感谢你在 YouTrack 上提供反馈。

现在有一个新的实验性特性,可以缓存 kapt 中注解处理器的类加载器。 此特性可以提高 kapt 在连续 Gradle 运行时的速度。

要启用此特性,请在 gradle.properties 文件中使用以下属性:

none
# positive value will enable caching
# use the same value as the number of modules that use kapt
kapt.classloaders.cache.size=5

# disable for caching to work
kapt.include.compile.classpath=false

详细了解 kapt

弃用 kotlin.parallel.tasks.in.project 构建属性

在此版本中,Kotlin 并行编译由 Gradle 并行执行标志 --parallel 控制。 使用此标志,Gradle 会并发执行任务,从而提高编译任务的速度并更有效地利用资源。

你不再需要使用 kotlin.parallel.tasks.in.project 属性。此属性已被弃用,并将在下一个主要版本中移除。

标准库

Kotlin 1.5.20 更改了多个处理字符的函数的平台特有实现,从而实现了跨平台的统一:

Kotlin/Native 和 Kotlin/JS 中 Char.digitToInt() 对所有 Unicode 数字的支持

Char.digitToInt() 返回字符所代表的十进制数字的数值。在 1.5.20 之前,该函数仅支持 Kotlin/JVM 上的所有 Unicode 数字字符:Native 和 JS 平台上的实现仅支持 ASCII 数字。

从现在起,无论在 Kotlin/Native 还是 Kotlin/JS 中,你都可以对任何 Unicode 数字字符调用 Char.digitToInt() 并获取其数字表示。

kotlin
fun main() {
    val ten = '\u0661'.digitToInt() + '\u0039'.digitToInt() // ARABIC-INDIC DIGIT ONE + DIGIT NINE
    println(ten)
}

Char.isLowerCase()/isUpperCase() 实现在跨平台上的统一

函数 Char.isUpperCase()Char.isLowerCase() 根据字符的大小写返回布尔值。对于 Kotlin/JVM,实现会同时检测 General_CategoryOther_Uppercase/Other_Lowercase Unicode 属性

在 1.5.20 之前,其他平台上的实现工作方式不同,只考虑通用类别。 在 1.5.20 中,实现已在跨平台间统一,并使用这两个属性来确定字符大小写:

kotlin
fun main() {
    val latinCapitalA = 'A' // has "Lu" general category
    val circledLatinCapitalA = 'Ⓐ' // has "Other_Uppercase" property
    println(latinCapitalA.isUpperCase() && circledLatinCapitalA.isUpperCase())
}