Xcode Cloud报错：未找到匹配团队ID的Mac Development签名证书

问题详情 #

构建时触发以下错误：

/Volumes/workspace/repository/macos/Runner.xcodeproj: error: No signing certificate "Mac Development" found: No "Mac Development" signing certificate matching team ID "22649D52Q5" with a private key was found. (in target 'Runner' from project 'Runner')

本地开启自动签名可正常编译，但Xcode Cloud云端构建失败，已尝试清理钥匙串、吊销并重新生成证书，问题仍存在。

使用的ci_post_clone.sh脚本如下：

#!/bin/sh

# Fail this script if any subcommand fails.
set -e

# The default execution directory of this script is the ci_scripts directory.
cd $CI_PRIMARY_REPOSITORY_PATH # change working directory to the root of your cloned (cloud) repo.

# Install Flutter using git.
 git clone https://github.com/flutter/flutter.git --depth 1 -b stable $HOME/flutter
export PATH="$PATH:$HOME/flutter/bin"

# Install Flutter artifacts for iOS (--ios), or macOS (--macos) platforms.
flutter precache --macos

# Install Flutter dependencies.
flutter pub get

# Install CocoaPods using Homebrew.
HOMEBREW_NO_AUTO_UPDATE=1 # disable homebrew's automatic updates.
brew install cocoapods

# Install CocoaPods dependencies.
cd macos
pod deintegrate
pod update
cd ..
# Install Flutter dependencies.
flutter pub get
dart run build_runner build -d
# flutter build macos
flutter build macos --release 

解决方案 #

1. 对齐Xcode Cloud与本地项目的签名配置 #

• 打开本地项目的macos/Runner.xcodeproj，选中Runner target进入Signing & Capabilities标签：
  • 确保勾选Automatically manage signing，并选择团队ID为22649D52Q5的开发团队。
• 进入Xcode的Product > Archive，选择通过Xcode Cloud分发，检查分发配置中的签名选项是否同样设置为Automatically manage signing，团队匹配22649D52Q5。

2. 修正ci_post_clone.sh中的Pod操作逻辑 #

脚本中的pod deintegrate会完全移除Pod配置，可能导致签名设置被重置：

• 若无需强制更新Pod版本，替换pod deintegrate && pod update为pod install；
• 若必须更新，在Pod操作后添加命令强制恢复自动签名：

  cd macos
  pod deintegrate
  pod update
  # 重置签名配置
  xcodebuild -project Runner.xcodeproj -target Runner -configuration Release DEVELOPMENT_TEAM=22649D52Q5 CODE_SIGN_STYLE=Automatic
  cd ..
  

3. 确保Xcode Cloud有权访问开发者证书 #

• 登录Apple Developer Portal，检查团队22649D52Q5下的Mac Development证书状态正常，且私钥已关联；
• 确认Xcode的Preferences > Accounts中已登录对应Apple ID，团队状态激活，且Xcode Cloud服务在开发者账户中已启用；
• 自动签名模式下，Xcode Cloud会自动管理证书，但需确保云端构建环境能访问你的开发者账户权限。

4. 给Flutter构建命令添加签名参数 #

在flutter build macos --release中直接指定签名参数，强制云端使用自动签名：

flutter build macos --release --xcode-args="-allowProvisioningUpdates DEVELOPMENT_TEAM=22649D52Q5 CODE_SIGN_STYLE=Automatic"

其中-allowProvisioningUpdates允许Xcode自动更新配置文件和证书，适配云端构建环境。

5. 统一Xcode版本 #

检查Xcode Cloud构建方案中使用的Xcode版本，确保与本地编译用的版本一致，避免版本差异导致的签名逻辑问题。

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