Capacitor3执行npx cap run ios调试iOS真机提示App.app路径未找到报错

npx cap run ios执行部署时会按照预设路径查找构建生成的App.app安装包，路径匹配失败就会触发该报错，常见触发场景：

• 之前通过Xcode打开项目时修改了DerivedData存储位置，构建产物没有输出到Capacitor CLI默认查找的ios/DerivedData目录下
• 直接执行run命令前未完成真机架构的构建操作，对应目录下未生成Debug-iphoneos版本的App.app文件
• 项目自定义了Scheme名称，CLI默认查找App.app时无法匹配实际生成的安装包
• Xcode中对应Scheme未设置为共享状态，CLI无法读取正确的构建配置参数

按顺序操作即可：

1. 清理全量旧构建缓存，在项目根目录终端执行以下命令：

   npx cap clean ios
   rm -rf ios/DerivedData
   

2. 校准Xcode项目配置：
   • 打开ios/App/App.xcworkspace，点击顶部菜单栏 Product > Scheme > Manage Schemes，找到名称为App的Scheme，勾选右侧的Shared选项，确认其Build Configuration为Debug。
   • 打开Xcode设置页 Locations > Derived Data，如果当前选择的是Default全局存储路径，切换为Relative选项，让DerivedData默认生成在项目ios目录下，和CLI的默认查找路径对齐。
3. 拆分构建和运行步骤，不要直接执行run命令：

   # 先生成真机Debug架构的构建产物
   npx cap build ios --configuration Debug
   # 确认构建无报错后，再执行真机部署运行
   npx cap run ios
   

4. 如果之前自定义过项目Scheme名称，打开项目根目录的capacitor.config.ts/capacitor.config.json，在ios配置项中补充scheme字段，值和实际使用的Scheme名称保持一致，示例配置：

   {
     "ios": {
       "scheme": "自定义Scheme名称",
       "buildConfiguration": "Debug"
     }
   }
   

5. 兜底检查项：确认连接的iPhone已在Xcode中完成开发者信任授权，设备iOS版本不低于项目配置的最低支持版本，部署时关闭其他可能占用设备连接的工具（如第三方手机助手、同步类软件）。

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