Capgo 入门指南

Capgo Build 是一个基于云的原生应用编译服务，专为 Capacitor 应用设计。它让您可以在不维护本地开发环境的情况下构建 iOS 和 Android 应用 - 不需要在您的机器上拥有 Xcode、Android Studio 或 Mac 硬件。

什么是 Capgo Build

Capgo Build 在云端编译 __CAPGO_KEEP_0__ 应用的 of your Capacitor app in the cloud:

iOS 构建

在专用 Mac Mini Silicon M4 机器上运行 — 不需要您自己的 Mac。

Android 构建

在同一 M4 机群上构建，Android Studio 2025 可用。

自动 Code 签名

证书、配置文件和密钥库都由系统自动处理。

直接提交

已签名的应用程序直接上传到 App Store Connect 和 Google Play。

您可以使用单个 CLI 命令触发构建，且该命令可以从任何地方使用 - 本地机器、 GitHub Actions、GitLab CI 或任何 CI/CD pipeline。

构建机器和工具链

Capgo 构建在专用 Mac Mini Silicon M4 机器上运行本机作业：

组件	规范
机器	Mac Mini Silicon M4
CPU	10核 M4 CPU（4个性能核，6个高效核）
GPU	10核GPU
Neural Engine	16核Neural Engine
Memory	16GB内存
OS image	macOS Tahoe 26.2

本构建镜像支持Xcode 26.2和Android Studio 2025用于本机构建管道。

何时使用Capgo Build vs Live Updates

Capgo提供了两种互补的功能来更新您的应用程序。以下是每种功能的使用场景：

场景	实时更新	Capgo 构建
JavaScript/TypeScript code 中的 bug 修复	✓
UI 变更 (HTML, CSS, 图片)	✓
更新 Web 依赖项	✓
添加或删除一个 Capacitor 插件		✓
更新一个本机 SDK 版本		✓
更改本机权限 (Info.plist, AndroidManifest)		✓
更新 Capacitor 版本		✓
修改本机 code (Swift, Kotlin, Java)		✓
更改应用程序图标或启动屏幕		✓
首次应用商店提交		✓

注意

实时更新 推送 JavaScript 更改立即无需应用商店审核。 Capgo 构建 code 构建创建新的本机二进制文件，当您更改本机 code 时。大多数团队每天使用实时更新，并在本机更改需要时偶尔使用 Capgo 构建。

为什么使用 Capgo 构建

不需要本地 Mac 设备进行 iOS

在不拥有 Mac 硬件的情况下构建和发布 iOS 应用程序。Windows、Linux 或任何 CI/CD 系统上的任何人都可以触发 iOS 构建并发布到 TestFlight。

跳过本地环境设置

No need to install Xcode, Android Studio, or manage SDK versions. Capgo Build handles all native tooling - you just run the CLI command.

集中凭证

只需在 CI/CD 秘密中存储您的证书和密钥库一次。任何团队成员都可以触发构建而无需在本地机器上提供签名凭证。

与任何 CI/CD 一起工作

一个 CLI 命令可以与任何管道集成。 GitHub Actions、GitLab CI、Jenkins - 在您的现有工作流程中触发构建。

实时构建日志

在您的终端中实时监控构建进度。通过 Server-Sent Events 流式传输日志，因此您可以立即调试发生问题。

直接提交应用商店

已签名的应用程序直接上传到 App Store Connect 和 Google Play。构建完成后不需要手动步骤即可提交应用商店。

如何工作

当您运行构建命令时：

1. 上传 - CLI 只上传所需的内容（本机平台文件夹 + 本机依赖项）并上传到安全的云存储中
2. 构建 - 使用 Fastlane 在专用基础设施上编译您的应用
3. 签名 - 应用程序签名和密钥库在内存中只存在于构建期间
4. 提交 - 已签名的应用程序直接上传到 App Store Connect 或 Google Play
5. 清理 - 所有构建工件和凭证都将自动删除

您的源 code 将保留在您的机器上。只上传了平台特定的本机 code。

安全模型

Capgo 构建是基于零凭证存储的：

• 仅在运行时使用凭证 - 证书和密钥库在 Capgo 中永不存储。它们在构建完成后立即上传并删除。
• 临时环境 - 每个构建都在隔离环境中运行，并在完成后销毁。
• 无日志存储 - 构建日志仅流向您的终端，永不存储在 Capgo 服务器上。
• 最小上传 - 只上传您请求的本机平台，而不是您的完整代码库。 查看上传的内容

定价

仅需构建时间费用：

• 您的Capgo计划包含建构分钟数
• 通过积分系统获取额外的分钟数
• 构建在Mac Mini Silicon M4机器上运行，内置了原生工具链
• 无存储费用

下一步

开始使用 创建您的第一个构建并亲眼见证Capgo Build的实力

凭证设置 配置iOS的证书和Android的密钥库

iOS Builds iOS应用程序的构建和提交指南。

Android Builds Android应用程序的构建和提交指南。