Kotlin 1.4.30 版中的新功能

语言功能

支持 JVM 记录类(Record)

从 1.4.30 开始, 你可以在 Kotlin 中对一个数据类使用 @JvmRecord 注解, 来声明记录类:

@JvmRecord
data class User(val name: String, val age: Int)

要试用 JVM 记录类功能的预览版, 请添加编译器选项 -Xjvm-enable-preview 和 -language-version 1.5.

封闭接口(Sealed Interface)

封闭接口可以用作 "internal" 接口, 不能在同一个模块之外实现. 你可以利用这一点来实现很多功能, 比如, 编写穷尽式(exhaustive) when 表达式.

sealed interface Polygon

class Rectangle(): Polygon
class Triangle(): Polygon

// when() 语句是穷尽式(exhaustive)的: 这个模块编译完成后, 不可能再出现其它的 polygon 实现
fun draw(polygon: Polygon) = when (polygon) {
    is Rectangle -> // ...
    is Triangle -> // ...
}

sealed interface Fillable {
   fun fill()
}
sealed interface Polygon {
   val vertices: List<Point>
}

class Rectangle(override val vertices: List<Point>): Fillable, Polygon {
   override fun fill() { /*...*/ }
}

要试用封闭接口的预览版, 请添加编译器选项 -language-version 1.5. 切换到这个版本之后, 你就可以对接口使用 sealed 修饰符了. 如果你能通过这个 YouTrack ticket 提供你的反馈意见, 我们会非常感谢.

内联类(Inline Class)的改进

由于内联类是基于值的, 因此你可以使用 value 修饰符来定义内联类. inline 和 value 修饰符现在是相互等价的. 在未来的 Kotlin 版本中, 我们计划废弃 inline 修饰符.
从现在开始, 对于 JVM 后端, Kotlin 要求在类的声明之前添加 @JvmInline 注解:
```
inline class Name(private val s: String)

value class Name(private val s: String)

// 对于 JVM 后端
@JvmInline
value class Name(private val s: String)
```

内联类可以拥有 init 代码段. 你可以添加需要在类实例创建之后立即执行的代码:

@JvmInline
value class Negative(val x: Int) {
  init {
      require(x < 0) { }
  }
}

在 Java 代码中使用内联类调用函数: 在 Kotlin 1.4.30 之前, 由于代码混淆(mangle), 你不能从 Java 代码中调用接受内联类参数的函数. 从现在开始, 你可以手动关闭代码混淆. 要从 Java 代码调用这样的函数, 你需要在函数声明前添加 @JvmName 注解:
```
inline class UInt(val x: Int)

fun compute(x: Int) { }

@JvmName("computeUInt")
fun compute(x: UInt) { }
```
在这个发布版中, 我们修改了对函数的代码混淆机制, 以便修正一些不正确的行为. 这些变更会导致 ABI 变化.
从 1.4.30 开始, Kotlin 编译器默认使用新的代码混淆机制. 可以使用 -Xuse-14-inline-classes-mangling-scheme 编译器 flag 来强制编译器使用使用旧的 1.4.0 代码混淆机制, 以保证二进制兼容性.

要试用内联类的预览版, 请添加编译器选项 -Xinline-classes 或 -language-version 1.5.

Kotlin/JVM

JVM IR 编译器后端升级为 Beta 版

Gradle:

Kotlin

Groovy

tasks.withType(org.jetbrains.kotlin.gradle.dsl.KotlinJvmCompile::class) {
  kotlinOptions.useIR = true
}

Maven:

<configuration>
    <args>
        <arg>-Xuse-ir</arg>
    </args>
</configuration>

Kotlin/Native

Kotlin/JS

Gradle 项目的改进

标准库

针对大写/小写文字的 Locale 无关 API

本次发布版增加了改变字符串和字符大小写的 Locale 无关 API (实验性功能). 现在的 toLowerCase(), toUpperCase(), capitalize(), decapitalize() API 函数是与 Locale 相关的. 也就是说, 不同的平台 Locale 设置可能影响代码的行为. 比如, 在 Turkish locale 中, 使用 toUpperCase 来转换字符串 "kotlin", 结果会是 "KOTLİN", 而不是 "KOTLIN".

// 使用现在的 API
println("Needs to be capitalized".toUpperCase()) // 结果是: NEEDS TO BE CAPITALIZED

// 使用新 API
println("Needs to be capitalized".uppercase()) // 结果是: NEEDS TO BE CAPITALIZED

对 String 函数:

以前的版本	1.4.30 的替代函数
`String.toUpperCase()`	`String.uppercase()`
`String.toLowerCase()`	`String.lowercase()`
`String.capitalize()`	`String.replaceFirstChar { it.uppercase() }`
`String.decapitalize()`	`String.replaceFirstChar { it.lowercase() }`

Char 函数:

以前的版本	1.4.30 的替代函数
`Char.toUpperCase()`	`Char.uppercaseChar(): Char` `Char.uppercase(): String`
`Char.toLowerCase()`	`Char.lowercaseChar(): Char` `Char.lowercase(): String`
`Char.toTitleCase()`	`Char.titlecaseChar(): Char` `Char.titlecase(): String`

以前的版本

1.4.30 的替代函数

Char.toUpperCase()

Char.uppercaseChar(): Char

Char.uppercase(): String

Char.toLowerCase()

Char.lowercaseChar(): Char

Char.lowercase(): String

Char.toTitleCase()

Char.titlecaseChar(): Char

Char.titlecase(): String

明确的 "字符到代码" 和 "字符到数值" 转换

目前的 Char 到数值的转换函数, 返回不同数值类型表达的 UTF-16 代码, 经常会与类似的字符串到整数值的转换混淆, 后一种转换会返回字符串表示的数值:

"4".toInt() // 返回 4
'4'.toInt() // 返回 52
// 而且没有共通函数可以对字符 '4' 返回数值 4

为了避免这样的混淆, 我们决定将 Char 转换分离为以下两组名称更加清晰的函数:

第一组的函数, 用于得到 Char 的整数代码, 以及通过指定的代码构建 Char:
```
fun Char(code: Int): Char
fun Char(code: UShort): Char
val Char.code: Int
```

第二组的函数, 将 Char 转换为它所表达的数字的整数值:

fun Char.digitToInt(radix: Int): Int
fun Char.digitToIntOrNull(radix: Int): Int?

Int 的一个扩展函数, 可以将整数表达的单个非负数字, 转换为对应的 Char 表达:
```
fun Int.digitToChar(radix: Int): Char
```

序列化库的更新

随 Kotlin 1.4.30 一起, 我们还发布了 kotlinx.serialization 1.1.0-RC, 其中包含一些新功能:

支持内联类的序列化

@Serializable
inline class Color(val rgb: Int)

更多详情请参见 kotlinx.serialization 的文档.

支持无符号基本类型(Unsigned Primitive Type)的序列化

从 1.4.30 开始, 你可以对无符号基本类型(Unsigned Primitive Type): UInt, ULong, UByte, 和 UShort, 使用 kotlinx.serialization 的标准的 JSON 序列化器:

@Serializable
class Counter(val counted: UByte, val description: String)
fun main() {
   val counted = 239.toUByte()
   println(Json.encodeToString(Counter(counted, "tries")))
}

更多详情请参见 kotlinx.serialization 的文档.

Kotlin 1.4.30 版中的新功能﻿

语言功能﻿

支持 JVM 记录类(Record)﻿

warning

封闭接口(Sealed Interface)﻿

warning

包范围内的封闭类(Sealed Class)层级结构﻿

warning

内联类(Inline Class)的改进﻿

warning

Kotlin/JVM﻿

JVM IR 编译器后端升级为 Beta 版﻿

Kotlin/Native﻿

性能改善﻿

Apple watchOS 64-bit 模拟器编译目标﻿

支持 Xcode 12.2 库﻿

Kotlin/JS﻿

顶级属性(top-level property)的延迟初始化(Lazy initialization)﻿

warning

Gradle 项目的改进﻿

支持 Gradle 配置缓存﻿

标准库﻿

针对大写/小写文字的 Locale 无关 API﻿

warning

note

明确的 "字符到代码" 和 "字符到数值" 转换﻿

warning

序列化库的更新﻿

支持内联类的序列化﻿

note

支持无符号基本类型(Unsigned Primitive Type)的序列化﻿

语言功能

支持 JVM 记录类(Record)

封闭接口(Sealed Interface)

包范围内的封闭类(Sealed Class)层级结构

内联类(Inline Class)的改进

Kotlin/JVM

JVM IR 编译器后端升级为 Beta 版

Kotlin/Native

性能改善

Apple watchOS 64-bit 模拟器编译目标

支持 Xcode 12.2 库

Kotlin/JS

顶级属性(top-level property)的延迟初始化(Lazy initialization)

Gradle 项目的改进

支持 Gradle 配置缓存

标准库

针对大写/小写文字的 Locale 无关 API

明确的 "字符到代码" 和 "字符到数值" 转换

序列化库的更新

支持内联类的序列化

支持无符号基本类型(Unsigned Primitive Type)的序列化