如何为iOS和visionOS应用配置独立的分发配置文件？

一、在Apple开发者后台创建独立的App ID #

• 登录Apple开发者后台，进入「Certificates, Identifiers & Profiles」
• 点击「Identifiers」→ 「+」创建新的App ID：
  • 第一个给iOS用：填写专属Bundle ID（比如com.yourcompany.app.ios），勾选iOS需要的特殊能力（如com.apple.developer.kernel.increased-memory-limit、Extended Virtual Addressing）
  • 第二个给visionOS用：填写不同的Bundle ID（比如com.yourcompany.app.visionos），只勾选visionOS支持的能力，避开iOS专属权限
• 确保两个App ID的「App Services」和「Capabilities」完全匹配各自平台需求

二、创建对应平台的分发配置文件 #

• 在开发者后台的「Profiles」→ 「+」：
  • 选择你的分发类型（「App Store」或「Ad Hoc」），点击下一步
  • 先选iOS平台，关联iOS专属App ID，选择对应证书，生成并下载iOS分发配置文件
  • 重复操作，选择visionOS平台，关联visionOS专属App ID，生成并下载对应分发配置文件

三、在Xcode中配置两个目标的签名与配置文件 #

• 打开Xcode项目，确保已创建两个独立目标（iOS目标、visionOS目标）
• 选中iOS目标，进入「Signing & Capabilities」标签：
  • 取消勾选「Automatically manage signing」
  • 在「Provisioning Profile」下拉菜单中选择下载好的iOS专属分发配置文件
  • 确认Bundle ID与开发者后台的iOS App ID完全一致
  • 检查Capabilities，确保仅启用iOS支持的权限（Xcode会同步配置文件内的权限）
• 选中visionOS目标，重复上述操作：
  • 取消自动签名，选择visionOS专属分发配置文件
  • 确保Bundle ID与开发者后台的visionOS App ID匹配
  • 确认Capabilities中无iOS专属的不支持权限

四、处理代码与文件差异 #

• 针对平台代码差异，使用Xcode的平台条件编译：

  #if os(iOS)
      // iOS专属逻辑，如调用特殊内存权限的代码
  #elseif os(visionOS)
      // visionOS专属逻辑
  #endif
  

• 针对文件差异，在目标「Build Phases」→「Compile Sources」中，选中文件后在右侧「Target Membership」里仅勾选对应平台的目标

常见问题排查 #

• 若配置文件无法选择，先在「Xcode」→「Settings」→「Accounts」→ 选中开发者账号 →「Manage Profiles」中确认已导入下载的配置文件
• 出现签名错误时，检查Bundle ID、App ID、配置文件三者是否完全对应，且证书有效
• 若visionOS目标配置不生效，确认未勾选iOS专属权限，否则会导致配置文件不匹配

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