React Native升级0.63.4时bundleDebugAar因本地hermes aar报错
报错根因
这是Android Gradle Plugin 4.0.1版本新增的硬性构建校验,属于历史遗留问题在新版本的集中暴露:
Library模块执行bundleDebugAar任务时,只要检测到通过files()直接依赖本地AAR,就会直接中断构建——原因是这类直连本地文件的依赖,不会在Library打AAR的过程中被合并进去,最后生成的Library AAR是残缺的:里面没有这些本地AAR带的类、资源、native库,下游集成了这个Library的应用最后打包必然出问题。你之前React Native 0.59配套的低版本AGP虽然不弹这个报错,但当时生成的Library AAR本身就是残缺的损坏状态,只是没被校验拦下来。
具体修复步骤
1. 替换触发报错的hermes本地AAR引入逻辑
你现在build.gradle.kts里最后那段直接用files()引hermes的代码,就是触发报错的源头,全部替换掉:
- 第一步,先删掉这几行旧代码:
val hermesPath = "$rootDir/node_modules/hermes-engine/android/" debugImplementation(files(hermesPath + "hermes-debug.aar")) releaseImplementation(files(hermesPath + "hermes-release.aar"))
- 第二步,在当前模块的
android代码块内,新增flatDir本地仓库配置,让Gradle可以通过依赖坐标解析本地的hermes AAR,而不是硬绑文件路径:
android { // 保留你原有所有配置,比如compileSdk、buildToolsVersion、defaultConfig这些 repositories { flatDir { dirs("$rootDir/node_modules/hermes-engine/android/") } } }
- 第三步,把原来的本地文件依赖,换成通过本地仓库解析的坐标依赖:
dependencies { // 所有原有依赖全部保持不变 // 替换原来的files()引hermes的写法,对应debug/release变体 debugImplementation(name = "hermes-debug", ext = "aar") releaseImplementation(name = "hermes-release", ext = "aar") }
2. 补Library打包的合并规则
因为你当前模块是Android Library,需要确保打AAR的时候hermes的native库不会被错误裁剪:
在android块里新增packaging配置:
android { // 原有配置保留 packagingOptions { pickFirst("**/libhermes.so") pickFirst("**/libjsc.so") } }
3. 验证构建
改完之后先清缓存再跑原来报错的任务:
./gradlew clean :myapp-react-integration:bundleDebugAar
避坑提示
- 别在根项目的全局build.gradle里加flatDir仓库,就只在这个React集成的Library模块里加,避免其他依赖误解析到本地目录的旧文件版本。
- 别把hermes依赖改成
api类型,保持implementation就好,不然容易和React Native自带的hermes依赖出现版本冲突。 - 如果构建时提示找不到hermes依赖,去
node_modules/hermes-engine/android/目录下确认实际的AAR文件名,和代码里写的name字段完全对齐就行,比如实际文件名如果是hermes.aar,就把name改成对应的值匹配变体。
内容的提问来源于stack exchange,提问作者dincojava
相关产品推荐
相关产品推荐

