Kotlin/Wasm

Kotlin 2.3.20 改进了字符串操作的性能、编译时间和内存使用。它还添加了对实验性 @nativeInvoke 注解的支持，让你可以像调用 JavaScript 函数那样调用 Kotlin 对象或类。

改进的字符串性能

Wasm

Kotlin/Wasm 现在使用 JS String 内置对象来对 kotlin.String 值进行操作。这让 Kotlin/Wasm 能在支持该提案的浏览器和 Wasm 运行时中受益于 JavaScript 引擎的字符串优化。该优化适用于拼接、字符串插值、StringBuilder.append() 和数字到字符串转换等操作。

它带来了：

• 在针对性基准测试中，字符串插值最快提升 4.6 倍。
• 在 KotlinConf 应用构建中，Wasm 二进制体积约缩小 5%。
• 在所有 Wasm 基准测试中位数约提升 1%。
• 在大量追加操作的负载中，StringBuilder.append() 和 kotlin.String 实例拼接至少快 20%。

改进的编译时间与内存优化

Wasm

Kotlin 2.3.20 添加了编译器优化，显著减少了编译期间的内存消耗，尤其是在大型项目中。这些优化还改善了增量构建性能。

在我们的测试中，我们观察到干净构建时间提升了 65%，增量构建时间提升了 21%。

支持 @nativeInvoke 注解

实验性 Wasm

Kotlin 2.3.20 为 wasmJs 目标引入了对 @nativeInvoke 注解的支持。该注解允许你把 Kotlin 对象或类视为 JavaScript 中的函数。它的设计目的是把 external 声明（类或接口）的成员函数标记为 JavaScript 对象的“调用运算符”。

当你注解某个函数时，Kotlin 中对它的每次调用都会被翻译为对 JavaScript 对象本身的直接调用：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

import kotlin.js.nativeInvoke

@OptIn(ExperimentalWasmJsInterop::class)
external class JsAction {
    @nativeInvoke
    operator fun invoke(data: String)
}

fun main() {
    val action = JsAction()
    action("Run task")
}

这是在设计出 Kotlin/Wasm 与 JavaScript 之间的稳定互操作之前的临时方案。它可能在未来的版本中被修改或移除，使用它时编译器会报告警告。

有关 Kotlin/Wasm 与 JavaScript 互操作的更多信息，请参见与 JavaScript 的互操作。

Kotlin/JS

Kotlin 2.3.20 使从 TypeScript 实现 Kotlin 接口成为可能，并引入了对 SWC 编译平台的实验性支持。

从 JavaScript/TypeScript 实现 Kotlin 接口

实验性 Js

Kotlin 2.3.20 取消了在 JavaScript/TypeScript 一侧实现 Kotlin 接口的限制。以前只能把 Kotlin 接口作为 TypeScript 接口导出到 TypeScript，禁止从 TypeScript 实现它们。

现在你可以按以下方式实现任何 Kotlin 接口：

1
2
3
4
5
6
7
8

// Kotlin
@JsExport
interface DataProcessor {
    suspend fun process(): String
}

@JsExport
fun registerProcessor(processor: DataProcessor) { ... }

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

// TypeScript
import { DataProcessor, registerProcessor } from "my-kmp-library"

class JsonProcessor implements DataProcessor {
    readonly [DataProcessor.Symbol] = true

    async process(): Promise<string> {
        return "processed JSON data"
    }
}

registerProcessor(new JsonProcessor())

也可以从 TypeScript 复用 Kotlin 的默认实现。尽管 TypeScript 没有接口默认实现的概念，你可以通过委托给 DefaultImpls 对象来绕过这一限制：

1
2
3
4
5
6

// Kotlin
@JsExport
interface Logger {
    fun log(): String = "[INFO] Default log entry"
    val prefix: String get() = "LOG"
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

// TypeScript
import { Logger, acceptLogger } from "my-kmp-library"

class ConsoleLogger implements Logger {
    readonly [Logger.Symbol] = true

    // 委托给默认方法实现
    log(): string {
        return Logger.DefaultImpls.log(this);
    }

    // 委托给默认属性实现
    get prefix(): string {
        return Logger.DefaultImpls.prefix.get(this);
    }
}

acceptLogger(new ConsoleLogger())

如何启用

在你的构建文件中，添加新的编译器选项：

1
2
3
4
5
6
7
8
9

kotlin {
    js {
        // ...
        generateTypeScriptDefinitions()
        compilerOptions {
            freeCompilerArgs.add("-Xenable-implementing-interfaces-from-typescript")
        }
    }
}

更多信息请参见 @JsExport 注解。

支持 SWC 编译平台

实验性 Js

从 Kotlin 2.3.20 开始，Kotlin/JS 支持 SWC 编译平台。它有助于把较新版本的 JavaScript/TypeScript 代码转译为更旧、兼容性更好的 JavaScript 代码。

把代码转换交给外部工具，使我们能够减少 Kotlin/JS 编译器产出的变体数量，并加快编译器的现代化进程，只需专注于支持最新的 JavaScript 特性。目前，受支持的最新 ECMAScript 版本仍是 es2015。

此外，把转译工作交出去还让我们能够改进内联 JavaScript 特性。目前它只支持 ES5 语法（这将在 2.4.0 中改变）。在面向更低版本的同时支持更新的语法会很困难，因为这要求编译器转译内联 JS 块内部的 JS 代码。有了 SWC，我们将能够添加现代 JS 语法，该工具会把代码转译为终端用户版本所需的语法。

迁移到 SWC 还让你有机会在 Kotlin Gradle 插件内实现基于 browserlist 的 DSL。这让你可以声明目标浏览器或环境，而不是具体的 JS 版本。

如何启用

在你的 gradle.properties 文件中，添加以下选项：

1

kotlin.js.delegated.transpilation=true

我们计划在未来的 Kotlin 版本中稳定通过 SWC 进行的转译。在它成为默认方式之后，编译多个 JS 目标的功能将完全从 Kotlin/JS 编译器委托给转译器。

有关 SWC 平台的更多信息，请参见官方文档。

Gradle

Kotlin 2.3.20 与新版 Gradle 兼容，并包含对 Kotlin Gradle 插件中 Kotlin/JVM 编译的变更。

兼容 Gradle 9.3.0

Gradle

Kotlin 2.3.20 与 Gradle 7.6.3 到 9.3.0 完全兼容。你也可以使用最新 Gradle 版本以内的其他版本。不过请注意，这样做可能会产生弃用警告，并且某些新的 Gradle 特性可能无法工作。

KGP 中二进制兼容性验证的改进

Gradle

Kotlin 2.2.0 首次带来了 Kotlin Gradle 插件中的二进制兼容性验证支持。Kotlin 2.3.20 添加了两项改进。

首先，二进制兼容性验证 Gradle 任务的名称中不再包含 “Legacy”。我们做这一改动是因为旧的命名约定让 Kotlin 开发者感到困惑：

| 旧名称 | 新名称 |

| checkLegacyAbi | checkKotlinAbi | | updateLegacyAbi | updateKotlinAbi | | dumpLegacyAbi | internalDumpKotlinAbi |

旧的任务名称在 Kotlin 2.3.20 中仍然存在，以便向新名称过渡。

其次，如果你在项目中启用了二进制兼容性验证，现在当你运行 check 任务时，Gradle 会自动运行 checkKotlinAbi 任务。以前，即使 check 任务本应运行所有验证任务，Gradle 也不会运行 checkKotlinAbi 任务。这导致 Gradle 项目中的行为不一致。

Kotlin/JVM 编译默认使用 Build tools API

实验性 - 通用 Gradle

在 Kotlin 2.3.20 中，Kotlin Gradle 插件中的 Kotlin/JVM 编译默认使用 Build tools API（BTA）。这一内部编译基础设施的变更使 Kotlin 编译器的构建工具支持能够更快地发展。

如果你发现任何问题，请在我们的问题跟踪器中分享你的反馈。

Maven

Kotlin 2.3.20 带来了一个重要的变更，使 Maven 项目的配置更容易。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

val operation = toolchains.jvm.jvmCompilationOperationBuilder(sources, destination) {}

toolchains.createBuildSession().use {
    try {
        it.executeOperation(operation.build())
    } catch (e: OperationCancelledException) {
        println("Build operation has been cancelled.")
    }
}

// ...

// 从另一个线程：
operation.cancel()

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

fun prepareBuildOperation(toolchains: KotlinToolchains, sources: List<Path>, destination: Path): JvmCompilationOperation {
    val builder = toolchains.jvm.jvmCompilationOperationBuilder(sources, destination)

    // 使用构建器配置该操作
    builder.compilerArguments[CommonToolArguments.VERBOSE] = true
    builder[COMPILER_ARGUMENTS_LOG_LEVEL] = CompilerArgumentsLogLevel.ERROR

    // 返回不可变操作
    return builder.build()
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

val operation =
    kotlinToolchains.jvm.jvmCompilationOperationBuilder(sources, outputDirectory)
operation[BuildOperation.METRICS_COLLECTOR] = object : BuildMetricsCollector {
    override fun collectMetric(
        name: String,
        type: BuildMetricsCollector.ValueType,
        value: Long
    ) {
        // ...
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

import org.jetbrains.kotlin.buildtools.api.KotlinToolchains
import org.jetbrains.kotlin.buildtools.api.arguments.CompilerPlugin
import org.jetbrains.kotlin.buildtools.api.arguments.CompilerPluginOption
import org.jetbrains.kotlin.buildtools.api.arguments.CommonCompilerArguments.Companion.COMPILER_PLUGINS
import org.jetbrains.kotlin.buildtools.api.arguments.CompilerPlugin
import org.jetbrains.kotlin.buildtools.api.arguments.CompilerPluginOption
import org.jetbrains.kotlin.buildtools.api.jvm.JvmPlatformToolchain
import org.jetbrains.kotlin.buildtools.api.jvm.JvmPlatformToolchain.Companion.jvm
import org.jetbrains.kotlin.buildtools.api.jvm.operations.JvmCompilationOperation
import java.nio.file.Path

...

val toolchains: KotlinToolchains = ...
val jvmToolchain: JvmPlatformToolchain = toolchains.jvm
val operation: JvmCompilationOperation.Builder = jvmToolchain.jvmCompilationOperationBuilder(...)
val noArgPluginClasspath: List<Path> = ...
operation.compilerArguments[COMPILER_PLUGINS] = listOf(
    CompilerPlugin(
        pluginId = "org.jetbrains.kotlin.noarg",
        classpath = noArgPluginClasspath,
        rawArguments = listOf(CompilerPluginOption("annotation", "GenerateNoArgsConstructor")),
        orderingRequirements = emptySet(),
    )
)