GitHub Actions构建Xcode项目失败：无开发者账户及匹配配置文件

核心错误分析 #

从构建日志中可以明确两个导致归档失败的问题：

1. Xcode未注册开发者账号：error: There are no accounts registered with Xcode. Add your developer account to Xcode
2. 找不到匹配com.company.us.dev.hello的iOS开发描述文件：error: No profiles for 'com.company.us.dev.hello' were found: Xcode couldn't find any iOS App Development provisioning profiles matching 'com.company.us.dev.hello'

解决方案 #

1. 配置GitHub Actions的Apple开发者账号认证 #

GitHub Actions的runner环境默认没有登录Apple开发者账号，必须在工作流中完成认证，推荐使用App Store Connect API密钥（比明文账号密码更安全）：

• 在Apple Developer后台创建API密钥（需开启"Developer"权限），记录密钥ID、Issuer ID，并下载.p8格式的密钥文件
• 在GitHub仓库的「Settings -> Secrets and variables -> Actions」中添加以下机密：
  • APPLE_API_KEY_ID：API密钥的ID
  • APPLE_API_ISSUER_ID：Apple Developer后台显示的Issuer ID
  • APPLE_API_KEY：下载的.p8密钥文件的完整内容
• 在工作流中添加认证步骤：

  - name: 认证Apple开发者账号
    uses: apple-actions/login-with-apple-id@v1
    with:
      api-key-id: ${{ secrets.APPLE_API_KEY_ID }}
      api-issuer-id: ${{ secrets.APPLE_API_ISSUER_ID }}
      api-key: ${{ secrets.APPLE_API_KEY }}
  

2. 确保描述文件正确匹配bundle ID #

虽然你已经将描述文件复制到指定目录，但需验证以下几点：

• 描述文件的application-identifier字段必须与构建时的${IOS_APP_ID}（即com.company.us.dev.hello）完全一致
• 描述文件类型为iOS App Development，且包含你添加到keychain的证书的公钥
• 可通过以下命令验证描述文件内容：

  security cms -D -i /Library/MobileDevice/Provisioning\ Profiles/[你的描述文件UUID].mobileprovision | grep -A 10 "Entitlements"
  

3. 明确指定签名信息到xcodebuild命令 #

修改归档命令，添加-signingIdentity和-provisioningProfile参数，避免Xcode自动查找出错：

xcodebuild clean archive \
  PRODUCT_BUNDLE_IDENTIFIER=${IOS_APP_ID} \
  -workspace $cur_dir/../ios/${PROJECT_NAME}.xcworkspace \
  -scheme $IOS_SCHEME \
  -configuration $IOS_CONFIGURATION \
  -allowProvisioningUpdates \
  -derivedDataPath $cur_dir/../ios/build \
  -archivePath $cur_dir/../ios/build/Products/${PROJECT_NAME}.xcarchive \
  -signingIdentity "iPhone Developer: 你的开发者名称 (XXXXXX)" \
  -provisioningProfile "描述文件UUID或名称"

注意：signingIdentity的值要与security find-identity -p codesigning -v输出的证书名称完全一致；provisioningProfile可使用描述文件的UUID（在描述文件内容的UUID字段中获取）或名称。

4. 检查Xcode版本兼容性 #

你当前使用Xcode 13.2.1（对应iOS 15.2 SDK），需确保项目的部署目标版本不高于15.2；若需更高版本的SDK，可在工作流中升级Xcode版本：

- name: 配置Xcode版本
  uses: actions/setup-xcode@v2
  with:
    xcode-version: '14.3'

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