More than one file was found with OS independent path 'META-INF/library_release.kotlin_module'

最近在引入两个kotlin写的aar库时编译器报了这样的一个错误。说是打包时存在两个相同的文件，文件路径是META-INF/library_release.kotlin_module。

这个文件是干什么用的呢？

这就要从 kotlin 的package-level-functions说起了。

我们都知道 kotlin 支持文件级别的函数、变量申明，也就是说我们可以直接在一个文件中申明变量、方法，而不像Java，必须有一个类来承接这些定义。

每个这种有了文件级别的申明的 kotlin source file，都会默认创建一个同样命名，但首字母大写，末尾加了“Kt”后缀的class类。

比如FileExt.kt 会编译成FileExtKt.class

在Java代码中，可以通过编译后的类名访问 kotlin 申明在顶层的函数和变量。因此，在同一包名下，不支持两个命名相同的kotlin source文件。

但是，我们通过@file:JvmName("CustomName")可以显式的指定一个文件编译后的类名，或者通过@file:JvmMultifileClass指定哪几个文件共享一个类名。这就是通过注解告诉kotlin编译器，我这个文件要编译到哪个生成类中。

为了实现这个功能，kotlin专门引入了一个resource文件，用来指导kotlin的编译。

没错，这个文件就是 META-INF/<module_name>.kotlin_module.

网上有很多人解决上面的问题时，将 .kotlin_module 文件在打包流程中exclude，实际上这种做法是不正确的。

其实只需要保证module名字没有冲突，生成的.kotlin_module文件自然也就不会冲突。

在 gradle 工程中，这个文件的名字由当前工程的module名字 + build variant组成。

例如在一个 aar sdk 中，你可能会创建一个叫做 library的module 文件夹，release发布出去后，生成的aar中会带有'META-INF/library_release.kotlin_module'这个文件。

如果其他的工程也使用了相同的module name，比如另外一个aar刚好也用了library作为module名称，就会报上面的错误。

通过kotlinOptions可以指定moduleName名称。比如下面的这段代码会将moduleName修改为项目的group.artifact名字。

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.0"

    compileOptions {
        kotlinOptions.freeCompilerArgs += ['-module-name', "$PUBLISH_GROUP_ID.$PUBLISH_ARTIFACT_ID"]
    }

    defaultConfig {
        minSdkVersion 8
        targetSdkVersion 25
        versionCode 1
        versionName "1.0.5"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

注意：PUBLISH_GROUP_ID 和 PUBLISH_ARTIFACT_ID 是自定义的变量，你可以将它改为自己的项目中的具体值。

参考文章：
https://github.com/Takhion/android-extras-delegates/issues/1
https://blog.jetbrains.com/kotlin/2015/09/kotlin-m13-is-out/
http://kotlinlang.org/docs/reference/java-interop.html#package-level-functions