如何用VS Mac或Rider调试带配套iOS应用的WatchOS应用？

一、标准调试流程 #

• 确保Xcode为最新稳定版，模拟器的iOS/WatchOS版本与项目部署目标完全匹配
• 提前完成模拟器配对：打开Xcode → Window → Devices and Simulators，选中目标iPhone模拟器，在右侧Pair with watch下拉选择对应Watch模拟器，等待配对完成（Watch模拟器会自动启动并显示已连接）
• 在Rider/VS Mac中，将运行目标设置为已配对的iPhone模拟器（不要选单独的Watch模拟器）
• 启动调试：iOS应用会先安装到iPhone模拟器，随后WatchOS应用会自动推送至配对的Watch模拟器，全程不要手动操作模拟器

二、针对你遇到的问题的解决办法 #

1. 调试时Watch模拟器断开连接 #

• 调试启动过程中不要手动关闭/重启Watch模拟器，Rider/VS Mac会自动管理模拟器状态，手动干预会导致连接中断
• 检查配置匹配：确保WatchOS应用Info.plist中的WKCompanionAppBundleIdentifier与iOS应用Info.plist的CFBundleIdentifier完全一致
• 清理项目缓存：执行Clean Solution（VS Mac）或Clean（Rider），删除项目目录下的bin和obj文件夹后重新构建

2. Watch模拟器提示“存储已满”导致安装失败 #

• 彻底重置Watch模拟器：打开Watch模拟器 → Hardware → Erase All Content and Settings，重置完成后重新与iPhone模拟器配对
• 清理模拟器存储：在Xcode的Devices and Simulators中选中Watch模拟器，右键选择Show in Finder，删除文件夹内的旧应用包、日志等缓存文件；或直接删除该模拟器，重新创建同版本的配对组合
• 优化应用体积：移除WatchOS项目中不必要的资源文件、依赖库，压缩图片等资源，减小安装包大小

三、关键注意事项 #

• 必须使用同大版本的iOS和WatchOS模拟器配对（如iOS 17对应WatchOS 10），跨版本配对易引发兼容性问题
• VS Mac中，确保iOS应用属性的WatchOS选项里，Automatically install Watch app to paired simulator已勾选
• Rider中，确认Run配置的Deploy to paired watch simulator选项处于勾选状态

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