Xcode上传Mac Catalyst应用到TestFlight遇ITMS-90889缺少配置文件错误

核心原因 #

该错误出现的本质是Mac Catalyst版本需要独立的macOS专属 provisioning profile，和iOS端的配置文件不通用，仅配置iOS端的签名信息无法满足Mac端提交要求。

分步解决流程 #

• 步骤1：开发者后台生成独立的Mac配置文件 #

  1. 登录Apple Developer后台，进入Identifiers列表，找到应用对应的Bundle ID，确认macOS (Catalyst)变体已经处于启用状态
  2. 进入Provisioning Profiles列表，新建Distribution类型的配置文件，平台选择macOS，关联的Bundle ID选择应用的Catalyst变体，签名证书选择对应团队的Mac App Distribution类型证书
  3. 下载生成好的配置文件，双击导入Xcode

• 步骤2：校验Xcode签名配置 #

  1. 打开项目，选中主Target，进入Signing & Capabilities标签页
  2. 页面顶部的平台切换栏选择My Mac，不要停留在iOS平台的配置界面
  3. 先取消勾选Automatically manage signing，再重新勾选，触发Xcode自动匹配刚导入的macOS配置文件；如果使用手动签名，确认Provisioning Profile下拉选择的是刚导入的macOS专属配置文件，而非iOS配置文件
  4. 确认签名用的团队和iOS版本保持一致

• 步骤3：清理缓存重新打包 #

  1. 按下Shift + Command + K清理Xcode构建缓存，也可以手动删除~/Library/Developer/Xcode/DerivedData下对应项目的缓存目录
  2. Scheme切换为Any Mac (Apple Silicon/Intel)，执行Archive操作
  3. 导出Archive包时，分发目标选择App Store Connect，导出完成后可以右键查看导出的.pkg包内容，确认Contents/目录下存在embedded.provisionprofile文件

• 步骤4：兜底手动嵌入方案 #

  上述步骤执行后仍报错的话，将下载好的macOS provisioning profile重命名为embedded.provisionprofile，添加到项目的Resource目录下，勾选主Target的Target Membership后重新打包提交即可

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