Azure Pipeline CI构建失败：未找到com.my.app配置文件

原因1：自动签名的环境上下文差异 #

本地Mac的Xcode会自动关联开发者账号、匹配签名配置，但Azure Pipeline的macOS代理是无交互环境，自动签名逻辑无法像本地一样自动完成上下文关联。

• 解决步骤：
  • 确保流水线使用的Xcode版本和本地完全一致，不同版本的自动签名逻辑存在差异。
  • 在xcodebuild命令中显式指定DEVELOPMENT_TEAM参数，示例：

    xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -destination 'generic/platform=iOS' -archivePath build/MyApp.xcarchive DEVELOPMENT_TEAM=XXX1234567
    

    团队ID可从苹果开发者后台的账号信息中获取。

原因2：配置文件未被正确识别 #

即使确认配置文件存在，Xcode自动签名需要配置文件的UUID或名称与项目设置匹配，流水线环境无法自动完成这一映射。

• 解决步骤：
  1. 获取配置文件UUID：本地Xcode中打开项目→Target→Signing & Capabilities→选中配置文件→右键Show in Finder→右键文件Show Package Contents→打开embedded.mobileprovision，提取UUID字段值。
  2. 在xcodebuild命令中添加指定参数，二选一即可：

     # 指定配置文件名称
     PROVISIONING_PROFILE_SPECIFIER="MyApp Development Profile"
     # 或指定UUID
     PROVISIONING_PROFILE=XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX
     

原因3：钥匙串权限问题 #

证书已上传但未被正确添加到流水线代理的钥匙串，或缺少访问权限，导致Xcode无法读取证书。

• 解决步骤：
  在流水线中添加钥匙串操作步骤（需提前将证书密码、钥匙串密码存入Pipeline变量组）：

  # 创建临时钥匙串
  security create-keychain -p $KEYCHAIN_PASSWORD build.keychain
  # 导入证书并赋予codesign、xcodebuild访问权限
  security import $CERTIFICATE_PATH -k build.keychain -P $CERTIFICATE_PASSWORD -T /usr/bin/codesign -T /usr/bin/xcodebuild
  # 设置为默认钥匙串
  security list-keychains -d user -s build.keychain login.keychain
  # 解锁钥匙串
  security unlock-keychain -p $KEYCHAIN_PASSWORD build.keychain
  

  注意：上传的证书必须是包含私钥的p12格式。

原因4：项目签名配置未同步到版本控制 #

本地Xcode的自动签名设置未写入项目文件并提交，流水线拉取的代码中缺少签名配置。

• 解决步骤：
  • 检查Git是否提交了.xcodeproj/.xcworkspace文件，重点确认project.pbxproj中的CODE_SIGN_STYLE是否为Automatic，DEVELOPMENT_TEAM是否已设置。
  • 本地Xcode中先关闭自动签名再重新开启，确保配置写入项目文件后提交变更。

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