Do I need a Mac at any point?

Not to compile, sign, or upload. Builds run on Capgo's Mac mini M4 machines. You still need an Apple Developer account. On Windows or Linux, you create the App Store Connect API key in your browser, then the CLI handles certificates and profiles.

How long does an iOS build take?

A typical native build takes 2–3 minutes. Logs stream to your terminal while it runs, so you see errors as they happen.

Can the build go straight to TestFlight?

Yes. With an App Store Connect API key in your credentials, the signed build uploads to App Store Connect, where you test it in TestFlight and submit it for App Store review. Add --output-upload if you also want a download link for the IPA.

Where are my certificates stored?

On your machine, in ~/.capgo-credentials/credentials.json by default, or in your CI secrets. They are sent to Capgo only for the duration of a build and deleted afterwards.

Do I need a new build for every change?

No. Plugin, permission, icon, and Capacitor version changes need a new native build. JavaScript, HTML, CSS, and asset changes can ship as live updates to users who already have the store build.

面向 Windows 和 Linux 开发者

无需 Mac 即可构建 iOS 应用

Capgo 会在云端 Mac 机器上编译并签名您的 Capacitor iOS 应用。在 Windows、Linux 或 CI 中运行一条 CLI 命令，签名后的构建就会上传到 App Store Connect，供 TestFlight 使用。

2–3 分钟

典型 Native Build 耗时

iOS + Android

来自同一个 CLI

TestFlight

直接 upload 至 App Store Connect

Capgo 构建

npx @capgo/cli@latest build init --platform ios
npx @capgo/cli@latest build request --platform ios
# signed build runs on an ephemeral Mac runner
# logs stream back to your terminal

云端 Mac 机器

iOS builds 在专用的 Mac mini M4 机器上运行。你可以直接通过现有的电脑启动构建。

已签名并上传

Build 已用你的证书签名并上传到 App Store Connect，可直接用于 TestFlight。

问题

Xcode 只能在 macOS 上运行

没有 Mac，就无法构建 iOS

Apple 的构建工具需要 macOS。使用 Windows 或 Linux 的开发者无法在自己的机器上编译或签名 iOS 构建。

签名只在一台笔记本上

证书和配置文件常常只放在某个人的 Mac 上。这个人不在或配置文件过期时，发布就得等。

自建 macOS CI 本身就是个工程

租来的 macOS runner 仍然需要更新 Xcode、维护 Fastlane lane、管理签名密钥，并在 Apple 有改动时调试。

隐藏的工作

除了 Mac，发布构建还需要什么

购买 Mac 只解决了硬件部分。你仍需配置 Apple 账号、准备签名文件，并维护需要有人持续打理的构建工具链。

Apple 账号配置

拥有管理员权限的 Apple Developer 账号、Bundle ID、App Store Connect 应用记录，以及用于上传的 API 密钥。

签名文件与描述文件

导出为 .p12 的发布证书、每个 Bundle ID 对应的 Provisioning Profile，以及过期后的续期。

构建工具链

合适的 Xcode 版本、CocoaPods 或 Swift Package Manager、Fastlane，以及存放 CI 密钥的地方。

工作原理

Windows 和 Linux 开发者如何通过 Capgo 发布 iOS 应用

你需要一个 Capacitor App、一个 Capgo 账号以及一个 Apple Developer 账号。下面的每条命令都来自 Capgo CLI 文档。

一次性完成 iOS 签名设置

Onboarding 会读取你的 Capacitor 项目，创建发布证书和 Provisioning Profile，并保存到你的机器上。
```
npx @capgo/cli@latest build init --platform ios
```
iOS Build 指南

或者保存现有的签名文件

如果你的团队已有证书和描述文件，请配合 App Store Connect API 密钥进行保存。它们将存储在本地凭据文件中。

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

凭据管理

发起构建请求

将 Web build 同步到 iOS 项目中，然后发起构建请求。日志会实时流式传输到你的终端，签名后的 build 会自动 upload 到 App Store Connect 以供 TestFlight 使用。
```
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
```
首次构建指南
在 CI 中运行相同命令

使用 build credentials manage 将保存的凭据导出为 CI secrets，设置 CAPGO_TOKEN，即可在 GitHub Actions、GitLab CI 或任何 runner 中运行构建请求。
```
npx @capgo/cli@latest build credentials manage
# in your CI job
npx @capgo/cli@latest build request com.example.app --platform ios
```
GitHub Actions 设置

解决方案

Capgo Build 为您处理的一切

当 native code 发生变化时，Native Build 会在云端运行；Web 变更则在两次商店发布之间继续以 Live Updates 交付。

仅在 Build 时使用云端 Mac

iOS 构建在预装 Xcode 的专用 Mac mini M4 机器上运行。你的 Windows 或 Linux 笔记本，或 CI runner，只需从终端发起请求。

Capgo Build 概览

引导式 iOS 签名

build init 会为你自动创建分发证书和 provisioning profile。它使用 App Store Connect API 密钥，你可以在 Windows 或 Linux 环境下通过浏览器进行创建。

iOS Build 指南

本地与 CI 使用相同的命令

只需一次性保存凭据，即可通过终端、GitHub Actions、GitLab CI 或任何其他 pipeline 发起 build 请求。

build 命令参考

Native Build 结合 Live Update

当插件、权限、图标或 Capacitor 版本发生变化时，请使用 Capgo Build。在用户安装商店版本后，你可以通过 Live Update 快速推送 JavaScript、CSS 和资源文件的变更。

Live update 还是 Native Build？

信任模型

无需交付 code 和密钥，即可使用云端硬件

凭据只保留在你的机器上或 CI secrets 中。Capgo 只在构建运行期间持有它们。

仅上传原生项目

CLI 会上传原生平台文件夹和原生依赖。你的完整仓库仍留在你的机器上。

日志流式输出到终端

构建日志会在构建运行期间实时流式输出，不会存储在 Capgo 服务器上。

凭据只在构建期间存在

证书和描述文件只在构建期间于内存中使用，构建完成后即被删除。每次构建都在隔离环境中运行，结束后该环境会被销毁。

使用 Capacitor 构建的应用

业务应用不应受限于单台本地 Mac

当团队主要由 Web、支持或运维人员组成时，学校、交通和支持类应用仍需要签名的移动端版本。托管构建工作流消除了单机瓶颈，同时让签名步骤保持可重复。

教育

IRIS ParentMail

学校通讯应用，即使是非原生开发团队也需要可靠的签名版本。

Google Play 安装量: 120万; Google Play 安装量
应用商店评分: 2.8; 应用商店评分

旅游与本地

KAI Access: 火车订票应用

交通订票应用，其版本交付不应依赖于单一的开发机。

Google Play 安装量: 13.5M; Google Play 安装量
应用商店评分: 3.6; 应用商店评分

工具

虚拟技术员 – 技术支持

为需要可重复移动端构建记录的运维团队提供的支持工具。

Google Play 安装量: 10.3M; Google Play 安装量
应用商店评分: 4.3; 应用商店评分

下一个发布通道

让您的应用也能使用相同的发布控制。

创建受控发布渠道，发布一个小型 Web 更新，并从首个版本起就准备好回滚。

可重复的 iOS 和 Android 签名
无需本地硬件即可交付发布
由 CI 管理的构建记录

客户证言

使用 Capgo 交付的团队怎么说

5.0/5 开发者团队评分 9,400+ 团队查看评价

sikafanka

设计，圆角半径 5

“Capgo Build 帮我们简化了 Capacitor 应用的发布流程。通过一套清晰的工作流，我们就能构建并发布 iOS 和 Android 应用。”

Mikołaj Wilczek

Tellent 移动平台首席工程师

“我们最初是通过插件发现 Capgo 的，事实证明，这为我们的团队开启了一个更高效的发布流程。”

常见问题

关于无需 Mac 构建 iOS 的疑问

Windows 和 Linux 开发者在首次云端 iOS 构建前常问的问题。

我在任何阶段都需要 Mac 吗？

编译、签名或上传都不需要。构建在 Capgo 的 Mac mini M4 机器上运行。你仍然需要 Apple Developer 账号。在 Windows 或 Linux 上，你在浏览器里创建 App Store Connect API 密钥，然后由 CLI 处理证书和描述文件。

iOS Build 指南

iOS 构建需要多长时间？

典型的 Native Build 需要 2-3 分钟。运行期间日志会实时流式传输到终端，方便你即时查看错误。

首次构建指南

Build 可以直接发布到 TestFlight 吗？

可以。只要在凭据中配置 App Store Connect API key，签名后的 build 就会自动上传到 App Store Connect，你可以在 TestFlight 中进行测试并提交 App Store 审核。如果还需要 IPA 的下载链接，请添加 --output-upload 参数。

Build 配置

我的证书存储在哪里？

默认存储在你本地机器的 ~/.capgo-credentials/credentials.json 中，或者存储在你的 CI secrets 中。它们仅在 build 期间发送至 Capgo，并在完成后立即删除。