Codemagic打包Adhoc IPA提示未找到iOS Distribution签名证书求助

问题根因 #

报错是构建过程中Xcode无法找到匹配团队ID的iOS Distribution签名证书及对应私钥，核心原因包括：仅拉取了主应用的签名文件，遗漏了OneSignalNotificationServiceExtension扩展Target的签名文件，或是签名配置、构建参数存在冲突。

修复方案 #

• 1. 补充扩展Target的签名文件拉取配置 #

  首先在环境变量中新增扩展Target的Bundle ID变量：

  environment:
    vars:
      # 原有变量全部保留，新增以下内容
      EXTENSION_BUNDLE_ID: "com.project.app.OneSignalNotificationServiceExtension" # 替换为你实际的扩展Target的Bundle ID
  

  再修改Fetch signing files步骤的脚本，同时拉取主包和扩展的签名文件：

  app-store-connect fetch-signing-files $BUNDLE_ID $EXTENSION_BUNDLE_ID --type IOS_APP_ADHOC --create
  

• 2. 验证加密变量配置 #

  确认你配置的CERTIFICATE_PRIVATE_KEY加密变量为导出iOS Distribution证书时设置的私钥密码，且App Store Connect账号下存在有效的iOS Distribution证书，证书状态未过期、未吊销。

• 3. 构建命令添加手动签名参数 #

  本地项目配置的自动签名会和Codemagic拉取的预置描述文件冲突，修改Build ipa for Adhoc步骤的脚本，强制使用手动签名：

  xcode-project build-ipa --workspace "$XCODE_WORKSPACE" --scheme "$XCODE_SCHEME" --verbose --archive-xcargs "CODE_SIGN_STYLE=Manual"
  

• 4. 确认团队ID一致性 #

  检查主应用Target和OneSignalNotificationServiceExtension扩展Target的团队ID配置完全一致，且和你App Store Connect密钥所属团队ID匹配。

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