[实验性 DSL] 构建最终的原生二进制文件

Kotlin/Native 编译目标会被编译为 *.klib 库的 Artifact, 这些库 Artifact 可以被 Kotlin/Native 本身用作依赖项, 但不能用作原生库.

要声明最终的原生二进制文件, 请通过 kotlinArtifacts DSL, 使用新的二进制文件格式. 它代表为这个编译目标构建的原生二进制文件的集合, 以及默认的 *.klib Artifact, 它还提供了一组方法, 用来声明和配置这些文件.

声明二进制文件

kotlinArtifacts {} 是 Gradle 构建脚本中用于 Artifact 配置的顶层代码块. 请使用以下二进制文件类型来声明 kotlinArtifacts {} DSL 的元素:

工厂方法	二进制文件类型	可用于
`sharedLib`	共享的原生库	所有的原生编译目标, `WebAssembly` 除外
`staticLib`	静态的原生库	所有的原生编译目标, `WebAssembly` 除外
`framework`	Objective-C 框架	只能用于 macOS, iOS, watchOS, 和 tvOS 编译目标
`fatFramework`	Universal fat 框架	只能用于 macOS, iOS, watchOS, 和 tvOS 编译目标
`XCFramework`	XCFramework 框架	只能用于 macOS, iOS, watchOS, 和 tvOS 编译目标

在 kotlinArtifacts 元素内, 你可以编写以下代码块:

最简单的版本需要对选择的构建类型指定 target (或 targets) 参数. 目前, 可以使用 2 个构建类型:

在 modes 参数中, 你可以指定你想要为哪个构建类型创建二进制文件. 默认值包括 DEBUG 和 RELEASE 的可执行二进制文件:

kotlinArtifacts {
    Native.Library {
        target = iosX64 // 请改为定义你的编译目标
        modes(DEBUG, RELEASE)
        // 二进制文件配置
    }
}

kotlinArtifacts {
    Native.Library("mylib") {
        // 二进制文件配置
    }
}

这里的参数是名称前缀, 用作二进制文件的默认名称. 例如, 对于 Windows, 上面的代码会 mylib.dll 文件.

配置二进制文件

名称	说明
`isStatic`	可选项, 定义库类型的链接类型. 默认值为 `false`, 库为动态库.
`modes`	可选项, 构建类型, 可指定的值是 `DEBUG` 和 `RELEASE`.
`kotlinOptions`	可选项, 编译时使用的编译器选项. 参见可用的编译器选项.
`addModule`	除当前模块外, 你还可以向输出的 Artifact 添加其他模块.
`setModules`	你可以覆盖添加到输出的 Artifact 的模块列表.
`target`	指定项目的一个特定的编译目标. 可用的编译目标名称请参见编译目标小节.

库和框架

库

kotlinArtifacts {
    Native.Library("myslib") {
        target = linuxX64
        isStatic = false
        modes(DEBUG)
        addModule(project(":lib"))
        kotlinOptions {
            verbose = false
            freeCompilerArgs += "-Xmen=pool"
        }
    }
}

以上代码注册的 Gradle 任务是 assembleMyslibSharedLibrary, 它会将所有已注册的 "myslib" 类型汇集到一个动态库.

框架

kotlinArtifacts {
    Native.Framework("myframe") {
        modes(DEBUG, RELEASE)
        target = iosArm64
        isStatic = false
        kotlinOptions {
            verbose = false
        }
    }
}

以上代码注册的 Gradle 任务是 assembleMyframeFramework, 它会汇集所有已注册的 "myframe" 框架类型.

Fat 框架

kotlinArtifacts {
    Native.FatFramework("myfatframe") {
        targets(iosX32, iosX64)
        kotlinOptions {
            suppressWarnings = false
        }
    }
}

以上代码注册的 Gradle 任务是 assembleMyfatframeFatFramework, 它会汇集所有已注册的 "myfatframe" fat 框架类型.

XCFramework

kotlinArtifacts {
    Native.XCFramework("sdk") {
        targets(iosX64, iosArm64, iosSimulatorArm64)
        setModules(
            project(":shared"),
            project(":lib")
        )
    }
}

以上代码注册的 Gradle 任务是 assembleSdkXCFramework, 它会汇集所有已注册的 "sdk" XCFramework 类型.

[实验性 DSL] 构建最终的原生二进制文件﻿

warning

note

声明二进制文件﻿

配置二进制文件﻿

库和框架﻿

库﻿

框架﻿

tip

Fat 框架﻿

tip

XCFramework﻿

tip