Kotlin/Native¶

Kotlin/Native 把 Kotlin 编译为无需虚拟机即可运行的原生二进制。它基于 LLVM 后端，并提供 Kotlin 标准库的 Native 实现。

为什么需要 Kotlin/Native¶

Kotlin/JVM 依赖 JVM，Kotlin/JS 依赖 JavaScript 环境。某些场景不适合或不能使用虚拟机：

Kotlin/Native 可以生成可执行文件、静态库、动态库，也可以生成 Apple 平台使用的 framework。

Kotlin/Native 支持多个目标，包括：

编译 Apple 目标通常需要安装 Xcode 和命令行工具。CI 上构建 iOS/macOS 目标时也需要 macOS runner。

Kotlin/Native 可以调用 C 库。通常通过 cinterop 工具读取头文件并生成 Kotlin 绑定。

示意：

val home = platform.posix.getenv("HOME")

实际项目会配置 .def 文件、头文件路径、链接参数等。适合复用已有 C 库、系统库或跨平台底层能力。

Kotlin/Native 可以生成 iOS/macOS framework，让 Swift 或 Objective-C 调用 Kotlin 代码。

典型 KMP iOS 架构：

commonMain: 业务逻辑、模型、网络抽象
iosMain: iOS 平台实现
生成 framework: 给 Swift/SwiftUI 调用

Swift 调用体验与 Kotlin API 设计密切相关。过度使用复杂泛型、协程 Flow、内联值类等特性时，Swift 暴露形态可能不够自然，需要用 facade API 包装。

Kotlin/Native 自带一些平台库，帮助访问 POSIX、Foundation、Metal、OpenGL、gzip 等平台能力。

这些库让 Kotlin 可以直接触达原生生态，但也意味着代码可能变得平台相关。平台相关代码应放在对应 source set，例如 iosMain、macosMain，不要放入 commonMain。

Kotlin/Native 使用自动内存管理，带有自己的 tracing garbage collector，并与 Swift/Objective-C 的 ARC 集成。

这比手写 C/C++ 内存管理安全得多，但仍要理解跨语言边界：

Java 开发者需要注意：

如果你的代码依赖大量 Java 生态，Kotlin/Native 不是直接替代品。它适合把 Kotlin 带到 JVM 之外的平台。

Kotlin/Native 是 Kotlin Multiplatform 的重要目标之一。常见用法不是写一个完全 Native 的应用，而是在 KMP 项目中为 iOS、macOS、Linux 等目标提供编译能力：

kotlin {
    iosArm64()
    iosSimulatorArm64()
    linuxX64()
}

公共业务逻辑放在 commonMain，Native 平台能力放在具体 source set。

适合：

不适合：