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

如何在React-Native插件中集成原生iOS Framework?解决模块缺失报错

React-Native插件第三方库无法识别的解决方案

问题根源

你将第三方库放在插件的外层iOS文件夹,npm发包时这类文件不会被纳入依赖包,且React Native iOS构建系统无法识别该路径,导致出现No such module 3rd Party Library错误。

修复步骤

  • 调整第三方库存放路径:把第三方库移到插件的ios子目录下(比如你的插件名/ios/3rdPartyLibrary),确保npm发包时能包含这些文件。
  • 修改插件的Podfile:在插件的ios/Podfile中添加库的引用,让CocoaPods能正确识别依赖:
    pod '3rdPartyLibrary', :path => './3rdPartyLibrary'
    
  • 更新package.json的文件列表:确保files字段包含iOS相关文件,防止发包遗漏:
    "files": [
      "ios/**/*",
      "android/**/*",
      "index.js"
      // 按需添加其他必要文件
    ]
    
  • 重新发布npm包:清理本地依赖后重新打包发布:
    rm -rf node_modules && npm install
    npm publish --access public
    
  • 在目标项目中重新部署:在使用插件的React Native项目里执行:
    npm install 你的插件名
    cd ios && pod install && cd ..
    

额外检查项

  • 确认第三方库的模块名与你代码中导入的名称完全一致(注意大小写)。
  • 如果是静态库,需在插件的iOS项目Build Phases中,将库添加到Link Binary With Libraries列表。

内容的提问来源于stack exchange,提问作者zaid afzal

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.01 18:55:18