Kotlin 语言参考文档 中文版 Help

平台库

为了实现对操作系统原生服务的访问能力, Kotlin/Native 发布版包含了一组针对各个平台预先编译好的库. 这些库称为 平台库.

平台库中的包默认是可用的. 使用它们时, 不需要指定额外的链接选项. Kotlin/Native 编译器会自动检测访问了哪些平台库, 并链接需要的库.

但是, 编译器发布版中的平台库仅仅只是包装并绑定到原生的库文件. 因此你必须在你的机器上安装原生库文件本身 (.so, .a, .dylib, .dll, 等等).

POSIX 绑定

Kotlin 对所有基于 UNIX 和 Windows 的平台, 包括 Android 和 iOS, 提供了 POSIX 平台库. 这些平台库包含了与平台实现的绑定, 遵循 POSIX 标准.

要使用这个库, 请将它导入你的项目:

import platform.posix.*

你可以查看支持的各个平台的 posix.def 文件的内容:

对于 WebAssembly 平台, 不能使用 POSIX 平台库.

Kotlin/Native 提供了在不同的平台上广泛使用的各种流行的原生库的绑定, 例如 OpenGL, zlib, 和 Foundation.

在 Apple 平台, 包含了 objc 库, 以实现 与 Objective-C API 的交互.

你可以在你的编译器发布版中查看适用于 Kotlin/Native 编译目标的原生库, 查看方法根据你的设定而不同:

  • 如果你 安装了独立的 Kotlin/Native 编译器:

    1. 进入编译器发布版解包后的目录, 例如, kotlin-native-prebuilt-macos-aarch64-2.1.0.

    2. 进入 klib/platform 目录.

    3. 选择目标平台对应的文件夹.

  • 如果你在 IDE 中使用 Kotlin plugin (捆绑在 IntelliJ IDEA 和 Android Studio 中):

    1. 在你的命令行工具中, 运行以下命令, 进入 .konan 文件夹:

      ~/.konan/
      %USERPROFILE%\.konan
    2. 打开 Kotlin/Native 编译器发布版, 例如, kotlin-native-prebuilt-macos-aarch64-2.1.0.

    3. 进入 klib/platform 目录.

    4. 选择目标平台对应的文件夹.

下一步做什么

学习与 Swift/Objective-C 代码交互

2025/08/04