Ionic Capacitor构建iOS生成空Xcode工作区问题求助

问题描述 #

将Ionic应用从Cordova迁移到Capacitor，遵循官方指南操作，但执行ionic capacitor build ios后生成的Xcode工作区为空，使用全新启动模板也能复现该问题。ionic serve运行正常，Windows端Android构建无异常。

复现步骤 #

# 基于Angular和Capacitor创建新项目
ionic start

# 执行iOS构建命令
ionic cap build ios

关键输出提示：

[capacitor] [warn] Skipping pod install because CocoaPods is not installed

执行ionic cap run ios时触发报错：

capacitor run ios --target XXXX-XXXX

错误核心信息：

xcodebuild: error: The workspace named "App" does not contain a scheme named "App". The "-list" option can be used to find the names of the schemes in the workspace.

打开App.xcodeproj手动构建时，报错：

Unable to open base configuration reference file '.../test/ios/App/Pods/Target Support Files/Pods-App/Pods-App.debug.xconfig'

环境信息 #

• 设备：全新Mac mini
• macOS版本：Sonoma 14.5
• Xcode版本：15.3
• 依赖版本：

Ionic CLI                     : 7.2.0
Ionic Framework               : @ionic/angular 8.2.1
@angular/cli                  : 18.0.3
Capacitor CLI      : 6.0.0
@capacitor/ios     : 6.0.0
NodeJS : v22.2.0
npm    : 10.7.0

解决方案 #

核心原因 #

缺少iOS依赖管理工具CocoaPods，导致Capacitor无法正确生成Pod依赖配置，进而引发Xcode工作区异常、Scheme缺失和配置文件找不到的问题。

解决步骤 #

1. 安装CocoaPods
   打开终端执行以下命令（二选一即可）：

   # 通过Ruby Gem安装
   sudo gem install cocoapods
   
   # 或通过Homebrew安装（若Gem安装失败）
   brew install cocoapods
   

2. 重新同步Capacitor项目
   进入项目根目录，依次执行：

   # 重新构建Web资源
   ionic build
   # 同步iOS项目并执行Pod安装
   ionic cap sync ios
   # 打开Xcode工作区
   ionic cap open ios
   

3. 验证并配置Scheme
   打开Xcode后，点击顶部菜单栏 Product > Scheme > Manage Schemes，确认App scheme已存在并勾选Shared选项，之后即可正常构建项目。

内容的提问来源于stack exchange，提问作者user25454505