iOS 构建

使用 Capgo 专属 Mac 设施，通过 TestFlight 和 App Store 提交 iOS 应用程序。

您将学到什么

• 通过 Capgo 原生构建上传您的应用程序
• 您将学习如何配置 Capgo 原生构建的证书

先决条件

• 一个 Capgo 帐户（免费试用即可开始）
• 您的应用程序已在 Capgo 注册（运行 bunx @capgo/cli@latest app add 如果没有）
• 不需要 Mac：Capgo 构建在云中编译和签名您的 iOS 应用程序，因此您可以从 macOS、Windows 或 Linux 运行此过程
• 有效的苹果开发者账户（$99/年）（您必须在苹果开发者账户上具有管理员或拥有者权限）
• 您的应用程序必须能够成功构建（在Xcode本地环境中，或使用Capgo Build)
• 一个Capacitor应用
• 一个已配置的应用程序图标。没有图标的应用程序无法上传到App Store

注意

本教程将使用以下应用程序 https://github.com/Cap-go/capgo-native-compile-tutorial-app

在苹果门户中

在苹果门户中设置证书或触发首次TestFlight上传之前，请确保苹果账户和团队准备就绪

• 为用于注册的苹果账户启用两因素认证
• 选择合适的会员类型：
  • 个人/独资企业:您的法律姓名将成为App Store上的卖家名称
  • 组织:需要一个法律实体，一个D-U-N-S号，一个公共公司网站，一个公司域名的工作电子邮件，以及一个具有权力将组织绑定到Apple协议的人
• 使用可以访问Apple Developer和App Store Connect的帐户，用于证书，应用记录，API密钥和TestFlight
• 尽早锁定您的最终bundle ID。改变它后通常需要重新设置App Store
• 在App Review之前，规划这些App Store Connect项目：支持URL，隐私政策URL，年龄等级，截图，出口合规性和App Review联系信息

注意

有用官方参考：

• 成为Apple Developer Program的成员
• 提交您的应用和游戏
• App Store Connect中的平台版本信息

注意

Apple定期更新其最低SDK要求。截至 2026年4月28日, iPhone和iPad应用上传到App Store Connect必须使用iOS & iPadOS 26__CAPGO_KEEP_0__或更高版本构建 iOS & iPadOS 26SDK或更高版本.

建议：自动注册

您不需要自己处理这些步骤。Capgo的注册功能会为您创建和配置iOS签名凭证（分发证书+配置文件）— 这是推荐的路径：

bunx @capgo/cli@latest build init --platform ios

以下手动步骤仅适用于那些希望自己设置凭证或了解Capgo背后的工作原理的人。

第一个手动构建

在使用Capgo构建应用之前，我们应该先设置它，并手动完成一次TestFlight构建。 手动构建有几个优势:

• 您将在本地机器上设置分发证书
• 您将创建应用商店记录，如果您尚未完成，请务必完成
• 您将能够了解构建过程中与应用code相关的问题

在开始之前，您需要在本地机器上安装分发证书。 这确实是一个复杂的过程，但我将在下面解释。

设置分发证书

1. 打开Xcode

2. 点击 Xcode -> Settings... 或者，您可以使用快捷方式 Cmd + ,

   

3. 转到 Accounts

4. 找到已添加到Apple Developer帐户的Apple帐户

5. 找到您将用于部署应用程序的团队

6. 点击 Manage Certificates... 按钮

7. 确保您可以在列表中看到分发证书

8. 如果您没有，请创建一个新证书

   注意

   苹果限制您可以拥有的分发证书数量为3。如果您有超过3个证书，则需要删除一个以便创建一个新证书。这个过程将在教程中不被涵盖

   1. 点击 + 按钮，然后点击 Apple Distribution
   2. 证书将自动创建。您可以在列表中看到它。查看前一步以确认您看到它。

现在您已经安装了分发证书，开始构建过程。

手动构建到TestFlight

1. 在Xcode中打开应用

   运行 bunx cap open ios 为了打开应用在Xcode中，请点击

2. 按钮 archive button

   按钮。 product -> archive 手动构建到TestFlight

   

3. 等待构建完成

4. 点击 Distribute App 按钮

   

5. 选择 TestFlight Internal Only 作为分发方法并点击 Distribute 按钮

   

6. 配置应用记录

   填写以下字段:

   1. 名称：您的应用名称 - 在 App Store 中可见
   2. SKU - 应用程序的 SKU - 这是用于在 App Store 中识别您的应用程序的 SKU
   3. 主语言 - 应用程序的主语言

   然后，点击 next 按钮

   

7. 如果创建应用程序记录失败，请尝试关闭窗口并尝试再次存档应用程序。

8. 等待上传完成

9. 如果一切顺利，您应该看到以下屏幕

10. 点击 Done 按钮

您可能会本能地认为现在一切都好，并且您将能够在 TestFlight 中看到您的应用程序，但仍有几个事情需要完成：

1. 加入 TestFlight
2. 确保构建符合导出法规，才能进行测试
3. 填写 App Store Connect 必填信息，如支持 URL、隐私政策 URL 和年龄限制
4. 准备与您实际支持的设备匹配的截图
5. 在生产提交之前添加 App Review 联系信息和测试凭证

我们从第一个开始：

加入 TestFlight

1. 前往 App Store Connect 页面

2. 使用您的Apple Developer账户登录

3. 选择您在创建应用记录时使用的团队。如果您只有一份开发者账户，可以跳过这个步骤。

4. 点击 Apps 按钮

5. 在上一步中创建的应用中找到并点击它

6. 点击 TestFlight 按钮

7. 点击 Internal Testers plus button

8. 创建新组

   我喜欢将组命名为“内部”。您可以将其命名为您想要的任何内容。

   

9. 点击 Invite testers button

10. 将自己添加到组中

    在列表中找到并选择您名字旁边的复选框。 (您可能需要刷新页面才能看到自己) 然后，点击 Add 按钮。

    

11. 验证您已加入组

    现在，您应该在组中看到自己。

    

恭喜 🎉 您已将自己添加到 TestFlight 中。现在，还有一件事需要做 您才能配置 Capgo 原生构建。

设置合规信息

现在，您需要向 Apple 保证您的应用程序不使用任何非标准（如自定义算法）加密。如果您的应用程序确实使用任何非标准加密，我建议阅读 Apple 文档 关于如何处理此问题的说明。 有两种方法可以做到这一点：

1. 您可以每次构建应用程序时都手动完成此操作。
2. 您可以配置您的 plist 文件，以自动设置此值为 false.

让我们从第一种方法开始：

1. 按照上一节的步骤，找到 App Store Connect 中的 TestFlight 部分

2. 点击 Builds -> iOS

3. 找到缺少合规信息的构建并点击 Manage

4. 选择最适合您的应用的选项

   对于我来说，这是 none但可能与您不同。 之后，点击保存

   

5. 您的应用现在应该显示 ready to test

   

至于第二个，以下是步骤：

1. 打开 Info.plist 文件

2. 添加以下键值对:

   <key>ITSAppUsesNonExemptEncryption</key>
   <false/>

3. 保存文件

注意

Here 安装TestFlight应用并接受邀请

安装TestFlight应用并接受邀请

完成了 即将 准备好在 TestFlight 中测试您的应用。 在此之前，您需要完成以下步骤：

1. 下载 TestFlight 应用 从 App Store 上的 iOS/iPadOS 设备上
2. 接受测试您的应用的邀请

我将跳过如何在您的设备上安装 TestFlight 应用的详细步骤。如果您不确定如何安装应用，请参阅 Google 的相关指南。

关于接受邀请，您将收到来自 Apple 的一封邮件，包含接受邀请的链接。

1. 打开来自 Apple 的邮件，包含接受邀请的链接

2. 点击 View in TestFlight 按钮

3. 点击测试飞行按钮 Install 按钮

4. 在您的设备上安装应用程序

   如果您以前使用Xcode安装了应用程序，则可能会看到以下屏幕。请点击 install 按钮。

5. 等待应用程序安装

6. 点击测试飞行按钮 Open 按钮并点击它

恭喜 🎉 您已接受测试飞行中的应用程序邀请。现在，您可以配置Capgo原生构建来构建并将应用程序提交到测试飞行。

配置Capgo原生构建

您需要配置以下几项才能在Capgo原生构建中构建和提交您的应用到TestFlight。 以下是您将传递给Capgo CLI的列表:

参数	描述
--platform	要构建的平台（ios)
--apple-team-id	您的Apple Developer Team ID（在 Apple Developer Portal)
--apple-key	您的App Store ConnectAPI Key文件路径（.p8 文件）
--apple-key-id	您的App Store ConnectAPI Key的Key ID
--apple-issuer-id	您的App Store Connect发行者ID
--certificate	您的分发证书路径（.p12 文件)
--ios-provisioning-profile	配置文件映射（bundleId=path 或仅路径单个配置文件)

示例命令：

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile '/path/to/profile.mobileprovision'

团队 ID

让我们从团队 ID 开始。找到它相当容易。

1. 前往 苹果开发者账户 并滚动到底部

2. 找到 Team ID

   

Apple key、Apple key ID 和 Apple issuer ID

现在，让我们继续到 Apple key。

macOS：让 Capgo 为您创建此密钥

在 macOS 上 capgo build init 可以让 API 为您创建 App Store Connect 密钥。 选择 “不 — 为我创建一个” 并打开一个引导式窗口 App Store Connect，会将您带到每一步，并自动捕获密钥、Key ID 和 Issuer ID — 无需复制粘贴。以下是手动步骤（Windows 或 Linux 上的路径）

1. 前往 App Store Connect 登录页面

   注意

   如果链接无法正常工作，请尝试重新加载页面

2. 从下拉菜单中选择正确的团队

   1. 点击右上角的用户名
   2. 选择要使用的团队

3. 点击 Integrations 按钮

4. 找到 issuer

   注意

   此 务必保存 您将需要它

   点击复制发行者 copy App Store Connect 复制发行者

5. App Store Connect 添加密钥按钮

6. 并点击 App manager 按钮 Generate button

7. 保存密钥 ID

   注意

   这是 必须保存 - 您稍后需要它

   

8. 下载密钥

   注意

   这是 需要保存的 你会需要它

   危险

   绝对不能与任何人分享这个密钥 - 只在 CAPGO CLI 中使用

   

   

恭喜 🎉 你已经创建了 Apple 密钥、Apple 密钥 ID 和 Apple 发行者 ID

证书

现在，你已经准备好导出证书了。如你所记得的，这个教程的第一步就是设置分发证书

然而，苹果在他们的无限智慧中，决定了你导出证书的方式与你创建它们的方式有很大不同 🙃 让我们进入设置它的步骤：

1. 打开钥匙串访问

   1. 点击 Command + Space 打开搜索栏
   2. 搜索 Keychain Access
   3. 点击 Keychain Access 应用

2. 选择 login 类别并点击 My Certificates 按钮

3. 在列表中找到您的证书

   证书的名称应为 Apple Distribution: [Your Name/Company] (your team ID)

4. 右键单击证书并选择 Export

5. 以文件的形式保存证书 .p12 注意

   这是

   必须保存 - 您稍后会需要它 请务必保存

   1. 确保选择一个合适的证书文件名称
   2. 确保文件格式设置为 Personal Information Exchange (.p12)
   3. 点击 Save 按钮

   

6. 当被要求输入密码时，您可以选择：

   • 跳过密码（推荐简化）：点击 OK 不输入密码
   • 设置密码：如果您希望保护证书文件使用密码， .p12 文件完全支持通过Capgo CLI - 只需使用密码 --p12-password 文件完全支持__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ - 只需在运行配置命令时使用

   

7. 当被要求输入“登录密钥链密码”，请输入您用于登录Mac的密码

   输入您用于登录Mac的密码，然后点击 Allow 按钮。

   

恭喜 🎉 您已成功导出证书。

配置文件

现在，您已经准备好导出分发配置文件了。 我保证，这是您从 Apple 那里需要做的最后一件事。

1. 配置文件 现在，您已经准备好导出配置文件了。相信我，这是您从苹果那里需要的最后一件事。

2. 前往

   1. 点击右上角你的用户名
   2. 点击您要使用的团队

3. 确保您在正确的页面 如果不是，请点击 profiles 在侧边栏中

   

4. 点击 + 按钮

5. 选择配置文件类型 选择 App Store Connect 并点击 Continue 按钮

   

6. 选择您要构建的应用

   在下拉菜单中找到您的应用并点击 Continue 按钮

   

7. 选择正确的分发证书

   选择您在上一步中导出的证书并点击 Continue 按钮

   

   如果您不确定要选择哪个证书，请返回 Keychain Access，找到您导出的证书，然后查看过期日期

   

8. 命名配置文件

   为配置文件命名并点击 Generate button

   提示

   配置文件名将自动从Capgo CLI中提取 — 您不需要记住它。

   

9. 下载配置文件

   点击 Download 下载配置文件

   注意

   此文件 应保存 - 您将需要它稍后

   

恭喜 🎉 您现在已经准备好配置 Capgo Native Build。

注意

请勿将您刚刚创建的凭据提交到您的仓库。 请妥善保管它们！ 🔒

运行配置命令

您已经成功了！您现在已经准备好配置 Capgo Native Build。

您需要运行的命令是：

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id UVTJ336J2D \
  --apple-key ./capgo-tutorial/AuthKey_66FGQZB566.p8 \
  --apple-key-id 66FGQZB566 \
  --apple-issuer-id 0cd4db4a-5598-45b8-9d32-75cdf127d005 \
  --certificate ./capgo-tutorial/capgo-build-tutorial-certificate.p12 \
  --ios-provisioning-profile ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision

替换占位符值

将上述占位符值替换为您在前一步骤中收集的实际凭据:

• --apple-team-id:您的Apple Team ID
• --apple-key:下载的路径 .p8 密钥文件
• --apple-key-id:您的Apple Key ID
• --apple-issuer-id:您的Apple Issuer ID
• --certificate:导出的证书文件路径 (单个配置文件时自动推断bundle ID) .p12 证书
• --ios-provisioning-profile:下载的路径 .mobileprovision 文件

如果一切顺利，你将看到以下输出：

Apple认证失败？同步时钟

如果App Store Connect API 密钥看起来正确，但认证仍然失败，请同步计算机时钟并重试。 Capgo 使用本地系统时间签名Apple的JWT，Apple拒绝超过20分钟未来的令牌。仅仅几秒钟的时钟不准确就足以使这一步骤失败。

查看 构建器故障排除指南 关于同步时钟的步骤。

CI/CD设置（GitHub Actions）

如果你已经完成了 团队ID, Apple ID, Apple 密钥 ID 和 Apple 发行者 ID, 证书, 和 配置文件您已经拥有了CI/CD所需的一切。\n本节仅介绍如何将这些值作为GitHub Actions机密和环境变量传递。

1) 将凭据文件转换为单行 base64

# Distribution certificate (.p12)
base64 -i ./capgo-tutorial/capgo-build-tutorial-certificate.p12 | tr -d '\n' > certificate_base64.txt

# Provisioning profile (.mobileprovision)
base64 -i ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision | tr -d '\n' > profile_base64.txt

# App Store Connect API key (.p8)
base64 -i ./capgo-tutorial/AuthKey_66FGQZB566.p8 | tr -d '\n' > apple_key_base64.txt

复制到剪贴板

GitHub 秘钥应为单行值。 tr -d '\n' 去除 base64 输出中的换行符。

2) 创建仓库密钥

在 GitHub > Repository > Settings > Secrets and variables > Actions, 添加:

密钥名称	值
CAPGO_TOKEN	您的 Capgo API token
APP_STORE_CONNECT_TEAM_ID	团队 ID 团队 ID
APPLE_KEY_ID	密钥 ID Apple 密钥、Apple 密钥 ID 和 Apple 发行者 ID
APPLE_ISSUER_ID	颁发者 ID Apple key、Apple key ID 和 Apple 颁发者 ID
BUILD_CERTIFICATE_BASE64	内容 certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP	由 CLI 生成 — 从 .capgo-credentials 文件
APPLE_KEY_CONTENT	内容 apple_key_base64.txt
P12_PASSWORD (可选)	您的 .p12 密码，如果在导出期间设置

3) 在您的 GitHub Actions 工作流中使用环境变量

github/workflows/ios-build.yml

name: iOS Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  ios-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS build with Capgo
        run: bunx @capgo/cli@latest build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}

提示

通过这种设置，CI 只通过环境变量发送凭据。您不需要提交签名文件或将它们作为工作流文件上传。

正在运行构建

现在，您已经准备好运行第一个构建。

运行以下命令以构建您的应用：

bunx @capgo/cli@latest build request --platform ios

恭喜 🎉 此时，您已经成功构建了应用程序，并且它已经准备好提交到 App Store。

提交到 App Store 审核

正常的 App Store 构建路径会将构建上传到 App Store Connect/TestFlight。如果您的 CI 发布还需要将处理后的 TestFlight 构建附加到 App Store 版本并提交到 App Review，请传递 --submit-to-store-review Terminal 窗口

npx @capgo/cli@latest build request com.example.app \
  --platform ios \
  --build-mode release \
  --ios-distribution app_store \
  --submit-to-store-review \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales" \
  --no-ios-automatic-release

需要 App Store Connect API 密钥凭证（APPLE_KEY_ID, APPLE_ISSUER_ID, APPLE_KEY_CONTENT）。App 专用密码上传和 APP_STORE_CONNECT_TEAM_ID分发不能提交构建进行评审。 ad_hoc 是 App Store 版本；如果省略，__CAPGO_KEEP_0__ 会从 Xcode 项目中读取。 --store-release-name 是 App Store 版本；若省略，Capgo 会读取 MARKETING_VERSION 个 --store-release-notes 都 --store-release-notes-locale "locale=notes" 入口可以覆盖它以适应商店本地化。使用 --ios-automatic-release 以苹果审批后自动发布，或者 --no-ios-automatic-release 等待手动发布。 --ios-testflight-groups 仍然可用于外部beta分发，但它并不是App Store审查提交所必需的。

内部测试或CI artifact收集的目的而不是App Store分发的

默认情况下，Capgo 构建 iOS 应用程序以适应 App Store 分发（TestFlight + App Store）。如果您需要 ad-hoc 构建（用于内部测试或 CI artifact 收集），则可以使用 --ios-distribution 注意

Note

不是 not 与企业（内部）分发相同。企业分发需要单独的Apple Developer Enterprise帐户并使用不同的配置文件。Capgo目前支持 app_store 和 ad_hoc 仅限模式。

何时使用ad-hoc模式

• 您想直接将IPA分发给注册设备（不使用TestFlight）
• 您没有或不想使用App Store ConnectAPI密钥
• 您想通过 --output-upload 而不提交到App Store

要求

ad-hoc构建有 比 App Store 构建少的要求： 而 App Store 构建：

凭证	是否需要？
分发证书（.p12)	是
区域：Capgo 解决方案营销页面。角色：短 UI 标签或导航项。见于：页面解决方案/ beta 测试.astro。消息键 `solutions_beta_testing_compare_native_tf` (解决方案 Beta 测试比较本地 Tf)。 | 区域：Capgo 解决方案营销页面。角色：短 UI 标签或导航项。见于：页面解决方案/ pr 预览.astro。消息键 `solutions_pr_compare_native_tf` (解决方案 Pr 比较本地 Tf)。.mobileprovision)	是
自助服务配置文件（--apple-team-id)	是
App Store Connect API 密钥 (.p8)	No
Apple Key ID / 发行者 ID	否

注意

在 ad_hoc 模式下， --apple-key, --apple-key-id和 --apple-issuer-id 不受支持且被忽略。 这就是为什么上面两个App Store Connect行不显示 ad-hoc CLI 标志;这些选项仅适用于 app_store 模式。

警告

没有 App Store Connect API 密钥，构建号自增使用时间戳fallback。要抑制警告，请传递 --skip-build-number-bump.

创建一个 ad-hoc 配置文件

按照相同的步骤 配置文件但是，在第 5 步中选择 Ad Hoc 而不是 App Store:

1. 前往 Apple Developer Profiles
2. 点击 + 按钮
3. 选择 应用程序配置 点击继续
4. 选择您的应用程序和分发证书
5. 选择您要注册的设备
6. 命名并下载配置文件

保存 ad-hoc 凭据

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --ios-distribution ad_hoc \
  --apple-team-id YOUR_TEAM_ID \
  --certificate './certificate.p12' \
  --ios-provisioning-profile './adhoc_profile.mobileprovision'

否 --apple-key, --apple-key-id, 或 --apple-issuer-id 需要.

运行一个 ad-hoc 构建

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc

为了将 IPA 作为构建物品收集起来，请添加 --output-upload:

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc \
  --output-upload

CI/CD 与 ad-hoc 构建

对于 GitHub Actions，您需要比 App Store 构建少一些密钥:

github/workflows/ios-adhoc-build.yml

name: iOS Ad-Hoc Build

on:
  workflow_dispatch:

jobs:
  ios-adhoc:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS ad-hoc build
        run: bunx @capgo/cli@latest build request --platform ios --ios-distribution ad_hoc --output-upload
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP_ADHOC }}
          CAPGO_IOS_DISTRIBUTION: ad_hoc

提示

注意到 APPLE_KEY_ID, APPLE_ISSUER_ID， APPLE_KEY_CONTENT 不需要用于 ad-hoc 构建。

包含扩展的应用程序（多目标签名）

如果您的应用程序包含扩展（共享扩展、小部件、通知服务扩展等），则每个扩展目标都需要自己的分发配置文件。Capgo 支持此功能通过可重复的 --ios-provisioning-profile 标志。

示例：应用程序 + 共享扩展

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile "com.example.app=./app_profile.mobileprovision" \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

每个 --ios-provisioning-profile 标志映射一个 bundle ID 到其配置文件。 CLI:

1. 读取每个 mobileprovision 文件
2. 自动从嵌入的 plist 中提取配置文件名称
3. 以 Base64 编码文件
4. 将所有内容存储为一个 CAPGO_IOS_PROVISIONING_MAP 凭证

提示

您需要为所有目标创建一个分布式证书 — 只有配置文件根据目标而异。

从单一配置迁移

如果您以前使用过 BUILD_PROVISION_PROFILE_BASE64 终端窗口

bunx @capgo/cli@latest build credentials migrate --platform ios

迁移后，使用以下命令添加扩展配置文件（累积合并）： CAPGO_IOS_PROVISIONING_MAP Terminal windowBUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Copy to clipboard update After migration, add extension profiles with the

bunx @capgo/cli@latest build credentials update \
  --platform ios \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

提示

使用 update (不 save)添加配置文件到现有的凭据中。该 update 命令将新配置文件与现有的配置文件合并。仅在从头开始设置所有凭据时使用。 save 故障排除

标题：故障排除

标题：配置文件不包含 XYZ 能力。

故障排除

Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"

这发生的原因是您在创建分发配置文件后启用了一个新功能。 旧的分发配置文件尚未包含新功能。

要解决此问题，请需要重新生成分发配置文件。

1. 打开 苹果开发者门户
2. 在下拉菜单中选择正确的团队
3. 点击 Profiles 按钮
4. 找到要重新生成的分发配置文件
5. 点击 Apple Developer Edit 按钮
6. 点击 Apple Developer Save 按钮
7. 点击 Apple Developer Download 按钮
8. 重新运行 Capgo 原生构建设置命令 使用新下载的配置文件

问题应该得到解决

其他问题

如果您遇到任何问题，例如Capgo原生构建、配置凭据或构建应用，请不要犹豫，通过我们的 支持.

继续从iOS构建

如果您正在使用 iOS构建 来规划CI/CD自动化，连接它到 Capgo CI/CD Capgo CI/CD Capgo 原生构建 为Capgo原生构建的产品工作流程 Capgo集成 为Capgo集成的产品工作流程 CI/CD集成 为CI/CD集成的实现细节 GitHub动作集成 为GitHub动作集成的实现细节