一、概述

The Kotlin 2.1.20 release is here! Here are the main highlights:
Kotlin 2.1.20发布了，主要亮点如下：

• K2 compiler updates: updates to the new kapt and Lombok plugins
• Kotlin Multiplatform: new DSL to replace Gradle’s Application plugin
• Kotlin/Native: support for Xcode 16.3 and a new inlining optimization
• Kotlin/Wasm: default custom formatters, support for DWARF, and migration to Provider API
• Gradle support: compatibility with Gradle’s Isolated Projects and custom publication variants
• Standard library: common atomic types, improved UUID support, and new time-tracking functionality
• Compose compiler: relaxed restrictions on @Composable functions and other updates
• Documentation: notable improvements to the Kotlin documentation.

二、常见原子类型

在Kotlin 2.1.20中，我们在标准库的Kotlin .concurrent.atomics包中引入了公共原子类型，为线程安全操作启用了共享的、独立于平台的代码。
通过消除跨源集复制原子相关逻辑的需要，这简化了Kotlin Multiplatform项目的开发。

kotlin.concurrent.atomics包及其属性是实验性的。要选择加入，使用@OptIn（ExperimentalAtomicApi::class）注释或编译器选项-opt-in=kotlin.ExperimentalAtomicApi。

下面是一个示例，展示了如何使用AtomicInt在多个线程中安全地计数已处理的项：

示例执行效果图

@OptIn(ExperimentalAtomicApi::class)
suspend fun testExperimentalAtomicApi() {var processedItems = AtomicInt(0)val totalItems = 100val items = List(totalItems) { "item$it" }// Splits the items into chunks for processing by multiple coroutinesval chunkSize = 20val itemChunks = items.chunked(chunkSize)// chunked函数 将List分割为指定大小的子数组(List)，// itemChunks 5个数组，每个数组里有20个元素coroutineScope {for (chunk in itemChunks) {launch {for (item in chunk) {println("Processing $item in thread ${Thread.currentThread()}")processedItems.incrementAndFetch()}}}}println("processedItems = $processedItems")
}suspend fun main() {testExperimentalAtomicApi()
}

为了在Kotlin的原子类型和Java的Java .util.concurrent.atomic原子类型之间实现无缝的互操作性，API提供了. asjavaatomic（）和. askotlinatomic（）扩展函数。
在JVM上，Kotlin原子和Java原子在运行时是相同的类型，因此您可以在没有任何开销的情况下将Java原子转换为Kotlin原子，反之亦然。

下面的例子展示了Kotlin和Java原子类型是如何协同工作的：

执行示例效果图

@OptIn(ExperimentalAtomicApi::class)
fun testExperimentalAtomicApi11(){// Converts Kotlin AtomicInt to Java's AtomicIntegerval kotlinAtomic = AtomicInt(24)val javaAtomic: AtomicInteger = kotlinAtomic.asJavaAtomic()println("转换 Java atomic 原始 value: ${javaAtomic.get()}")// 转换 Java atomic 原始 value: 24javaAtomic.incrementAndGet()println("转换 Java atomic 后 自增1次 value: ${javaAtomic.get()}")// 转换 Java atomic 后 自增1次 value: 25// Converts Java's AtomicInteger back to Kotlin's AtomicIntval kotlinAgain: AtomicInt = javaAtomic.asKotlinAtomic()println("转换 Kotlin atomic 原始 value: ${kotlinAgain.load()}")//转换 Kotlin atomic 原始 value: 25kotlinAgain.incrementAndFetch()println("转换 Kotlin atomic 后 自增1次 value: ${kotlinAgain.load()}")// 转换 Kotlin atomic 后 自增1次 value: 26}suspend fun main() {testExperimentalAtomicApi11()
}

三、UUID解析、格式和可比性的变化

JetBrains团队继续在2.0.20中改进对标准库中引入的uuid的支持。

以前，parse（）函数只接受十六进制和破折号格式的uuid。在Kotlin 2.1.20中，可以对十六进制-破折号和普通十六进制（不带破折号）格式使用parse（）。

在这个版本中，我们还引入了一些特定于十六进制和破折号格式操作的函数：

• parseHexDash（）从十六进制和破折号格式解析uid。
• toHexDashString（）将Uuid转换为十六进制和破折号格式的String（镜像toString（）的功能）。

这些函数的工作方式类似于前面介绍的十六进制格式的parseHex（）和toHexString（）。解析和格式化功能的显式命名应该会提高代码的清晰度和您使用uid的总体体验。

Kotlin中的uid现在是可比的。从Kotlin 2.1.20开始，您可以直接比较和排序Uuid类型的值。这允许使用<和>操作符和标准库扩展，这些扩展专门用于Comparable类型或它们的集合（例如sorted()），并且它还允许将uuid传递给需要Comparable接口的任何函数或api。

请记住，标准库中的UUID支持仍然是实验性的。要选择加入，使用@OptIn（ExperimentalUuidApi::class）注释或编译器选项-opt-in=kotlin.uuid.ExperimentalUuidApi:：

执行示例效果图

@OptIn(ExperimentalUuidApi::class)
fun testExperimentalUuidApi(){// parse() accepts a UUID in a plain hexadecimal formatval uuid = Uuid.parse("550e8400e29b41d4a716446655440000")// Converts it to the hex-and-dash formatval hexDashFormat = uuid.toHexDashString()// Outputs the UUID in the hex-and-dash formatprintln(hexDashFormat)// 550e8400-e29b-41d4-a716-446655440000// Outputs UUIDs in ascending orderprintln(listOf(uuid,Uuid.parse("780e8400e29b41d4a716446655440005"),Uuid.parse("5ab88400e29b41d4a716446655440076")).sorted())// [550e8400-e29b-41d4-a716-446655440000, 5ab88400-e29b-41d4-a716-446655440076, 780e8400-e29b-41d4-a716-446655440005]
}fun main() {testExperimentalUuidApi()
}

四、新的时间跟踪功能

从Kotlin 2.1.20开始，标准库提供了表示某个时刻的能力。此功能以前仅在Kotlin官方库kotlinx-datetime中可用。

kotlinx.datetime.Clock接口以kotlin.time.Clock的形式引入标准库，kotlinx.datetime.Instant类以kotlin.time.Instant的形式引入标准库。这些概念很自然地与标准库中的时间包保持一致，因为与kotlinx-datetime中保留的更复杂的日历和时区功能相比，它们只关注时间中的时刻。

当您需要精确的时间跟踪而不考虑时区或日期时，Instant和Clock是有用的。例如，您可以使用它们来记录带有时间戳的事件，度量两个时间点之间的持续时间，并获得系统进程的当前时刻。

为了提供与其他语言的互操作性，可以使用额外的转换器功能：

• tokotlininstant（）将时间值转换为kotlin.time.Instant实例。
• tojavainstant（）将kotlin.time.Instant值转换为java.time.Instant值。
• Instant.toJSDate（）将kotlin.time.Instant值转换为JSDate类的一个实例。这种转换并不精确；JS使用毫秒级的精度来表示日期，而Kotlin允许纳秒级的分辨率。

标准库的新时间特性仍处于试验阶段。要选择加入，请使用@OptIn（ExperimentalTime::class）注释：

执行示例效果图

@OptIn(ExperimentalTime::class)
fun testTimeClock() {// Get the current moment in timeval currentInstant = Clock.System.now()println("Current time: $currentInstant")// Find the difference between two moments in timeval pastInstant = Instant.parse("2023-01-01T00:00:00Z")val duration = currentInstant - pastInstantprintln("Time elapsed since 2023-01-01: $duration")
}
fun main() {testTimeClock()
}