Android中aar库与应用存在同名assets文件被覆盖如何解决

首先明确前提：Android APK的assets目录不支持存在两个路径、文件名完全一致的文件，要同时保留库和主应用的同名文件，必须让二者最终在APK中的存放路径/文件名产生差异。以下是可落地的实现方案：

方案1：修改库侧assets存放路径（最推荐，无侵入性） #

该方案改造成本最低，兼容性最好，适配所有AGP版本：

• 为你的Android库的assets目录创建专属唯一子目录，推荐使用库的包名作为子目录名，将app.property放入该子目录下，最终库内文件路径为：src/main/assets/com/xxx/your_lib/app.property
• 主应用的app.property仍然保留在src/main/assets/根目录下
• 打包时二者路径完全不同，不会产生覆盖冲突，读取时分别对应各自路径即可：
  • 库内读取代码：context.assets.open("com/xxx/your_lib/app.property")
  • 主应用读取代码：context.assets.open("app.property")

方案2、3需要Android Gradle Plugin 7.0及以上版本支持

方案2：通过AGP打包配置重命名冲突文件 #

如果库侧无法修改文件路径，可以通过主应用的打包配置，在合并assets阶段自动给库中的冲突文件重命名，实现同时保留：

Groovy 写法（build.gradle） #

android {
    packagingOptions {
        assets {
            mergeRule("app.property") {
                // 主应用文件保留原文件名，依赖库中的同名文件重命名后保存
                if (it.source.type == Dependency) {
                    renameTo("library_app.property")
                } else {
                    keep()
                }
            }
        }
    }
}

Kotlin DSL 写法（build.gradle.kts） #

android {
    packagingOptions {
        assets {
            mergeRule("app.property") {
                if (source.type == MergeFileSource.Type.DEPENDENCY) {
                    renameTo("library_app.property")
                } else {
                    keep()
                }
            }
        }
    }
}

配置后打包生成的APK中，主应用的文件仍然是assets/app.property，库中的文件会被重命名为assets/library_app.property，二者可分别读取。

方案3：合并两个文件的内容（业务允许时可选） #

如果你的业务需求是最终的app.property同时包含库和主应用的配置，可以配置合并规则直接拼接两个文件的内容：

android {
    packagingOptions {
        assets {
            mergeRule("app.property") {
                merge()
            }
        }
    }
}

合并顺序为依赖库的文件内容在前，主应用的文件内容在后。

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