You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Xcode中为自定义React Native原生模块添加本地框架?

如何为create-react-native-library创建的RN原生模块添加本地闭源框架依赖

iOS 平台配置

  1. 将本地闭源框架(.xcframework 或 .framework)复制到模块的 ios 目录下,建议新建子目录存放,比如 ios/LocalFrameworks。
  2. 打开模块根目录下的 .podspec 文件(例如 YourCustomModule.podspec),添加或修改 vendored_frameworks 字段,指定本地框架路径:
    spec.vendored_frameworks = 'ios/LocalFrameworks/YourClosedSourceFramework.xcframework'
    
    若使用 .framework 格式,替换为对应路径即可。
  3. 保存 .podspec 文件后,当其他 React Native 应用通过 CocoaPods 引入你的模块时,会自动加载该本地闭源框架。

Android 平台配置

  1. 将闭源的 .aar 文件复制到模块的 android/libs 目录(若无 libs 目录则新建)。
  2. 打开模块的 android/build.gradle 文件,在 repositories 块中添加 flatDir 配置,确保 Gradle 能识别本地库:
    repositories {
        flatDir {
            dirs 'libs'
        }
        mavenCentral()
        // 保留其他原有仓库配置
    }
    
  3. 在同一文件的 dependencies 块中添加本地库依赖:
    dependencies {
        implementation files('libs/your-closed-source-lib.aar')
        // 保留其他原有依赖配置
    }
    
  4. 当 React Native 应用引入你的模块时,Gradle 会自动将该本地 .aar 打包进应用。

注意事项

  • 确保本地框架的架构兼容:iOS 需覆盖 arm64(真机)、x86_64(模拟器);Android 需包含目标设备对应的 ABI。
  • 发布模块时,务必将本地闭源框架一同包含在模块包内,避免依赖缺失。
  • 本地测试可通过 yarn link 或 npm link 将模块链接到测试应用,验证依赖加载是否正常。

内容的提问来源于stack exchange,提问作者Mr. Robot

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.10 02:35:55