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
