将独立watchOS应用安装至Apple Watch Series 5时遇安装失败问题
解决watchOS独立App安装错误Code -402620395(配置描述文件问题)
我之前在部署独立watchOS应用时也碰到过完全一样的错误,结合你的环境(Apple Watch Series 5 + watchOS 6.1.1、macOS Catalina 10.15.2、Xcode 11.3),可以按照以下步骤逐一排查解决:
1. 核对Watch App和Extension的签名配置
- 打开Xcode,在项目导航栏里分别选中FirstTestWatch WatchKit App和FirstTestWatch WatchKit Extension两个目标
- 切换到「Signing & Capabilities」标签页:
- 确保「Automatically manage signing」处于勾选状态,并且你的Apple ID已经正确选择
- 如果自动签名模式下还是报错,尝试手动配置:
- 登录Apple Developer后台,找到对应Watch App和Extension的Bundle ID(注意独立watchOS App的Bundle ID不需要依附iOS App,但要确保两个目标的Bundle ID是关联的,比如Extension的ID是App ID加上
.watchkitextension) - 为这两个Bundle ID分别生成Development类型的配置描述文件,确保包含你的Apple Watch的UDID(可以在Xcode的「Window → Devices and Simulators」里找到设备UDID)
- 下载配置文件后双击安装到Xcode,再回到项目的Signing设置里手动选择对应的配置文件
- 登录Apple Developer后台,找到对应Watch App和Extension的Bundle ID(注意独立watchOS App的Bundle ID不需要依附iOS App,但要确保两个目标的Bundle ID是关联的,比如Extension的ID是App ID加上
2. 清理Xcode缓存并重启
- 先执行「Clean Build Folder」(快捷键
Cmd+Shift+K),清除旧的编译和签名缓存 - 关闭Xcode,打开「Activity Monitor」找到并结束所有Xcode相关进程(包括
Xcode、xcbuild等) - 重新打开Xcode,重新Build并尝试安装
3. 确认Apple Watch的开发者信任状态
- 在你的Apple Watch上打开「设置 → 通用 → 设备管理」
- 找到你的开发者Apple ID,点击进入后选择「信任」(如果没有看到设备管理选项,先在配对的iPhone上完成信任操作:「设置 → 通用 → 设备管理」,信任你的开发者账号后,重启Watch并同步)
4. 检查Deployment Target匹配
- 确保Watch App和Extension的Deployment Target设置为watchOS 6.1.1或更低版本(不能高于你的Apple Watch当前系统版本),可以在目标的「General」标签页里修改
额外注意事项
- 独立watchOS App不需要配套iOS App,但仍需确保Watch App和Extension的Bundle ID符合Apple的命名规范
- 如果你之前有过其他watchOS项目的签名记录,可能需要在Xcode的「Preferences → Accounts」里点击「Download Manual Profiles」刷新所有配置文件
内容的提问来源于stack exchange,提问作者Martin Kostadinov




