Kotlin/Native 常见问题解答

如何运行我的程序？

定义一个顶层函数 fun main(args: Array<String>)，或者如果你对传入的实参不感兴趣，则定义 fun main()，请确保它不位于任何包中。 此外，还可以使用编译器选项 -entry 将任何接受 Array<String> 或不接受实参并返回 Unit 的函数设置为入口点。

Kotlin/Native 的内存管理模型是什么？

Kotlin/Native 采用一种自动化内存管理方案，与 Java 或 Swift 提供的类似。

了解 Kotlin/Native 内存管理器

如何创建共享库？

使用 -produce dynamic 编译器选项或在你的 Gradle 构建文件中使用 binaries.sharedLib()：

kotlin {
    iosArm64("mylib") {
        binaries.sharedLib()
    }
}

它会生成一个平台特有的共享对象（在 Linux 上是 .so，在 macOS 上是 .dylib，在 Windows 目标平台上是 .dll）和一个 C 语言头文件，允许 C/C++ 代码使用你的 Kotlin/Native 程序中所有可用的公共 API。

完成 Kotlin/Native 作为动态库教程

如何创建静态库或对象文件？

使用 -produce static 编译器选项或在你的 Gradle 构建文件中使用 binaries.staticLib()：

kotlin {
    iosArm64("mylib") {
        binaries.staticLib()
    }
}

它会生成一个平台特有的静态对象（.a 库格式）和一个 C 语言头文件，允许你使用 Kotlin/Native 程序中所有可用的公共 API。

如何在企业代理后运行 Kotlin/Native？

由于 Kotlin/Native 需要下载平台特有的工具链，你需要将 -Dhttp.proxyHost=xxx -Dhttp.proxyPort=xxx 指定为编译器或 gradlew 的实参，或者通过 JAVA_OPTS 环境变量进行设置。

如何为我的 Kotlin framework 指定自定义的 Objective-C 前缀/名称？

使用 -module-name 编译器选项或匹配的 Gradle DSL 语句。

KotlinGroovy

kotlin {
    iosArm64("myapp") {
        binaries.framework {
            freeCompilerArgs += listOf("-module-name", "TheName")
        }
    }
}

kotlin {
    iosArm64("myapp") {
        binaries.framework {
            freeCompilerArgs += ["-module-name", "TheName"]
        }
    }
}

如何重命名 iOS framework？

iOS framework 的默认名称是 <项目名>.framework。 要设置自定义名称，请使用 baseName 选项。这也会设置模块名称。

kotlin {
    iosArm64("myapp") {
       binaries {
          framework {
              baseName = "TheName"
          }
       }
    }
}

如何为我的 Kotlin framework 启用 Bitcode？

Bitcode 嵌入在 Xcode 14 中已弃用，并在 Xcode 15 中针对所有 Apple 目标平台移除。 Kotlin/Native 编译器自 Kotlin 2.0.20 起不再支持 Bitcode 嵌入。

如果你正在使用较早版本的 Xcode 但希望升级到 Kotlin 2.0.20 或更高版本，请在你的 Xcode 项目中禁用 Bitcode 嵌入。

如何安全地从不同的协程引用对象？

要在 Kotlin/Native 中安全地跨多个协程访问或更新对象，请考虑使用并发安全的构造，例如 @Volatile 和 AtomicReference。

使用 @Volatile 注解 var 属性。这使得对该属性幕后字段的所有读写都成为原子操作。此外，写入会立即对其他线程可见。当其他线程访问此属性时，它不仅会观察到更新后的值，还会观察到在更新之前发生的所有更改。

或者，使用 AtomicReference，它支持原子读写和更新。在 Kotlin/Native 上，它封装了一个 volatile 变量并执行原子操作。Kotlin 还提供了一组针对特定数据类型量身定制的原子操作类型。你可以使用 AtomicInt、AtomicLong、AtomicBoolean、AtomicArray，以及 AtomicIntArray 和 AtomicLongArray。

有关访问共享可变状态的更多信息，请参阅协程文档。

如何使用未发布的 Kotlin/Native 版本编译我的项目？

首先，请考虑尝试抢先体验预览版本。

如果你需要更近期的开发版本，你可以从源代码构建 Kotlin/Native：克隆 Kotlin 版本库并遵循这些步骤。