Android Gradle插件生成native library的Kotlin Native编译咨询

方案1：对接Kotlin Multiplatform插件内置的K/N编译链（推荐） #

不需要手动调用Kotlin Native编译器二进制，Kotlin官方KMP插件已经封装了全链路K/N编译逻辑，你只需要在自定义插件里做源集配置和任务依赖绑定即可：

• 插件逻辑中先检测项目是否已应用org.jetbrains.kotlin.multiplatform插件，未应用时自动补充应用，注意KMP插件版本必须和项目当前使用的Kotlin版本完全对齐，避免版本冲突
• 遍历所有Android Native目标ABI对应的Kotlin编译任务，将你代码生成任务的输出目录加入对应编译任务的源集路径，参考配置代码：

// 自定义插件内的配置代码
project.plugins.withId("org.jetbrains.kotlin.multiplatform") {
    val kmpExt = project.extensions.getByType(KotlinMultiplatformExtension::class.java)
    // 匹配所有Android平台的Native编译目标
    kmpExt.targets.withType(KotlinNativeTarget::class.java)
        .matching { it.platformType.name.equals("androidNative", ignoreCase = true) }
        .all { target ->
            target.compilations.getByName("main") {
                // 把生成代码的目录加入K/N编译源集
                it.defaultSourceSet.kotlin.srcDir(codeGenerateTaskProvider.flatMap { it.outputDir })
            }
            // 配置产物为共享so库
            target.binaries.sharedLib()
        }
    // 绑定任务依赖：保证先生成代码，再执行Native编译
    listOf("Arm64", "Arm32", "X64", "X86").forEach { abi ->
        project.tasks.named("compileKotlinAndroidNative$abi").configure {
            it.dependsOn(codeGenerateTaskProvider)
        }
    }
    // 将编译生成的so文件目录加入Android JNI资源目录，构建时自动打包进APK
    val androidExt = project.extensions.getByType(AndroidExtension::class.java)
    androidExt.sourceSets.getByName("main").jniLibs.srcDir(
        kmpExt.targets.withType(KotlinNativeTarget::class.java)
            .matching { it.platformType.name.equals("androidNative", ignoreCase = true) }
            .map { it.binaries.getSharedLib("release").outputDirectory }
    )
}

• 该方案自动支持增量编译、构建缓存，不需要自己处理编译器下载、ABI适配、NDK链接等底层逻辑，维护成本最低。

方案2：直接调用Konanc编译器执行编译（无KMP依赖场景用） #

如果你的插件不想强依赖KMP插件，可以直接调用Gradle缓存中已下载的Kotlin Native编译器（konanc）执行编译：

• 编译器路径定位：项目应用Kotlin插件后，对应版本的K/N编译器会自动下载到Gradle缓存目录，路径规则为${gradle.gradleUserHomeDir}/caches/modules-2/files-2.1/org.jetbrains.kotlin/kotlin-native-prebuilt/<项目使用的Kotlin版本>/<文件hash>/kotlin-native/bin/konanc，Windows环境后缀为.bat
• 用Gradle内置的Exec任务类型封装编译逻辑，核心编译命令参考：

konanc <生成代码目录>/*.kt \
  -target android_arm64 \ # 替换为对应ABI的target：android_arm32/android_x64/android_x86
  -shared \
  -Xbinary=enableAndroidJni=true \ # 生成符合JNI规范的导出符号
  -konan-home=<K/N编译器根目录> \
  -linker-option "-L<NDK对应平台的sysroot库路径>" \
  -o <输出目录>/lib<库名>.so

• 该方案需要自行处理的逻辑：
  • 不同ABI的target参数映射
  • Android NDK路径获取、sysroot库路径配置，避免链接阶段找不到系统库
  • 增量编译判断、输入输出声明，否则每次全量编译会大幅拖慢构建速度
  • 编译产物的ABI拆分、jniLibs目录挂载

避坑提示 #

• 禁止硬编码Kotlin/Native版本，必须读取项目当前声明的Kotlin版本匹配编译器，否则会出现编译器版本与stdlib版本不匹配的运行时崩溃
• K/N编译生成的so库默认不会导出Java可调用的JNI符号，必须加-Xbinary=enableAndroidJni=true编译参数
• 用方案1时不要手动修改K/N编译任务的输出路径，否则会破坏KMP插件的增量缓存逻辑，导致每次构建都触发全量重编译

内容的提问来源于stack exchange，提问作者timemanx