iOS Builds

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

你将学到什么

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

前提条件

• 一个 Capgo 帐户（免费试用即可开始）
• 你的应用已经在 Capgo 注册（如果没有，请运行 bunx @capgo/cli@latest app add }]}
• A Mac computer with Xcode installed (it’s possible to setup the build on a linux/windows machine, but it’s not yet documented)
• 有效的Apple Developer账户（$99/年）(您必须在Apple Developer账户上具有管理员或拥有者权限)
• 您的应用程序必须能够通过Xcode成功构建
• 一个Capacitor应用
• 应用程序的已配置图标。没有图标的应用程序无法上传到App Store。

注意

我将使用以下应用程序进行教程: https://github.com/Cap-go/capgo-native-build-tutorial-app

在Apple的门户网站中

在设置证书或触发首次TestFlight上传之前，确保Apple账户和团队准备就绪:

• 启用用于注册的Apple Account的两因素身份验证
• 选择合适的会员类型:
  • 个人/独资企业:您的法律姓名将成为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联系信息

注意

有用的官方参考资料:

• 成为苹果开发者计划的成员
• 提交你的应用和游戏
• App Store Connect中的平台版本信息

注意

苹果会定期更新其最低SDK要求。截至 2026年4月28日在App Store Connect上传的iPhone和iPad应用必须使用 iOS & iPadOS 26 SDK 或更高版本.

推荐：自动登录

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

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

以下手动步骤仅适用于那些希望自己设置凭证或了解 Capgo 在幕后做了什么的人。

第一个手动构建

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

• 您将在本地机器上设置分发证书
• 您将创建 App Store 记录，如果您尚未完成此项，请务必完成
• 您将能够解决与应用程序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 按钮

   在 Xcode 工具栏中找到并点击 product -> archive button.

   

3. 等待构建完成

4. 点击 Distribute App button

   

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

   

6. 配置应用记录

   填写以下字段:

   1. Name: 应用程序名称 - 在 App Store 中可见
   2. SKU - 应用程序 SKU - 在 App Store 中用于识别应用程序
   3. 应用程序的主要语言 - 应用程序的主要语言

   然后，点击 next 按钮

   

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

8. 等待上传完成

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

10. 点击 Done 按钮

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

1. 加入TestFlight
2. 完成出口遵从性，以便构建成为可测试的
3. 填写App Store Connect所需的元数据，如您的支持URL、隐私政策URL和年龄等级
4. context":"Page/area：解决方案页面应用程序示例部分。角色：短的UI标签或导航项。见于：组件解决方案/解决方案应用程序示例.astro。消息键`solution_app_examples_rating`（解决方案应用程序示例等级）。
5. 准备匹配您实际支持的设备的截图

添加App Review联系信息和任何测试凭证，生产提交之前

让我们从第一个开始：

1. 添加到TestFlight 前往App Store Connect页面 前往App Store Connect

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

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

4. 点击 Apps 按钮

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

6. 点击 TestFlight 按钮

7. 点击内部测试者按钮 Internal Testers plus 按钮

8. 创建一个新组

   我喜欢将组命名为“内部”。您可以给它任何名称。

   

9. 点击 Invite testers 按钮

10. 将自己添加到组中

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

    

11. 验证您已加入组

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

    

恭喜 🎉 您已将自己添加到TestFlight中。现在，还有一件事需要做 您可以配置Capgo Native Build之前。

设置合规信息

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

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. 保存文件

注意

这里 是苹果官方文档关于如何告知苹果您遵守加密出口管制规定的说明。

安装TestFlight应用并接受邀请

现在，您已经 差不多 准备好在 TestFlight 中测试您的应用。 在此之前，您需要完成以下步骤：

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

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

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

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

2. 点击 View in TestFlight 按钮

3. 点击 Install 按钮

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

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

5. 等待应用安装

6. 点击 Open 按钮并点击

恭喜 🎉 您已接受 TestFlight 测试应用的邀请。现在，您可以配置 Capgo 原生构建来构建和提交应用到 TestFlight。

配置Capgo原生构建

要在TestFlight中构建和提交您的应用，您需要在Capgo原生构建中配置一些内容。 以下是您将传递给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	iOS 分发证书路径（.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. 前往 Apple Developer Account 并滚动到底部

2. 找到 Team ID

   

Apple key、Apple key ID 和 Apple 发行者 ID

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

macOS：让 Capgo 为您创建此密钥

在 macOS 上 capgo build init 可以让 App Store Connect 为您创建此 API 密钥。 选择 “不 — 为我创建一个” 并打开一个引导式窗口 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 按钮

7. 保存密钥 ID

   注意

   这是 需要保存它以备后用 App Store Connect 复制密钥 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 option when running configuration command.

   

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

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

   

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

配置文件

Page/area: Capgo Builder / native cloud build product page. Role: Short UI label or navigation item. Seen in: page native-build.astro. Message key `native_build_v2_wiz_ios_s3_l` (Native Build V2 Wiz Ios S3 L).

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

2. 前往 Apple Developer Profiles 页面。

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

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

   

4. 点击 + 按钮

5. 选择资料类型 选择 App Store Connect 并点击 Continue 按钮

   

6. 选择您要构建的应用

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

   

7. 选择正确的分发证书

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

   

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

   

8. 命名配置文件

   为您的配置文件命名并点击 Generate 按钮

   提示

   配置文件名称将自动从 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:导出的证书路径 .p12 :下载的路径
• --ios-provisioning-profile证书 .mobileprovision 文件（bundle ID自动推断为单个配置文件）

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

Apple认证失败？ 同步时钟

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

查看 构建器故障排除指南 查看

CI/CD setup (GitHub Actions)

标题：CI/CD设置（__CAPGO_KEEP_0__ Actions） 团队 ID, Apple key、Apple key ID 和 Apple 发行者 ID, 证书, 和 配置文件, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

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 令牌
APP_STORE_CONNECT_TEAM_ID	团队 ID 团队 ID
APPLE_KEY_ID	密钥 ID Apple key, Apple key ID and Apple issuer ID
APPLE_ISSUER_ID	Issuer ID from Apple key, Apple key ID and Apple issuer ID
BUILD_CERTIFICATE_BASE64	Content of certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP	Generated by CLI — copy from .capgo-credentials file
APPLE_KEY_CONTENT	Content of apple_key_base64.txt
P12_PASSWORD Your	password if set during export .p12 3) 在您的 __CAPGO_KEEP_0__ Actions 工作流中使用环境变量

Section titled “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 带有发布构建:

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_STORE_CONNECT_TEAM_ID。App 专用密码上传和 ad_hoc 分发不能提交构建进行审查。 --store-release-name 是 App Store 版本；如果省略，Capgo 会从 Xcode 项目中读取 MARKETING_VERSION App Store 评审 --store-release-notes 是App Store的fallback What’s New文本，每个 --store-release-notes-locale "locale=notes" 条目可以覆盖它以适应店铺本地化。使用 --ios-automatic-release 来自动发布苹果批准后，或者 --no-ios-automatic-release 等待手动发布。 --ios-testflight-groups 仍然可用于外部beta分发，但它不是App Store审查提交所必需的。

内部测试或CI artifact集合所需的

By default, Capgo builds iOS apps for App Store distribution (TestFlight + App Store). If you need ad-hoc builds instead (for internal testing or CI artifact collection), you can use the --ios-distribution 条目

条目

条目 不一样于企业（内部）分发。企业分发需要一个单独的Apple Developer Enterprise账户，并使用不同的配置文件。__CAPGO_KEEP_0__目前支持 the same as Enterprise (In-House) distribution. Enterprise distribution requires a separate Apple Developer Enterprise account and uses different provisioning profiles. Capgo currently supports app_store 仅限以下模式： ad_hoc 何时使用ad-hoc模式

使用ad-hoc模式的时机

• 您没有或不想使用App Store Connect__CAPGO_KEEP_0__密钥
• You don’t have or don’t want to use an App Store Connect API key
• 不提交到App Store --output-upload 要求

使用ad-hoc模式的要求']} ]}

App Store 内部构建比外部 App Store 构建有 App Store 内部构建比外部 App Store 构建少 App Store 内部构建比外部 App Store 构建有

App Store 内部构建需要	是否需要凭证?
分布式证书（.p12)	是
是否需要内部 App Store 构建配置文件（.mobileprovision)	是
是否需要团队 ID（--apple-team-id)	是
是否需要 App Store Connect API 密钥（.p8)	No
Apple Key ID / Issuer ID	No

注意

在 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 配置文件

按照相同的步骤 配置文件context: Capgo Builder / 原生云构建产品页面。角色：短 UI 标签或导航项。见于：页面 native-build.astro。消息键 `native_build_v2_wiz_ios_s3_l` (Native Build V2 Wiz Ios S3 L)。 ,但在第五步中选择 Ad Hoc 而不是:

1. App Store 前往
2. Apple Developer Profiles + button
3. 选择 Ad Hoc 并点击继续
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 作为构建 artifact，添加 --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 到其配置文件。 The 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 迁移后，请使用以下命令（累积合并）添加扩展配置文件：BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

终端窗口 update 复制到剪贴板

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 故障排除

区域/页面: 支持 / 高级支持页面或底部支持部分。角色: 部分或页面标题。见于: 页面 support-policy.astro。消息键 `support_policy_troubleshooting_title` (支持政策故障排除标题)。

配置文件不包含 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. 点击 Edit 按钮
6. 点击 Save 按钮
7. 点击 Download 按钮
8. 重新运行 Capgo 原生构建设置命令 使用刚下载的资料

解决此问题应有所帮助。

其他问题

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

继续从iOS Builds

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