GitHub Actions构建React Native应用提交TestFlight后Apple Sign-In失效问题排查

遇到本地Xcode打包正常，但GitHub Actions打包提交TestFlight后Apple Sign-In失效的情况，真的特别闹心！我帮你梳理下从你提供的配置里发现的核心问题，以及对应的排查和修复方向：

1. 最可能的核心错误：Xcodebuild命令中证书与描述文件参数用法完全错误 #

你在Build Archive步骤的xcodebuild命令里，把CODE_SIGN_IDENTITY和PROVISIONING_PROFILE直接设为了base64编码的证书和描述文件内容——这完全不对！这两个参数的正确用法是传证书的名称和描述文件的UUID/名称，而不是base64的文件内容！

本地Xcode会自动从钥匙串和描述文件目录读取正确的资源，但CI环境里你得先把base64的证书和描述文件解码并放到正确位置，再用它们的标识来配置xcodebuild，而不是直接传base64内容。这就导致CI打包时根本没正确应用你配置的证书和描述文件，Apple Sign-In的授权自然无法被正确嵌入到IPA里。

2. 修正后的CI证书与描述文件配置步骤 #

你需要先在CI环境中导入证书到钥匙串、放置描述文件到指定目录，再执行xcodebuild：

步骤1：解码并导入证书到钥匙串 #

在Build Archive步骤前添加证书处理的命令：

# 解码证书
echo -n "${{env.BUILD_CERTIFICATE_BASE64}}" | base64 --decode > $RUNNER_TEMP/build_cert.p12
# 创建并解锁构建钥匙串
security create-keychain -p "${{env.KEYCHAIN_PASSWORD}}" build.keychain
security default-keychain -s build.keychain
security unlock-keychain -p "${{env.KEYCHAIN_PASSWORD}}" build.keychain
# 导入证书到钥匙串
security import $RUNNER_TEMP/build_cert.p12 -k build.keychain -P "${{env.CERTIFICATE_PASSWORD}}" -T /usr/bin/codesign
# 设置钥匙串权限（避免codesign报错）
security set-key-partition-list -S apple-tool:,apple: -s -k "${{env.KEYCHAIN_PASSWORD}}" build.keychain

步骤2：解码并放置描述文件到指定目录 #

同样在Build Archive步骤前添加描述文件处理：

# 解码描述文件
echo -n "${{env.BUILD_PROVISION_PROFILE_BASE64}}" | base64 --decode > $RUNNER_TEMP/build_profile.mobileprovision
# 复制到Xcode读取的描述文件目录
mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
cp $RUNNER_TEMP/build_profile.mobileprovision ~/Library/MobileDevice/Provisioning\ Profiles/

步骤3：修正Xcodebuild的Build Archive命令 #

把原来错误的CODE_SIGN_IDENTITY和PROVISIONING_PROFILE参数替换为正确的标识：

xcodebuild \
  -workspace ${{env.PROJECT_NAME}}.xcworkspace \
  -scheme ${{env.SCHEME_NAME}} \
  -archivePath $RUNNER_TEMP/${{env.PROJECT_NAME}}.xcarchive \
  -sdk iphoneos \
  -configuration Release \
  -verbose \
  CODE_SIGN_STYLE=Manual \
  # 替换成你的分发证书名称，比如"iPhone Distribution: Your Team Name (${{env.APPLEID_TEAM_ID}})"
  CODE_SIGN_IDENTITY="iPhone Distribution: Your Team Name (${{env.APPLEID_TEAM_ID}})" \
  DEVELOPMENT_TEAM="${{env.APPLEID_TEAM_ID}}" \
  # 替换成你的生产描述文件名称或UUID
  PROVISIONING_PROFILE_SPECIFIER="Your Production Provisioning Profile Name" \
  CODE_SIGN_ENTITLEMENTS=ScoutAppProdRelease.entitlements \
  archive

提示：PROVISIONING_PROFILE_SPECIFIER用描述文件名称更直观，如果你想用UUID的话，也可以换成PROVISIONING_PROFILE="你的描述文件UUID"

3. 额外验证：Export Options Plist的配置 #

确保你的PROD_EXPORT_OPTIONS_PLIST里包含正确的签名配置，避免导出IPA时重新签名覆盖授权：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <!-- 确保是manual签名，不要用auto -->
  <key>signingStyle</key>
  <string>manual</string>
  <!-- 映射你的Bundle ID到对应的描述文件名称 -->
  <key>provisioningProfiles</key>
  <dict>
    <key>com.yourapp.prod</key>
    <string>Your Production Provisioning Profile Name</string>
  </dict>
  <!-- 其他导出配置... -->
</dict>
</plist>

4. 验证最终IPA的授权是否正确嵌入 #

打包完成后，可以在CI里加一步验证，确认Apple Sign-In的授权已经被正确包含：

# 解压IPA
unzip $RUNNER_TEMP/build/${{env.PROJECT_NAME}}.ipa -d $RUNNER_TEMP/ipa_content
# 查看应用的授权信息
codesign -d --entitlements :- $RUNNER_TEMP/ipa_content/Payload/${{env.PROJECT_NAME}}.app

运行后检查输出里是否有com.apple.developer.applesignin字段，如果有就说明授权配置正确了。

按照这个流程修正后，应该就能解决CI打包导致的Apple Sign-In失效问题了，毕竟本地Xcode是用正确的证书和描述文件流程，CI只要对齐这个流程就没问题。

内容来源于stack exchange