iOS 构建
运行在专用的 Mac Mini Silicon M4 机器上——无需自备 Mac。
Capgo Build 简介
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
Capgo Build 是一款面向 Capacitor 应用的云端原生应用编译服务。它让你无需维护本地开发环境，就能构建 iOS 和 Android 应用——自己的机器上不需要 Xcode、Android Studio 或 Mac 硬件。
Capgo Build 的作用
章节标题为“Capgo Build 的功能”Capgo Build 编译 原生部分 您 Capacitor 应用的原生部分，在云端：
Android 构建
在同一 M4 集群上构建，支持 Android Studio 2025。
自动 Code 签名
证书、描述文件和 keystore 都由我们帮你搞定。
直接提交到应用商店
签名后的应用可直接上传到 App Store Connect 和 Google Play。
用一条 CLI 命令触发构建，在哪都能用——本地机器、GitHub Actions、GitLab CI 或任意 CI/CD pipeline。
构建机与工具链
章节标题为“构建机器与工具链”Capgo Build 在专用的 Mac Mini Silicon M4 机器上运行原生任务：
| 组成部分 | 规格参数 |
|---|---|
| 机型 | Mac Mini 芯片 M4 |
| CPU | 10 核 M4 CPU（4 个性能核心，6 个能效核心） |
| GPU | 10 核 GPU |
| 神经网络引擎 | 16 核神经网络引擎 |
| 内存 | 16GB 内存 |
| OS 镜像 | macOS Tahoe 26.2 |
该构建镜像支持 Xcode 26.2 和 Android Studio 2025，适用于 Native Build 流水线。
何时使用 Capgo Build 与 Live Updates
章节标题：“何时使用 Capgo Build 与 Live Updates”Capgo 提供两种互补的 App 更新方案。以下是各自的使用场景：
| 场景 | Capgo Live Updates | Capgo 构建 |
|---|---|---|
| 修复 JavaScript/TypeScript code 中的 Bug | ✓ | |
| UI 变更（HTML、CSS、图片） | ✓ | |
| 更新 Web 依赖 | ✓ | |
| 添加或移除 Capacitor 插件 | ✓ | |
| 更新原生 SDK 版本 | ✓ | |
| 修改原生权限（Info.plist、AndroidManifest） | ✓ | |
| 更新 Capacitor 版本 | ✓ | |
| 修改原生 code（Swift、Kotlin、Java） | ✓ | |
| 更换 App 图标或启动页 | ✓ | |
| 首次提交应用商店 | ✓ |
为什么使用 Capgo Build
标题为“为什么使用 Capgo Build”的章节iOS 无需本地 Mac
无需拥有 Mac 硬件即可构建并发布 iOS 应用。使用 Windows、Linux 或任何 CI/CD 系统的人都能触发 iOS 构建并发布到 TestFlight。
跳过本地环境配置
无需安装 Xcode、Android Studio，也不用管理 SDK 版本。Capgo Build 会处理所有原生工具链 —— 您只需运行 CLI 命令。
集中管理凭据
将证书和 keystore 一次性存入 CI/CD secrets。任何团队成员都能触发构建，无需在本地机器上配置签名凭据。
支持任何 CI/CD
只需一条 CLI 命令，即可接入任何 pipeline。无论是 GitHub Actions、GitLab CI 还是 Jenkins，都能在现有工作流中触发 build。
实时 Build 日志
在终端实时查看 build 进度。日志会通过 Server-Sent Events 流式输出，让你能在问题发生时立即调试。
直接提交到应用商店
已签名的 App 会直接上传到 App Store Connect 和 Google Play。从 build 完成到商店提交，无需任何手动步骤。
工作原理
标题为“工作原理”的章节运行 build 命令时：
- 上传 - CLI 只会打包必要内容（原生平台文件夹 + 原生依赖），并上传到安全的云存储。
- 构建 - 你的应用通过 Fastlane 在专用基础设施上编译。重复构建默认会恢复每个应用的编译缓存（省略
cache_key该参数以使用共享通用缓存）；设置--cache-key用于区分 RC 和生产环境的参数，或传入--no-cache用于禁用恢复和保存的参数 - 签名 - 证书和 keystore 会被应用（它们仅在构建期间存在于内存中）
- 提交 - 已签名的应用会直接上传到 App Store Connect 或 Google Play
- 清理 - 所有构建产物和凭据都会被自动删除
你的源码 code 保留在你的机器上。只会上传平台特定的原生 code。
安全模型
“安全模型”章节Capgo Build 采用零凭据存储设计：
- 仅运行时凭据 - 证书和 keystore 绝不会存储在 Capgo 中。它们会被上传，并在 build 完成后立即移除。
- 临时环境 - 每次 build 都在隔离环境中运行，完成后即销毁
- 无日志存储 - Build logs 仅流式传输到你的终端，绝不会存储在 Capgo 服务器上
- 最小化上传 - 只上传你指定的原生平台，而不是整个代码库。 查看具体上传内容
构建时间是唯一的成本：
- 构建分钟数包含在您的 Capgo 套餐中
- 额外分钟数可通过积分系统获取
- 构建在已预装原生工具链的 Mac Mini Silicon M4 机器上运行
- 无存储费用
下一步
“后续步骤”章节
快速入门
创建你的第一个构建，看看 Capgo Build 如何运作。
凭据设置
配置 iOS 证书和 Android keystore。
自动 OTA 或原生
自动选择 live update 或 Capgo Build 的 CI。
从 CI UI 触发
通过 GitHub、GitLab、Bitbucket 或 Azure 启动 Native Build。
构建 Webhooks
通过 HTTP 在管理后台触发 Capgo Build。
预扫描检查
完整的构建前检查列表，以及如何跳过特定规则或将其设为警告。
GitHub 操作
包含 Secrets 和发布工作流的完整 Capgo Build CI 配置。
