FFmpeg Kit React Native 在 Android 上的依赖冲突解决方案

在使用 FFmpeg Kit React Native 进行视频元数据编辑时，开发者可能会遇到与其他视频处理库（如 react-native-video-trim）的依赖冲突问题。这类问题通常表现为构建 Android 应用时出现"Duplicate class"错误。

问题根源分析

这种依赖冲突的根本原因在于多个库都引入了不同版本的 FFmpeg Kit 相关包。具体来说，当项目中同时使用 FFmpeg Kit React Native 和其他基于 FFmpeg 的视频处理库时，这些库可能会引入不同配置的 FFmpeg Kit 依赖包，导致类重复定义。

典型错误表现

在构建 Android 应用时，Gradle 会报出类似以下的错误：

Duplicate class com.arthenica.ffmpegkit.xxx found in modules jetified-ffmpeg-kit-min-4.5.1 and jetified-ffmpeg-kit-https-4.5.1

解决方案

方案一：使用 ext 属性配置

在项目的 android/app/build.gradle 文件中，可以通过设置 ext 属性来指定使用特定的 FFmpeg Kit 包：

ext {
    ffmpegKitPackage = "min" // 或其他包名如"https"、"audio"等
}

方案二：模块替换方案

当 ext 属性配置无效时（通常是因为其他库强制覆盖了配置），可以采用 Gradle 的模块替换机制：

dependencies {
    modules {
        module('com.arthenica:ffmpeg-kit-https') {
            replacedBy 'com.arthenica:ffmpeg-kit-min'
        }
    }
}

这段配置告诉 Gradle 用 ffmpeg-kit-min 替换所有对 ffmpeg-kit-https 的引用，从而解决类重复定义的问题。

最佳实践建议

1. 统一依赖版本：确保项目中所有使用 FFmpeg 的库都使用相同版本的 FFmpeg Kit
2. 优先使用最小包：除非需要特定功能，否则建议使用 ffmpeg-kit-min 以减少包体积
3. 检查依赖树：使用 ./gradlew :app:dependencies 命令分析依赖关系
4. 与库维护者沟通：如果问题源于其他库的强制依赖配置，应向该库的维护者反馈

总结

处理 FFmpeg Kit 在 React Native 中的依赖冲突需要理解 Android 的依赖解析机制。通过合理配置 Gradle 的依赖替换规则，可以有效解决这类问题，同时保持应用的功能完整性。对于复杂的依赖冲突情况，建议深入分析依赖树并考虑统一项目中的 FFmpeg 相关库版本。