在 RN 中启用
Hermes 引擎

React Native 0.70 及以上版本已默认拥抱性能新纪元。无论您是创建新项目,还是为现有工程注入动力,只需简单几步配置,即可实现毫秒级启动与极致流畅的 JavaScript 体验。

开始接入指南

RN 0.70+ 支持

底层架构原生集成,无需引入额外依赖包即可开启 AOT 预编译。

无缝替换

通过修改全局参数,自动接管 JSC 引擎的工作流,降低内存碎片。

Android 端接入指南

1修改 gradle 配置

通过修改项目属性文件,实现 Android 工程对 Hermes 引擎的无缝替换。定位到工程根目录下的 android/gradle.properties 文件。

# 找到 hermesEnabled 标志并将其设置为 true # 如果没有该字段,请手动添加 hermesEnabled=true

2清理并重建缓存

配置更改后,必须清理旧的构建缓存以确保新引擎被正确链接。在终端中进入 android 目录执行清理命令。

# 进入 android 目录 cd android # 清理构建缓存 ./gradlew clean # 返回根目录并重新运行 cd .. npx react-native run-android

iOS 端配置流程

1更新 Podfile 参数

为苹果工程注入 Hermes 动力,需要修改 CocoaPods 配置文件。打开 ios/Podfile,定位到 `use_react_native!` 模块。

# 将 hermes_enabled 标志设置为 true use_react_native!( :path => config[:reactNativePath], :hermes_enabled => true, # <-- 开启此项 # ... 其他配置 )

2重装依赖与验证

修改保存后,需要重新安装 Pod 依赖。系统会自动下载并编译 Hermes 引擎框架。

# 进入 ios 目录 cd ios # 安装依赖包 pod install # 返回根目录并启动 iOS 模拟器 cd .. npx react-native run-ios

验证引擎运行状态

接入完成后,建议在应用首屏添加代码片段以确认当前是否已由 Hermes 接管。您也可以通过 React Native Debugger 的网络面板查看引擎标识。

import { Text, View } from 'react-native'; const App = () => { // 通过全局变量检测 Hermes 是否就绪 const isHermes = () => !!global.HermesInternal; return ( <View> <Text>Engine: {isHermes() ? 'Hermes' : 'JSC'}</Text> </View> ); };
© 2026 Hermes Digital. 保留所有权利。由开源社区驱动的高性能JS引擎。 Designed for React Native