You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

将独立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 AppFirstTestWatch WatchKit Extension两个目标
  • 切换到「Signing & Capabilities」标签页:
    • 确保「Automatically manage signing」处于勾选状态,并且你的Apple ID已经正确选择
    • 如果自动签名模式下还是报错,尝试手动配置:
      1. 登录Apple Developer后台,找到对应Watch App和Extension的Bundle ID(注意独立watchOS App的Bundle ID不需要依附iOS App,但要确保两个目标的Bundle ID是关联的,比如Extension的ID是App ID加上.watchkitextension
      2. 为这两个Bundle ID分别生成Development类型的配置描述文件,确保包含你的Apple Watch的UDID(可以在Xcode的「Window → Devices and Simulators」里找到设备UDID)
      3. 下载配置文件后双击安装到Xcode,再回到项目的Signing设置里手动选择对应的配置文件

2. 清理Xcode缓存并重启

  • 先执行「Clean Build Folder」(快捷键Cmd+Shift+K),清除旧的编译和签名缓存
  • 关闭Xcode,打开「Activity Monitor」找到并结束所有Xcode相关进程(包括Xcodexcbuild等)
  • 重新打开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

火山引擎 最新活动