Kotlin/Native 入门
在本教程中,你将学习如何创建 Kotlin/Native 应用程序。选择最适合你的工具,并使用以下方式创建应用:
IDE。在此处,你可以从版本控制系统克隆项目模板,并在 IntelliJ IDEA 中使用它。
Gradle 构建系统。为了更好地了解底层工作原理,手动为你的项目创建构建文件。
命令行工具。你可以使用作为标准 Kotlin 分发的一部分提供的 Kotlin/Native 编译器,直接在命令行工具中创建应用。
控制台编译可能看起来简单直接,但对于拥有数百个文件和库的大型项目来说扩展性不佳。对于此类项目,我们建议使用 IDE 或构建系统。
借助 Kotlin/Native,你可以面向不同的目标平台进行编译,包括 Linux、macOS 和 Windows。虽然跨平台编译是可行的(即在一个平台上为另一个不同的平台进行编译),但在本教程中,你的目标平台将与当前编译所在的平台相同。
如果你使用的是 Mac,并且想要为 macOS 或其他 Apple 目标创建并运行应用程序,你还需要先安装 Xcode Command Line Tools,启动它并接受许可条款。
在 IDE 中
在本节中,你将学习如何使用 IntelliJ IDEA 创建 Kotlin/Native 应用程序。
创建项目
下载并安装最新版本的 IntelliJ IDEA。
在 IntelliJ IDEA 中选择 File | New | Project from Version Control,并使用以下 URL 克隆项目模板:
nonehttps://github.com/Kotlin/kmp-native-wizard打开
gradle/libs.versions.toml文件,它是项目依赖项的版本目录 (Version Catalog)。要创建 Kotlin/Native 应用程序,你需要 Kotlin Multiplatform Gradle 插件,其版本与 Kotlin 相同。请确保使用最新的 Kotlin 版本:toml[versions] kotlin = "2.4.21"按照提示重新加载 Gradle 文件:

有关这些设置的详细信息,请参阅 Multiplatform Gradle DSL 参考。
构建并运行应用程序
打开 src/nativeMain/kotlin/ 目录下的 Main.kt 文件:
src目录包含 Kotlin 源代码文件。Main.kt文件包含使用println()函数输出 "Hello, Kotlin/Native!" 的代码。
点击装订区域中的绿色图标以运行代码:

IntelliJ IDEA 使用 Gradle 任务运行代码,并在 Run 选项卡中输出结果:

首次运行后,IDE 会在顶部创建相应的运行配置:

拥有 Ultimate 订阅的 IntelliJ IDEA 用户可以安装 Native Debugging Support 插件,该插件允许调试已编译的原生可执行文件,并自动为导入的 Kotlin/Native 项目创建运行配置。
你可以配置 IntelliJ IDEA 以自动构建项目:
- 转到 Settings | Build, Execution, Deployment | Compiler。
- 在 Compiler 页面上,勾选 Build project automatically。
- 应用更改。
现在,当你对类文件进行更改或保存文件(Ctrl + S/Cmd + S)时,IntelliJ IDEA 会自动执行项目的增量构建。
更新应用程序
让我们为应用程序添加一个功能,以便计算你名字中的字母数:
在
Main.kt文件中添加读取输入代码。使用readln()函数读取输入值并将其赋值给name变量:kotlinfun main() { // 读取输入值。 println("Hello, enter your name:") val name = readln() }要使用 Gradle 运行此应用,请在
build.gradle.kts文件中指定System.in作为要使用的输入,并重新加载 Gradle 更改:runTaskProvider?.configure { standardInput = System.`in` } {...}
kotlinkotlin { //... targets.withType<KotlinNativeTarget>().configureEach { binaries { executable { entryPoint = "main" runTaskProvider?.configure { standardInput = System.`in` } } } } //... }消除空格并统计字母:
- 使用
replace()函数移除名字中的空格。 - 使用作用域函数
let在对象上下文中运行该函数。 - 使用字符串模板,通过添加美元符号
$并将其括在花括号中——${it.length},将名字长度插入到字符串中。it是 lambda 形参的默认名称。
kotlinfun main() { // 读取输入值。 println("Hello, enter your name:") val name = readln() // 统计名字中的字母数。 name.replace(" ", "").let { println("Your name contains ${it.length} letters") } }- 使用
运行应用程序。
输入你的名字并查看结果:

现在,让我们只统计你名字中的不同字母:
在
Main.kt文件中,为String声明新的扩展函数.countDistinctCharacters():- 使用
.lowercase()函数将名字转换为小写。 - 使用
toList()函数将输入字符串转换为字符列表。 - 使用
distinct()函数仅筛选出名字中的不重复字符。 - 使用
count()函数统计不重复字符的数量。
kotlinfun String.countDistinctCharacters() = lowercase().toList().distinct().count()- 使用
使用
.countDistinctCharacters()函数统计你名字中的不重复字母数:kotlinfun String.countDistinctCharacters() = lowercase().toList().distinct().count() fun main() { // 读取输入值。 println("Hello, enter your name:") val name = readln() // 统计名字中的字母数。 name.replace(" ", "").let { println("Your name contains ${it.length} letters") // 输出不重复字母的数量。 println("Your name contains ${it.countDistinctCharacters()} unique letters") } }运行应用程序。
输入你的名字并查看结果:

使用 Gradle
在本节中,你将学习如何使用 Gradle 手动创建 Kotlin/Native 应用程序。它是 Kotlin/Native 和 Kotlin Multiplatform 项目的默认构建系统,在 Java、Android 以及其他生态系统中也被广泛使用。
构建 Kotlin/Native 项目时,Kotlin Gradle 插件会下载以下工件:
- 主要的 Kotlin/Native 软件包,其中包括
konanc、cinterop和jsinterop等各种工具。默认情况下,Kotlin/Native 软件包作为普通的 Gradle 依赖项从 Maven Central 仓库下载。 konanc本身所需的依赖项,例如llvm。它们使用自定义逻辑从 JetBrains CDN 下载。
你可以在 Gradle 构建脚本的 repositories {} 块中更改主要软件包的下载源。
创建项目文件
首先,安装兼容版本的 Gradle。请参阅兼容性表,查看 Kotlin Gradle 插件 (KGP) 与可用 Gradle 版本的兼容性。
创建一个空的项目目录。在其中创建一个包含以下内容的
build.gradle(.kts)文件:kotlin// build.gradle.kts import org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget plugins { kotlin("multiplatform") version "2.4.21" } repositories { // 指定下载主要软件包的源 // 默认使用 Maven Central mavenCentral() } kotlin { macosArm64() // 在 macOS 上 // linuxArm64() // 在 Linux 上 // mingwX64() // 在 Windows 上 targets.withType<KotlinNativeTarget>().configureEach { binaries { executable() } } } tasks.withType<Wrapper> { gradleVersion = "9.7.0" distributionType = Wrapper.DistributionType.BIN }groovy// build.gradle import org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget plugins { id 'org.jetbrains.kotlin.multiplatform' version '2.4.21' } repositories { // 指定下载主要软件包的源 // 默认使用 Maven Central mavenCentral() } kotlin { macosArm64() // 在 macOS 上 // linuxArm64() // 在 Linux 上 // mingwX64() // 在 Windows 上 targets.withType(KotlinNativeTarget).configureEach { binaries { executable() } } } wrapper { gradleVersion = '9.7.0' distributionType = 'BIN' }你可以使用不同的目标名称(例如
macosArm64、iosArm64、linuxArm64和mingwX64)来定义用于编译代码的目标平台。目标名称用于在项目中生成源路径和任务名称。在项目目录中创建一个空的
settings.gradle(.kts)文件。创建
src/nativeMain/kotlin目录,并在其中放置一个包含以下内容的hello.kt文件:kotlinfun main() { println("Hello, Kotlin/Native!") }
按照约定,所有源代码都位于 src/<平台名称>[Main|Test]/kotlin 目录中,其中 Main 用于源代码,Test 用于测试。在本例中,<平台名称> 为 native。
构建并运行项目
在项目根目录下,针对你的目标运行
<yourTargetName>Binaries构建命令,例如:bash./gradlew macosArm64Binaries此命令会创建
build/bin/<yourTargetName>目录,其中包含两个子目录:debugExecutable和releaseExecutable。它们包含相应的二进制文件。默认情况下,二进制文件的名称与项目目录相同。
要运行项目,请针对你的目标执行
build/bin/<yourTargetName>/debugExecutable/<project_name>.kexe命令,例如:bashbuild/bin/macosArm64/DebugExecutable/hello.kexe
终端将输出 "Hello, Kotlin/Native!"。
在 IDE 中打开项目
现在,你可以在任何支持 Gradle 的 IDE 中打开项目。如果你使用的是 IntelliJ IDEA:
- 选择 File | Open。
- 选择项目目录并点击 Open。IntelliJ IDEA 会自动检测它是否为 Kotlin/Native 项目。
如果遇到项目问题,IntelliJ IDEA 会在 Build 选项卡中显示错误消息。
使用命令行编译器
在本节中,你将学习如何使用命令行工具中的 Kotlin 编译器创建 Kotlin/Native 应用程序。
下载并安装编译器
要安装编译器:
转到 Kotlin 的 GitHub releases 页面并向下滚动到 Assets 部分。
查找名称中包含
kotlin-native的文件,并下载适合你的操作系统的文件,例如kotlin-native-prebuilt-linux-x86_64-2.4.21.tar.gz。将归档文件解压缩到你选择的目录中。
打开你的 Shell 配置文件,将编译器
/bin目录的路径添加到PATH环境变量中:bashexport PATH="/<path to the compiler>/kotlin-native/bin:$PATH"
虽然编译器的输出产物没有依赖项或虚拟机要求,但编译器本身需要 Java 1.8 或更高版本的运行时环境。它受 JDK 8 (JAVA SE 8) 或更高版本支持。
创建程序
选择一个工作目录并创建一个名为 hello.kt 的文件。使用以下代码更新它:
fun main() {
println("Hello, Kotlin/Native!")
}从控制台编译代码
要编译应用程序,请使用下载的编译器执行以下命令:
kotlinc-native hello.kt -o hello-o 选项的值指定输出文件的名称,因此此调用在 macOS 和 Linux 上生成 hello.kexe 二进制文件(在 Windows 上生成 hello.exe)。
有关可用选项的完整列表,请参阅 Kotlin 编译器选项。
运行程序
要运行程序,请在命令行工具中导航到包含二进制文件的目录,并运行以下命令:
./hello.kexe./hello.exe应用程序会将 "Hello, Kotlin/Native" 输出到标准输出。
后续步骤
- 完成使用 C 互操作和 libcurl 创建应用教程,了解如何创建原生 HTTP 客户端并与 C 库进行互操作。
- 了解如何为实际的 Kotlin/Native 项目编写 Gradle 构建脚本。
- 在文档中详细了解 Gradle 构建系统。
