React Native多Target项目GitHub Actions iOS构建失败求助

核心问题分析 #

你遇到的问题本质是每个iOS Target必须对应唯一的签名配置：

• 苹果开发者后台不允许重复Bundle ID，所以同Bundle ID的方案从根源上不可行，直接放弃。
• 不同Bundle ID时，必须为每个Bundle ID配置独立的App ID和Provisioning Profile，否则签名会不匹配。

方案一：构建两个独立App（不同Bundle ID） #

1. 开发者后台准备工作 #

• 为每个Target的Bundle ID创建独立的App ID（开发者后台→Certificates, Identifiers & Profiles→Identifiers）。
• 为每个App ID生成对应的Distribution Provisioning Profile，下载后分别转成Base64编码。
• 确认你的Distribution证书（p12）是Team级别的，可用于所有同Team下的App ID签名。

2. GitHub Secrets配置 #

添加以下Secrets到仓库：

• IOS_P12_BASE64：共用的分发证书Base64
• IOS_CERTIFICATE_PASSWORD：证书密码
• IOS_TEAM_ID：团队ID
• IOS_MOBILE_PROVISION_TARGET1：第一个Target的Provisioning Profile Base64
• IOS_MOBILE_PROVISION_TARGET2：第二个Target的Provisioning Profile Base64

3. Xcode项目配置 #

打开iOS项目，为每个Target配置：

• 在Signing & Capabilities中，选择对应的Team，手动指定Provisioning Profile（CI环境建议手动配置，避免自动签名冲突）。
• 确保每个Target的Build Settings→Code Signing Identity设置为Apple Distribution。

4. GitHub Actions配置修改 #

需要为每个Target单独执行构建步骤，示例如下：

name: Build Multi-Target iOS
on:
  push:
    branches:
      - 'build/actions-test'
jobs:
  build-ios:
    runs-on: macos-12
    steps:
      - uses: actions/checkout@v2

      - name: Use Node.js 16.17.1
        uses: actions/setup-node@v3
        with:
          node-version: 16.17.1
          cache: 'yarn'

      - name: Install Node modules
        run: yarn

      - name: Setup Ruby (bundle)
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: 2.7.4
          bundler-cache: true

      - name: Restore Pods cache
        uses: actions/cache@v3
        with:
          path: |
            ios/Pods
            ~/Library/Caches/CocoaPods
            ~/.cocoapods
          key: ${{ runner.os }}-pods-${{ hashFiles('ios/Podfile.lock') }}
          restore-keys: |
            ${{ runner.os }}-pods-
      - name: Install pod dependencies
        run: cd ios && pod install && cd ..

      # 构建第一个Target
      - name: Clean Target 1 Build
        run: |
          cd ios
          xcodebuild clean -workspace HemeNew.xcworkspace -scheme 'HemeNew 1'
      
      - name: Build Target 1 (Release)
        uses: yukiarrr/ios-build-action@v1.5.0
        with:
          project-path: ios/HemeNew.xcodeproj
          p12-base64: ${{ secrets.IOS_P12_BASE64 }}
          mobileprovision-base64: ${{ secrets.IOS_MOBILE_PROVISION_TARGET1 }}
          code-signing-identity: 'Apple Distribution'
          certificate-password: ${{ secrets.IOS_CERTIFICATE_PASSWORD }}
          team-id: ${{ secrets.IOS_TEAM_ID }}
          workspace-path: ios/HemeNew.xcworkspace
          output-path: 'HemeNew-Target1.ipa'
          scheme: 'HemeNew 1'

      - name: Upload Target 1 Build
        uses: actions/upload-artifact@v3
        with:
          name: 'HemeNew-Target1.ipa'
          path: 'HemeNew-Target1.ipa'

      # 构建第二个Target
      - name: Clean Target 2 Build
        run: |
          cd ios
          xcodebuild clean -workspace HemeNew.xcworkspace -scheme 'HemeNew 2'
      
      - name: Build Target 2 (Release)
        uses: yukiarrr/ios-build-action@v1.5.0
        with:
          project-path: ios/HemeNew.xcodeproj
          p12-base64: ${{ secrets.IOS_P12_BASE64 }}
          mobileprovision-base64: ${{ secrets.IOS_MOBILE_PROVISION_TARGET2 }}
          code-signing-identity: 'Apple Distribution'
          certificate-password: ${{ secrets.IOS_CERTIFICATE_PASSWORD }}
          team-id: ${{ secrets.IOS_TEAM_ID }}
          workspace-path: ios/HemeNew.xcworkspace
          output-path: 'HemeNew-Target2.ipa'
          scheme: 'HemeNew 2'

      - name: Upload Target 2 Build
        uses: actions/upload-artifact@v3
        with:
          name: 'HemeNew-Target2.ipa'
          path: 'HemeNew-Target2.ipa'

方案二：主App+扩展Target（如Share Extension，关联Bundle ID） #

如果第二个Target是主App的扩展（如Share Extension、Notification Service Extension）：

1. 开发者后台：扩展的Bundle ID必须是主App Bundle ID的后缀（比如主App是com.xxx.app，扩展是com.xxx.app.extension），且在主App的App ID配置中启用对应的扩展能力。
2. 签名配置：扩展的Provisioning Profile可以和主App共用（或单独生成，但必须关联主App），CI中只需要传入主App的Provisioning Profile，Xcode会自动处理扩展的签名。
3. GitHub Actions配置：无需修改原有构建步骤，只需要确保Xcode中扩展Target的签名设置为Automatic，并关联主App的Team。

关键注意事项 #

• 不要尝试用重复Bundle ID，苹果开发者后台不允许，且会导致签名失败。
• CI中尽量使用手动指定Provisioning Profile，避免自动签名在CI环境中出现的缓存或权限问题。
• 确保所有Provisioning Profile都是Distribution类型，和构建的Release环境匹配。

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