如何在Xcode中为自定义React Native原生模块添加本地框架?
如何为create-react-native-library创建的RN原生模块添加本地闭源框架依赖
iOS 平台配置
- 将本地闭源框架(.xcframework 或 .framework)复制到模块的
ios目录下,建议新建子目录存放,比如ios/LocalFrameworks。 - 打开模块根目录下的
.podspec文件(例如YourCustomModule.podspec),添加或修改vendored_frameworks字段,指定本地框架路径:
若使用spec.vendored_frameworks = 'ios/LocalFrameworks/YourClosedSourceFramework.xcframework'.framework格式,替换为对应路径即可。 - 保存
.podspec文件后,当其他 React Native 应用通过 CocoaPods 引入你的模块时,会自动加载该本地闭源框架。
Android 平台配置
- 将闭源的
.aar文件复制到模块的android/libs目录(若无libs目录则新建)。 - 打开模块的
android/build.gradle文件,在repositories块中添加flatDir配置,确保 Gradle 能识别本地库:repositories { flatDir { dirs 'libs' } mavenCentral() // 保留其他原有仓库配置 } - 在同一文件的
dependencies块中添加本地库依赖:dependencies { implementation files('libs/your-closed-source-lib.aar') // 保留其他原有依赖配置 } - 当 React Native 应用引入你的模块时,Gradle 会自动将该本地
.aar打包进应用。
注意事项
- 确保本地框架的架构兼容:iOS 需覆盖 arm64(真机)、x86_64(模拟器);Android 需包含目标设备对应的 ABI。
- 发布模块时,务必将本地闭源框架一同包含在模块包内,避免依赖缺失。
- 本地测试可通过
yarn link或npm link将模块链接到测试应用,验证依赖加载是否正常。
内容的提问来源于stack exchange,提问作者Mr. Robot
相关产品推荐
相关产品推荐

