React-Native集成Android现有项目踩坑-

关注

转载最新推荐文章于 2026-04-02 09:00:59 发布 1.8k 阅读 AI 写同款· GEO 优化 ›

【React Native 小记】解决 Android 打包后闪退Error: E/SoLoader: couldnot find DSO to load: libhermes.so 当前使用RN版本号:0.62.2 ，将项目打包release 的 apk 时，安装后打开App闪退，完整错误如下： 2020-06-04 17:28:25.648 1375-1391/? E/SoLoader: couldn't find DSO to load: libhermes.so --------- beginning of crash 2020-06-04 17:28:25.649 1375-1391/? E/AndroidRuntime: FATAL... 阅读详情

问题1 java.lang.UnsatisfiedLinkError: couldn’t find DSO to load: libhermes.so

按照官方文档配置后启动服务yarn start，然后运行项目报以下错误

E/AndroidRuntime: FATAL EXCEPTION: create_react_context
Process: com.ado.example, PID: 25851
java.lang.UnsatisfiedLinkError: couldn't find DSO to load: libhermes.so
at com.facebook.soloader.SoLoader.doLoadLibraryBySoName(SoLoader.java:738)
at com.facebook.soloader.SoLoader.loadLibraryBySoName(SoLoader.java:591)
at com.facebook.soloader.SoLoader.loadLibrary(SoLoader.java:529)
at com.facebook.soloader.SoLoader.loadLibrary(SoLoader.java:484)
at com.facebook.hermes.reactexecutor.HermesExecutor.(HermesExecutor.java:20)
at com.facebook.hermes.reactexecutor.HermesExecutorFactory.create(HermesExecutorFactory.java:27)
at com.facebook.react.ReactInstanceManager$5.run(ReactInstanceManager.java:949)
at java.lang.Thread.run(Thread.java:818)

原因

这是因为在React Native 0.60之后，新增了Facebook自研的js引擎Hermes。没有在项目的build.gradle中配置Hermes的仓库，所以找不到so文件。使用RN创建新项目时，RN会自动为我们生成标准的build.gradle。

解决方式

修改android根目录的build.gradle

...
allprojects {
    repositories {
        mavenLocal()
        jcenter()
        maven {
            // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
            url "$rootDir/../node_modules/react-native/android"
        }
        maven {
            // Android JSC is installed from npm
            url("$rootDir/../node_modules/jsc-android/dist")
        }
        google()
    }
}
...

修改app目录的build.gradle

//最外层加上
project.ext.react = [
    enableHermes: false,  // clean and rebuild if changing
]
def jscFlavor = 'org.webkit:android-jsc:+'
def enableHermes = project.ext.react.get("enableHermes", false);

android{
  	.....
}

dependencies{
  	.....
    //在这里添加依赖配置
    if (enableHermes) {
        def hermesPath = "../../node_modules/hermes-engine/android/";
        debugImplementation files(hermesPath + "hermes-debug.aar")
        releaseImplementation files(hermesPath + "hermes-release.aar")
    } else {
        implementation jscFlavor
    }
}

点击sync now,再次运行项目，就不会报错了。

参考：https://github.com/facebook/react-native/issues/25986