WeChatQRCode项目在arm64-v8a平台上的libc++_shared.so冲突问题解析

WeChatQRCode项目在arm64-v8a平台上的libc++_shared.so冲突问题解析

WeChatQRCode ⛄ 基于OpenCV开源的微信二维码引擎移植的Android扫码识别库 项目地址: https://gitcode.com/gh_mirrors/we/WeChatQRCode

问题背景

在使用WeChatQRCode开源项目进行二维码扫描功能开发时，部分开发者在arm64-v8a平台上遇到了应用崩溃的问题。具体表现为进入扫描界面几秒钟后应用就会挂掉，同时日志中显示OpenCV无法访问特定目录的错误。

错误现象分析

从错误日志中可以观察到以下关键信息：

1. OpenCV(4.9.0)报告无法打开目录：/data/app/***/base.apk!/lib/arm64-v8a
2. 错误发生在glob.cpp文件的第279行
3. 问题出现在arm64-v8a架构的设备上

根本原因

经过深入排查，发现问题并非直接由WeChatQRCode项目本身引起，而是由于项目中同时引入了百度地图SDK，导致两个库都包含了libc++_shared.so文件，产生了动态链接库冲突。

解决方案

针对这种动态链接库冲突问题，有以下几种解决方案：

方案一：使用packagingOptions排除冲突

在app模块的build.gradle文件中添加以下配置：

android {
    packagingOptions {
        pickFirst 'lib/x86/libc++_shared.so'
        pickFirst 'lib/x86_64/libc++_shared.so'
        pickFirst 'lib/arm64-v8a/libc++_shared.so'
        pickFirst 'lib/armeabi-v7a/libc++_shared.so'
    }
}

这种方法会告诉Gradle在遇到冲突时优先选择第一个找到的libc++_shared.so文件。

方案二：手动删除冲突库

如果确定某个库的libc++_shared.so版本更稳定，可以手动删除另一个库中的对应文件。例如，如果确定WeChatQRCode的版本更可靠，可以删除百度地图SDK中的libc++_shared.so。

方案三：统一依赖版本

检查所有依赖库的版本，确保它们使用相同版本的libc++_shared.so，这样可以避免冲突。

初始化顺序优化

除了解决库冲突问题外，WeChatQRCode项目的正确使用还需要注意初始化顺序：

1. OpenCV.initOpenCV()和WeChatQRCodeDetector.init(this)必须在扫描Activity创建前完成
2. 建议在Application或主Activity中进行初始化
3. 避免在扫描Activity的onCreate方法中初始化，因为此时相机可能已经开始工作

最佳实践建议

1. 在引入多个包含原生库的SDK时，务必检查是否有重复的动态链接库
2. 定期检查依赖库的更新，新版可能已经解决了兼容性问题
3. 对于关键功能，建议在应用启动时进行预加载和初始化
4. 使用abiFilters限制支持的CPU架构，可以减少打包体积和潜在冲突

总结

在Android开发中，原生库冲突是常见问题，特别是当项目引入多个包含C++代码的第三方库时。WeChatQRCode项目中遇到的这个问题具有典型性，通过合理的配置和初始化顺序调整可以有效解决。开发者应当重视这类问题的排查和预防，确保应用的稳定运行。

WeChatQRCode ⛄ 基于OpenCV开源的微信二维码引擎移植的Android扫码识别库 项目地址: https://gitcode.com/gh_mirrors/we/WeChatQRCode