Kotlin Multiplatform Mobile 找不到 klib 包 可以不能

编程问答 2022-05-16

问题描述

我已经阅读了这些 SO 帖子 1、2、3，它们面临着类似的问题。我正在尝试在我的 KMM Android 项目中使用 .klib。 Klib 是从 library.h C 头文件构建的。这是我所做的：

我构建了 Kotlin 库

在 KMM shared 项目中使用以下 Gradle 块：

kotlin {
    ...
    androidNativeArm64 { // target
        compilations.getByName("main") {
            val mylib by cinterops.creating {
                defFile(project.file("mylib.def"))

                packageName("c.mylib")
                // Options to be passed to compiler by cinterop tool.
                compilerOpts("-I/home/me/CLionProjects/mylib/")

                // Directories for header search (an analogue of the -I<path> compiler option).
                includeDirs.allHeaders("/home/me/CLionProjects/mylib/")

                // A shortcut for includeDirs.allHeaders.
                includeDirs("/home/me/CLionProjects/mylib/")
            }
        }
        binaries {
            sharedLib() // https://kotlinlang.org/docs/mpp-build-native-binaries.html#declare-binaries
        }
    }
}

带有 mylib.def 个文件

headers = /home/me/CLionProjects/mylib/library.h
headerFilter = /home/me/CLionProjects/mylib/*
package = c.mylib

在构建时，.klib 和 build 文件夹出现在共享项目的 classes 目录中，如下所示：

enter image description here

Platform 下的红线表示错误：

预期的类“平台”在模块 MyApplication.shared.androidNativeArm64Main 中没有实际声明用于 Native

但显然 that may just be a system glitch （不确定 - “创建实际类...”的 Alt+Enter 解决方案似乎没有做任何事情）。假设这不是问题，我继续...

我查看了 .klib 详细信息

运行 .konan/.../bin/klib info mylib.klib 我没有得到 c.mylib 作为包名而是 com.example.myapplication:shared-cinterop-mylib（见下文）。我可以接受（虽然不知道为什么它不是我在 Gradle 中指定的）

Resolved to: /home/me/AndroidStudioProjects/MyApplication/shared/build/classes/kotlin/androidNativeArm64/main/shared-cinterop-mylib
Module name: <com.example.myapplication:shared-cinterop-mylib>
ABI version: 1.4.1
Compiler version: 1.4.10
Library version: null
Metadata version: 1.4.0
IR version: 1.0.0
Available targets: android_arm64

我尝试在我的 androidApp Gradle 中包含该软件包

我想访问我的 .klib 项目中的 androidApp。我尝试了 c.mylib 和 com.example.myapplication:shared-cinterop-mylib 两个软件包。

我尝试将 implementation("com.example.myapplication:shared-cinterop-mylib") 添加到我的 androidApp Gradle 文件中，但出现错误：

无法确定任务“:androidApp:lintVitalRelease”的依赖关系。 无法解析配置 ':androidApp:debugCompileClasspath' 的所有工件。 找不到 com.example.myapplication:shared-cinterop-mylib:。 要求： 项目：androidApp 可能的解决方案：

我不确定提示是否能解决问题，但我尝试使用例如

将该文件添加到 androidApp Gradle repositories { ... } 块 
    maven {
        url = uri("/home/me/AndroidStudioProjects/MyApplication/shared/build/classes/kotlin/androidNativeArm64/main/shared-cinterop-mylib.klib")
    }

但我不确定这是将文件添加到存储库的正确方法。

问题

谁能帮我在 androidApp 中识别包？我会继续努力的。

解决方法

您可能对针对不同平台的不同 Kotlin 版本感到困惑。请查看 the documentation 了解详细信息，而我将在这里尝试解释基本概念。

Kotlin Multiplatform 通常由三种不同的编译器组成：一种为 JVM 构建，一种用于转译为 JS，另一种用于编译特定于平台的本机二进制文件（可执行文件、静态或共享库）。 KMM 技术是关于在两个不同的平台（iOS 和 Android）之间共享您的代码。

这里的重要细节是 KMM 旨在让开发人员更容易地将这些共享代码包含到他们现有的代码库中——通常是 iOS 和 Java 的 Swift 或 Objective-C 或 Android 的 Kotlin/JVM。这很重要，因为这个项目是用 Kotlin/Native 和 Kotlin/JVM 构建的。

在您的代码中，我看到了一个额外的平台声明。 androidNativeArm64，这是一个 Kotlin/Native 目标，而不是经典的 Android 目标。它使用另一个编译器，并因此生成一个共享库。这就是为什么

  1. 您可以定义 cinterop 块，为标题创建绑定，但是
  2. 这些绑定仅作为 Kotlin/Native 编译的一部分适用。

您在此处创建的 KLIB 本身不是库，而是本机库 (mylib) 的一组绑定。它使您能够从 Kotlin 代码中使用 mylib 的 API，这些代码是在 androidNativeArm64Main 源集中编写的。由于您目前没有这样的源代码集，您的项目无法正确构建，并显示有关 missing actual declaration 的警告。

总结上述所有内容。以下是在项目的当前状态下您可以做和不能做的事情：

可以

  • 使用来自您的 Kotlin/本机代码的绑定（将文件添加到 shared/src/androidNativeArm64Main/kotlin/）
  • 使用这些绑定编译代码到共享库（.so 文件）
  • 按照 Android NDK 文档 (here) 中的说明使用此共享库

或

  • 在 shared/src/androidMain/kotlin/ 处删除 Kotlin/Native Android 目标和不使用 C API 的代码

不能

  • 依赖于 Kotlin/JVM 模块中的 KLIB（例如，一般的 androidApp 项目或 androidMain 中的 shared 源集）
  • 发布绑定并且不关心将生成的工件与 C 库链接
  • 使用从 Kotlin/Native 编译的共享或静态库比使用 C/C++ 原生库更容易（抱歉，这将是您可能在此处尽量避免使用的 JNI 内容）

对不起，回答冗长而复杂，如有任何问题，请在下面的评论部分与我联系。我很乐意纠正我的错误或不准确之处。

android-studiogradlegradlekmmkotlin-multiplatformkotlin-native