6.3 Native 开发 on 编程那些事儿

6.3.1 Kotlin/Native

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-overview.html

6.3.1 Kotlin/Native

Kotlin/Native 是一种把 Kotlin 代码编译为无需虚拟机即可运行的原生二进制的技术。Kotlin/Native 包含基于 LLVM 的 Kotlin 编译器后端，以及 Kotlin 标准库的原生实现。

6.3.2 Kotlin/Native 入门

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-get-started.html

6.3.2 Kotlin/Native 入门

在本教程中，你将学习如何创建 Kotlin/Native 应用。请选择最适合你的工具，并通过以下方式创建应用：

IDE。在这里，你可以从版本控制系统克隆项目模板并在 IntelliJ IDEA 中使用它。
Gradle 构建系统。为更好地理解底层工作原理，你可以手动为项目创建构建文件。
命令行工具。你可以使用随标准 Kotlin 发行版一起提供的 Kotlin/Native 编译器，直接在命令行工具中创建应用。

控制台编译看起来简单直接，但对于包含数百个文件和库的较大项目，它的扩展性不好。对于这类项目，我们建议使用 IDE 或构建系统。

6.3.3 Kotlin/Native 库

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-libraries.html

6.3.3 Kotlin/Native 库

库的编译

你可以使用项目的构建文件或 Kotlin/Native 编译器为你的库生成 *.klib 产物。

使用 Gradle 构建文件

你可以在 Gradle 构建文件中指定一个 Kotlin/Native 目标来编译 *.klib 库产物：

在你的 build.gradle(.kts) 文件中声明至少一个 Kotlin/Native 目标。例如：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


 // build.gradle.kts
 plugins {
 kotlin("multiplatform") version "2.4.20"
 }

 kotlin {
 macosArm64() // 在 macOS 上
 // linuxArm64() // 在 Linux 上
 // mingwX64() // 在 Windows 上
 }

运行 <target>Klib 任务。例如：

1

 ./gradlew macosArm64Klib

Gradle 会自动为该目标编译源文件，并在项目的 build/libs 目录中生成 .klib 产物。

6.3.4 平台库

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-platform-libs.html

6.3.4 平台库

为提供对操作系统原生服务的访问，Kotlin/Native 发行版包含一组针对每个目标的预构建库。它们被称为平台库。

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

6.3.6 Kotlin/Native 二进制选项

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-binary-options.html

6.3.6 Kotlin/Native 二进制选项

本页列出有用的 Kotlin/Native 二进制选项，你可以用它们配置 Kotlin/Native 最终二进制文件，以及在项目中设置二进制选项的方式。

如何启用

你可以在 gradle.properties 文件、构建文件中启用二进制选项，也可以把它们作为编译器参数传入。

6.3.7 调试 Kotlin/Native

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-debugging.html

6.3.7 调试 Kotlin/Native

Kotlin/Native 编译器可以生成带调试信息的二进制文件，也可以创建用于符号化崩溃报告的调试符号文件。

调试信息与 DWARF 2 规范兼容，因此 LLDB 和 GDB 等现代调试器工具可以：

设置断点
使用单步执行
检查变量和类型信息

注意： 支持 DWARF 2 规范意味着调试器工具会把 Kotlin 识别为 C89，因为在 DWARF 5 规范之前，规范中还没有用于 Kotlin 语言类型的标识符。

6.3.8 Kotlin/Native 支持的目标平台和宿主

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-target-support.html

6.3.8 Kotlin/Native 支持的目标平台和宿主

本文介绍 Kotlin/Native 编译器支持哪些目标平台和宿主。

提示： 我们会根据需要调整受支持目标平台和宿主的列表、层级数量及其特性。

6.3.9 缩短编译时间的技巧

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-improving-compilation-time.html

6.3.9 缩短编译时间的技巧

Kotlin/Native 编译器不断获得改进其性能的更新。使用最新的 Kotlin/Native 编译器并正确配置构建环境，你可以显著缩短带有 Kotlin/Native 目标的项目的编译时间。

6.3.10 自定义 LLVM 后端的技巧

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-llvm-passes.html

6.3.10 自定义 LLVM 后端的技巧

高级

Kotlin/Native 编译器使用 LLVM 为不同目标平台优化并生成二进制可执行文件。编译时间中相当可观的一部分也花在 LLVM 上，对于大型应用，这可能最终耗时长得无法接受。

6.3.11 Kotlin/Native 二进制文件的许可证文件

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-binary-licenses.html

6.3.11 Kotlin/Native 二进制文件的许可证文件

与许多其他开源项目一样，Kotlin 依赖第三方代码，也就是说 Kotlin 项目包含一些并非由 JetBrains 或 Kotlin 编程语言贡献者开发的代码。有时它是衍生作品，例如从 C++ 改写成 Kotlin 的代码。

6.3.12 Kotlin/Native 常见问题

Sun, 13 Sep 2026 08:50:47 +0800

原文链接: https://kotlinlang.org/docs/native-faq.html

6.3.12 Kotlin/Native 常见问题

如何运行我的程序？

定义一个顶层函数 fun main(args: Array<String>)；如果你不关心传入的实参，也可以只写 fun main()，请确保它不在任何包中。此外，还可以使用编译器开关 -entry，把任何接收 Array<String> 或不接收参数、返回 Unit 的函数设为入口点。