1. 为什么Unity安卓打包会出现资源冲突？
当你用Unity开发安卓应用时，可能会遇到一个让人头疼的问题：打包时突然报错"More than one file was found..."。这种情况通常是因为项目中存在重复的资源文件。想象一下，你在整理房间时发现有两把一模一样的钥匙，你该用哪一把开门呢？系统遇到同样的问题时也会困惑。
问题的根源在于Unity生成的安卓项目结构。从2019.3版本开始，Unity采用了一种新的Gradle构建方式，会生成两个build.gradle文件：一个在launcher模块，另一个在unityLibrary模块。这就好比有两个管家在管理你的资源，如果他们各自为政，就会出现资源冲突。
我最近在接入某广告SDK时就遇到了这个问题。打包时系统提示有重复的properties文件，导致构建失败。经过一番排查，发现是SDK自带的资源文件与Unity默认配置产生了冲突。这种情况在接入第三方SDK时特别常见，尤其是那些包含原生安卓库的SDK。
2. 如何定位资源冲突的具体原因？
遇到打包错误时，首先要学会读懂错误信息。常见的错误提示会明确告诉你哪个文件发生了冲突，比如："More than one file was found with OS independent path 'META-INF/xxx.properties'"。这条信息已经给了我们解决问题的钥匙 - 它指出了冲突文件的具体路径。
在我的案例中，错误信息显示是com.bytedance.std.tracker.properties文件冲突。通过这个线索，我做了以下排查：
- 在Unity项目中搜索这个文件名，确认是哪个SDK引入的
- 检查Plugins/Android文件夹，看是否有重复的aar或jar包
- 用解压工具打开这些库文件，确认它们内部是否包含相同的文件
有时候问题会更隐蔽，比如不同版本的同一个库被间接引入。这时可以使用Gradle的依赖树查看命令：
./gradlew :app:dependencies这个命令会显示所有依赖关系，帮助你找出重复引入的库。记住，解决问题的第一步永远是准确定位问题。
3. 双build.gradle文件的结构解析
理解Unity生成的安卓项目结构至关重要。当你勾选"Export Project"选项时，Unity会生成一个完整的Android Studio项目，其中包含两个关键模块：
- launcher模块：相当于应用的主入口，负责启动UnityPlayerActivity
- unityLibrary模块：包含Unity引擎的核心实现和你的游戏内容
每个模块都有自己的build.gradle文件，它们的关系可以用父子来形容。launcher依赖unityLibrary，但两者都有自己的资源配置权限。这就好比一家公司有总部和分部，虽然分部隶属于总部，但在某些事务上有自主决策权。
文件位置通常如下：
你的项目/ ├── launcher/ │ └── build.gradle └── unityLibrary/ └── build.gradle在Unity编辑器中，你可以通过以下路径找到模板文件：
Assets/Plugins/Android/mainTemplate.gradle → 生成unityLibrary/build.gradle Assets/Plugins/Android/launcherTemplate.gradle → 生成launcher/build.gradle理解这个结构后，你就知道为什么只修改一个build.gradle文件可能无法解决问题了 - 因为两个模块是独立构建的，都需要进行相应配置。
4. 解决资源冲突的完整方案
现在我们来解决实际问题。针对资源冲突，Android Gradle插件提供了几种处理方式：
- exclude：完全排除指定的文件
- pickFirst：选择第一个匹配的文件，忽略后续重复项
- merge：合并重复文件（适用于某些特定类型的文件）
具体到我们的案例，需要在packagingOptions中添加排除规则。关键是要在两个模板文件中都进行修改。以下是详细步骤：
首先，确保你已经启用了Gradle模板生成：
- 打开Player Settings (Edit > Project Settings > Player)
- 找到Publishing Settings下的Build
- 勾选"Custom Gradle Template"和"Custom Launcher Manifest"
然后修改mainTemplate.gradle：
android { packagingOptions { exclude 'META-INF/gradle-plugins/com.bytedance.std.tracker.properties' // 其他需要排除的文件... } }同样地，修改launcherTemplate.gradle：
android { packagingOptions { exclude 'META-INF/gradle-plugins/com.bytedance.std.tracker.properties' // 其他需要排除的文件... } }这里有个实用技巧：如果你不确定该用exclude还是pickFirst，可以先用pickFirst让构建通过，然后再慢慢排查哪个版本的文件更适合你的项目。
5. 常见问题与进阶技巧
在实际操作中，你可能会遇到一些特殊情况。比如，有时候修改模板文件后，Unity似乎没有应用这些更改。这是因为Unity会缓存生成的Gradle项目。解决方法很简单：在修改模板文件后，执行以下操作：
- 关闭Unity
- 删除项目目录下的Temp和Library文件夹
- 重新打开Unity并打包
另一个常见问题是某些SDK会动态生成资源文件，导致每次构建时冲突的文件可能不同。针对这种情况，可以使用通配符：
exclude 'META-INF/*.properties'但要注意，这样可能会排除掉一些必要的文件，所以要谨慎使用。
对于更复杂的资源冲突，你可能需要深入了解Gradle的构建过程。比如，可以使用--info或--debug参数获取更详细的构建日志：
./gradlew assembleDebug --info这些日志会告诉你Gradle在哪个阶段遇到了资源冲突，帮助你更精准地定位问题。
6. 预防资源冲突的最佳实践
与其等到问题出现再解决，不如提前预防。以下是我总结的几个实用建议：
在接入新SDK前，先用解压工具检查它的内容，看看是否包含常见的冲突文件（如AndroidManifest.xml、META-INF下的文件等）
保持依赖库的版本统一。比如，如果你同时使用Firebase和Facebook SDK，它们可能依赖不同版本的Support库，这时应该显式指定一个统一版本：
dependencies { implementation 'com.android.support:appcompat-v7:28.0.0' // 其他依赖... }定期清理未使用的插件和库。Unity项目容易积累很多测试性的插件，它们可能是潜在的冲突源。
考虑使用Gradle的依赖约束功能，强制所有模块使用相同版本的库：
dependencies { constraints { implementation 'com.google.code.gson:gson:2.8.6' } }- 对于大型项目，建议建立自己的Gradle插件或脚本，自动处理常见的资源冲突问题。
记住，在安卓开发中，资源冲突是个常见但完全可以解决的问题。关键是要理解Gradle的构建机制，并知道在哪里进行干预。经过几次实践后，你会发现这些问题其实都有规律可循。
