6.3.6 Kotlin/Native 二进制选项

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

6.3.6 Kotlin/Native 二进制选项

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

如何启用

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

在 Gradle 属性中

你可以使用 kotlin.native.binary 属性在项目的 gradle.properties 文件中设置二进制选项。例如：

kotlin.native.binary.latin1Strings=true

在你的构建文件中

你可以在 build.gradle.kts 文件中为项目设置二进制选项：

• 使用 binaryOption 属性为特定二进制文件设置。例如：

1
2
3
4
5
6
7
8
9

  kotlin {
      iosArm64 {
          binaries {
              framework {
                  binaryOption("smallBinary", "true")
              }
          }
      }
  }

• 在 freeCompilerArgs 属性中作为 -Xbinary=$option=$value 编译器选项设置。例如：

1
2
3
4
5
6
7
8
9

  kotlin {
      iosArm64 {
          compilations.configureEach {
              compilerOptions.configure {
                  freeCompilerArgs.add("-Xbinary=smallBinary=true")
              }
          }
      }
  }

在命令行编译器中

在执行 Kotlin/Native 编译器时，你可以直接在命令行中把二进制选项作为 -Xbinary=$option=$value 传入。例如：

1

kotlinc-native main.kt -Xbinary=enableSafepointSignposts=true

二进制选项

注意： 这张表并不是所有现有选项的完整列表，只列出了最值得注意的那些。

提示： 关于稳定性级别的更多信息，请参阅稳定性级别。

接下来学什么

了解如何构建最终的 native 二进制文件。