You need to enable JavaScript to run this app. React Native升级0.63.4时bundleDebugAar因本地hermes aar报错
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 08:36:10