必须用xcrun simctl install booted命令安装本地.app到已启动的ios模拟器;先确认模拟器状态为booted,再通过xcode或find命令获取.app完整路径(含空格需加英文双引号),.ipa不支持,安装成功后无输出且模拟器主屏可见图标。

在Mac终端中将本地编译生成的.app文件安装到已启动的iOS模拟器,是开发者调试多版本系统或离线分发测试包的刚需操作;必须用simctl命令行工具执行,不能拖拽、双击或通过App Store安装。
确认模拟器处于运行状态
打开Xcode → 顶部菜单栏选择Window → Devices and Simulators → 切换到“Simulators”标签页 → 查看目标设备右侧状态是否为【Booted】。若显示“Shutdown”,需先选中该设备,再点击右下角三角形▶启动按钮。
不启动就执行安装命令会直接报错: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"
它会列出所有匹配路径,复制最末尾那个完整路径——【含空格或中文时,必须用英文双引号包裹】。
⚠️ 注意:.ipa文件无法安装到模拟器,必须是Xcode针对simulator架构编译出的.app包,否则报错code=22或Invalid bundle。
执行安装命令
第一步:确保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图标。











