使用来自 npm 的依赖项

在 Kotlin/JS 项目中，所有依赖项都可以通过 Gradle 插件进行管理。这包括 Kotlin/Multiplatform 库，例如 kotlinx.coroutines、kotlinx.serialization 或 ktor-client。

对于来自 npm 的 JavaScript 软件包依赖，Gradle DSL 提供了一个 npm 函数，允许您指定要从 npm 导入的软件包。让我们以导入一个名为 is-sorted 的 npm 软件包为例。

Gradle 构建文件中的相应部分如下所示：

dependencies {
    // ...
    implementation(npm("is-sorted", "1.0.5"))
}

由于 JavaScript 模块通常是动态类型的，而 Kotlin 是静态类型语言，因此您需要提供一种适配器。在 Kotlin 中，此类适配器被称为外部声明 (external declaration)。对于仅提供一个函数的 is-sorted 软件包，编写该声明非常简单。在源文件夹内，创建一个名为 is-sorted.kt 的新文件，并填入以下内容：

@JsModule("is-sorted")
@JsNonModule
external fun <T> sorted(a: Array<T>): Boolean

请注意，如果您使用 CommonJS 作为目标，则需要相应地调整 @JsModule 和 @JsNonModule 注解。

现在可以像使用普通 Kotlin 函数一样使用该 JavaScript 函数。由于我们在头文件中提供了类型信息（而不是简单地将形参和返回值类型定义为 dynamic），因此还可以获得适当的编译器支持和类型检查。

console.log("Hello, Kotlin/JS!")
console.log(sorted(arrayOf(1,2,3)))
console.log(sorted(arrayOf(3,1,2)))

在浏览器或 Node.js 中运行这三行代码，输出显示对 sorted 的调用已正确映射到 is-sorted 软件包导出的函数：

Hello, Kotlin/JS!
true
false

由于 JavaScript 生态系统有多种在软件包中公开函数的方式（例如通过命名导出或默认导出），因此其他 npm 软件包可能需要略微改变其外部声明的结构。

要了解有关如何编写声明的更多信息，请参阅在 Kotlin 中调用 JavaScript。