在 gradle android 库 kotlin 项目中禁用 META-INF/* 生成

Disable META-INF/* generation in gradle android library kotlin project

美好的一天。我写了一个 kotlin android 库并上传到 bintray。但是当我尝试在某些项目中使用它(通过 gradle 编译)时,它无法构建并出现以下错误:

> com.android.build.api.transform.TransformException: com.android.builder.packaging.DuplicateFileException: Duplicate files copied in APK META-INF/library_release.kotlin_module
File1: C:\Users\Charlie\.android\build-cache39fbc6b0336396c9c4912d615880645b2c729d\output\jars\classes.jar
File2: C:\Users\Charlie\OneDrive\Dev\Projects\AndroidStudio\MetuCardLib\demo\build\intermediates\bundles\default\classes.jar

我查找了这两个 .jar 文件,它们都包含 META-INF 文件夹和 library_release.kotlin_module 文件。但更重要的是生成的 .aar(android 存档发布在 bintray 中)包含这个文件夹以及这个文件。我检查了其他不错的 bintray android 库,它们似乎不包含任何 META-INF 文件。然而那些包含它的(在大多数情况下它们包含许可文件)产生相同的 DuplicateFileException 并且解决它的方法是在使用项目的 gradle 文件中明确排除它们。

这个 library_release.kotlin_module 文件有什么用,如何在发布期间禁用它的生成?因为我不想从每个使用这个库的项目中明确排除,我也不想要求其他开发人员这样做。

这是图书馆的回购协议:https://github.com/arslancharyev31/Anko-ExpandableTextView/ 它是 bintray 回购:https://bintray.com/arslancharyev31/android/Anko-ExpandableTextView

.kotlin_module 文件的最初目的是存储包部件映射到已编译的 class 文件。编译器使用它们来解析附加到项目的库中的顶级函数调用。此外,Kotlin 反射使用 .kotlin_module 文件在运行时构造顶级成员元数据。查看更多:Improving Java Interop: Top-Level Functions and Properties

鉴于此,您不想在库项目中禁用它们的生成,因为它可能会破坏对库的编译。

相反,您可以通过在您的应用 build.gradle 中使用 packagingOptions 来删除重复项,如前所述 :

android {
    // ...

    packagingOptions {
        exclude 'META-INF/library_release.kotlin_module'
    }
}

注意:从应用程序 APK 中排除这些文件会干扰运行时的反射,因此也不是最佳解决方案。


另一种选择是在您的库中使用唯一的模块名称:

compileReleaseKotlin.kotlinOptions.freeCompilerArgs += ["-module-name", "my.library.id"]

选择产生输出然后打包到 AAR 中的任务。 它可能不是 compileReleaseKotlin,同时请注意,这样做可能会影响此变体的测试编译。

或者,更可靠的是,只需选择唯一的 Gradle 模块名称,因为 Kotlin 模块是以 Gradle 项目命名的。

当更简单的模块名称发生冲突时,我可以通过将模块重命名为 uniquem 来解决此问题。

编辑:正如我们刚刚学到的那样——kotlin 模块名称应该只包含所有文件系统支持的字符。

我们在模块名称中使用了“:”,导致 jar 包含文件“company:product.kotlin_module”。这将无法在 windows.

上提取

我目前在 android 领域瘦身(在 Android gradle 插件 7.0.2 上测试)最好的解决方案是使用 android kotlin 选项部分

android{
   kotlinOptions{
      moduleName = "com.example.mylibrary"
   }
}

它导致 META-INF/com.example.mylibrary.kotlin_module - 这应该是足够独特的