Gradle打包如何指定so文件？多库FFmpeg版本冲突求解

问题描述 #

构建包含两个库的Android应用时，一个库使用新版FFmpeg，另一个库的依赖使用旧版FFmpeg，打包阶段出现以下错误：

Execution failed for task ':app:mergeDebugNativeLibs'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.MergeNativeLibsTask$MergeNativeLibsTaskWorkAction
   > 2 files found with path 'lib/arm64-v8a/libavcodec.so' from inputs:

使用packagingOptions.pickFirst无法精准选中所需版本，导致出现错误匹配的情况。

可行解决办法 #

这不属于Gradle的限制，而是原生库依赖冲突的典型场景，可通过以下方案精准处理：

1. 排除冲突的依赖 #

通过Gradle的依赖排除机制，强制项目仅保留一个版本的FFmpeg：

• 先执行./gradlew app:dependencies命令查看依赖树，定位到旧版FFmpeg所属的依赖库。
• 在该依赖的声明中添加排除规则，示例：

  implementation('com.example:third-party-lib:1.0.0') {
      // 替换为实际的FFmpeg依赖组和模块名
      exclude group: 'org.ffmpeg', module: 'ffmpeg-old'
  }
  

  配置后项目会统一使用你指定的新版FFmpeg。

2. 重命名其中一个库的FFmpeg so文件 #

若冲突的库由你自行维护：

• 修改该库的FFmpeg编译脚本，将旧版so文件重命名（比如把libavcodec.so改为libavcodec-legacy.so）。
• 在该库的JNI代码中，同步修改加载库的名称：

  System.loadLibrary("avcodec-legacy");
  

  重命名后两个版本的so文件路径不再重复，打包时就不会触发冲突。

3. 精准排除错误版本的so文件 #

若无法通过依赖排除解决，可直接在packagingOptions中排除错误版本的so：

• 先解压对应的aar包，确认两个so文件分别来自哪个依赖。
• 在app模块的build.gradle中配置：

  android {
      packagingOptions {
          // 排除旧版依赖中的so文件，可根据实际情况写更精准的路径
          exclude 'lib/**/libavcodec.so'
      }
  }
  

  同时将正确版本的so文件手动放到app模块的src/main/jniLibs对应架构目录下，确保打包时能正确引入。

4. 统一FFmpeg版本 #

最彻底的解决方式是让两个库使用同一版本的FFmpeg：

• 若为自行维护的库，升级或降级其FFmpeg版本，与另一个库保持一致。
• 若为第三方库，优先选择已更新到兼容版本的迭代版，或寻找功能类似的替代库。

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