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

如何在Xcode中打开Expo React Native项目完成应用构建

核心原因

默认初始化的Expo React Native项目采用托管工作流模式,初始项目结构不会暴露ios、android原生工程目录,也不会生成Podfile这类原生配置文件,直接查找Xcode工程文件必然找不到。

操作流程

按以下步骤生成可被Xcode识别的原生iOS工程:

  • 先在项目根目录执行依赖安装,确保所有项目依赖安装完整:
    # npm 环境执行
    npm install
    # yarn 环境执行
    yarn install
    
  • 执行Expo预构建命令,该命令会自动生成全量原生工程目录、对应配置文件(包含ios目录下的Podfile):
    npx expo prebuild
    

执行预构建前建议先把当前代码提交到版本控制系统做备份,若项目之前存在自定义原生配置,避免被默认配置覆盖。命令执行过程中如果提示需要安装配套工具,直接按终端提示确认即可。

  • 预构建完成后,项目根目录会自动生成ios文件夹,进入文件夹找到后缀为.xcworkspace的文件,双击即可用Xcode打开。

注意:不要打开同目录下.xcodeproj后缀的文件,该文件未关联CocoaPods依赖,打开后会报依赖缺失错误。

  • 首次打开Xcode工程后,等待Xcode完成文件索引、依赖解析,即可正常进行构建、签名、真机调试等操作。
常见异常处理
  • 若Xcode打开后提示CocoaPods依赖缺失,进入项目下的ios目录,执行pod install重新安装iOS原生依赖,完成后重启Xcode即可。
  • 预构建命令可追加--no-install参数跳过自动依赖安装步骤,后续手动进入ios目录执行pod install效果一致。
  • 后续如果不需要本地原生工程配置,直接删除根目录下的ios、android文件夹,即可回到纯托管工作流状态,不影响Expo云端构建等能力使用。

内容的提问来源于stack exchange,提问作者Rija Shaheed

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.29 03:21:35