必须用 simctl 命令将 Xcode 编译出的 .app 文件安装到已启动的模拟器：先确认模拟器状态为 Booted，再通过终端定位 .app 路径（不可用 .ipa），执行 xcrun simctl install booted "路径"，成功后图标出现在模拟器主屏。
在没有真机或需要批量测试多个 iOS 版本时，必须把本地编译出的 .app 文件手动装进模拟器才能运行，而不能直接拖入、双击或用 App Store 安装。
确认模拟器已启动并处于 booted 状态
打开 Xcode → 顶部菜单栏选择 Window → Devices and Simulators → 切换到 “Simulators” 标签页 → 查看列表中对应设备右侧状态是否为 Booted。若为 “Shutdown”，需先选中该设备 → 点击右下角 “Create” 旁的三角形 ▶ 启动按钮。
不启动就执行安装命令会报错：Error Domain=NSPOSIXErrorDomain Code=2 “No such file or directory”。
获取你要安装的 .app 文件路径
方法一：Xcode 编译后自动定位
在 Xcode 中成功编译项目（Product → Build）→ 按住 Option 键 → 顶部菜单栏点击 Product → Show Build Folder in Finder → 进入文件夹后，逐层打开 Build → Products → Debug-iphonesimulator（或 Release-iphonesimulator）→ 找到与项目名同名的 xxx.app 文件。
方法二：终端快速查找（推荐）
打开终端，执行：find ~/Library/Developer/Xcode/DerivedData -name "*.app" -type d | grep -i "Debug-iphonesimulator"
它会列出所有模拟器架构下的 .app 路径，复制最末尾那个完整路径（含空格需加引号）。
【注意】.ipa 文件无法安装到模拟器，必须是 Xcode 针对 simulator 架构编译出的 .app 包，否则报错 code=22 或 Invalid bundle。
用 simctl 命令安装到正在运行的模拟器
第一步：确保终端能调用 xcrun 工具
运行 xcrun simctl list devices，若提示 command not found，请先执行：sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
第二步：执行安装命令
在终端输入：xcrun simctl install booted "/Users/你的用户名/Library/Developer/Xcode/DerivedData/项目名-随机串/Build/Products/Debug-iphonesimulator/项目名.app"
⚠️ 路径中若有空格或中文，必须用英文双引号包裹；路径末尾不能有斜杠 /。
第三步：验证是否安装成功
命令执行后无任何输出即为成功。回到已启动的模拟器主屏幕，向右滑动或下拉搜索，即可看到新安装的 App 图标。
第四步：启动 App（可选）
运行：xcrun simctl launch booted com.companyname.projectname
其中 com.companyname.projectname 是你在 Xcode 项目 Targets → General → Bundle Identifier 中填写的值，必须完全一致，大小写敏感。
