跳转至正文
告别手动 Native Build

还在手动构建 iOS
和 Android 应用吗？

别再把时间浪费在手动构建上了。 环境不一致导致 Bug，团队成员苦等构建。每一次手动部署都在损耗你的开发效率。

如果每次 commit 都能 自动触发构建呢？

Capgo Build 让你的 CI/CD pipeline 在云端触发经过签名的 iOS 和 Android 构建，随后即可下载产物或直接提交至应用商店。

查看工作流

✓ Capgo 构建 • ✓ iOS & Android CI/CD • ✓ 适配 GitHub Actions

Native Build 的噩梦

每位移动端开发者都深知手动构建的痛苦。下面看看 Capgo Build 如何融入 CI/CD。

没有 CI/CD

数小时的手动构建

开发者在重复的构建流程中浪费时间

环境不一致

因构建环境不同导致的“在我机器上能跑”类 Bug

证书与签名混乱

手动管理证书会导致构建过期

缺乏构建历史

无法追踪何时构建了什么，也无法复现历史构建

结果：发布缓慢、团队瓶颈、浪费开发时间

使用 Capgo Build CI/CD

无需 Mac 即可构建 iOS

云端构建让整个团队都能构建 iOS 应用

自动化签名与证书管理

告别证书过期或 Provisioning Profile 烦恼

始终如一的构建质量

环境一致，结果可靠 —— 彻底解决“在我机器上能跑”的问题

自动提交应用商店

自动上传至 TestFlight 和 Play Console

助力团队高效协作，构建更可靠，发布更快速

完美适配您现有的 CI/CD 工作流

GitHub 操作
GitLab CI
Jenkins Jenkins
CircleCI CircleCI
+ 任何 CI/CD 平台

应用自动构建，全程可见

推送 code，看 CI/CD 处理一切——从构建、签名到部署

iOS 构建 - GitHub Actions
运行中
$ git push origin main
✓ 已触发工作流：Build & Deploy iOS
[构建 iOS] 正在配置构建环境...
✓ macOS-latest runner 已分配
✓ 已选择 Xcode 15.0
[Fastlane] 🚀 正在运行 lane: ios build
✓ 正在通过 match 同步证书...
✓ 正在安装 provisioning profiles...
[Xcode Build] 正在构建 MyApp.xcworkspace
▸ 正在编译 AppDelegate.swift
▸ 正在编译 ViewController.swift
▸ 正在链接 MyApp
✓ 构建成功 (2m 34s)
[TestFlight] 正在上传至 App Store Connect...
✓ 构建版本 1.2.45 上传成功
✓ iOS 部署完成！
Android 构建 - GitLab CI
运行中
$ git push origin main
✓ Pipeline #1847 已启动
[构建 Android] 正在准备 Docker 镜像...
✓ 使用镜像：cimg/android:2023.11
[Gradle] 开始构建...
> Task :app:preBuild UP-TO-DATE
> Task :app:preReleaseBuild UP-TO-DATE
> Task :app:compileReleaseJavaWithJavac
> Task :app:bundleRelease
构建成功 耗时 1m 42s
✓ 已生成 app-release.aab
[Play Console] 正在上传至 Google Play...
✓ AAB 已上传至内部测试轨道
✓ Release 1.2.45 已创建
✓ Android 部署完成！
0
需要手动操作
iOS + Android
统一工作流
2–3 分钟
典型构建耗时

高级 CI/CD 功能

利用这些强大的功能，让您的部署策略更进一步

多环境部署

根据分支、环境或自定义条件部署到不同 channel。非常适合 staging、beta 和 production 工作流。

  • 基于分支的部署
  • 特定环境的 channel
  • 条件化部署

渐进式发布

从少量用户开始，逐步扩大范围。监控指标，并自动停止有问题的部署。

  • 按百分比发布
  • 出错时自动停止
  • 基于指标的决策

REST API 集成

完整的 API 访问权限，用于自定义集成。构建自己的部署工具，或与现有系统集成。

  • 完整的 REST API
  • 自定义集成
  • Webhook 通知
CI/CD 中的 Capgo Build

从你的 Pipeline 交付 Native Build

Capgo Build 可无缝接入您现有的 CI/CD 工作流：安装依赖、构建 Web 资源、同步 Capacitor，然后调用 Capgo CLI 在云端编译已签名的 Native Build。

定价

单个 Capgo 方案包含 OTA 更新、每月约 15 次 Native Build，并支持通过积分按需购买额外的构建时长。

起步价

$12/月

按年计费

包含额度

OTA + 约 15 次构建

每月

积分消耗

按分钟计费

用于购买额外的构建时长

1

初始化 Build

在 Capgo 中注册应用，并在本地运行一次构建向导，以验证 iOS 证书、描述文件、Android keystore 和应用商店凭据。

2

导出 Secrets

使用凭据管理器导出一个本地 .env.capgo.* 文件，然后用以下命令将其推送到 GitHub Actions secrets： gh secret set -f.

3

添加 Workflow

你的 workflow 会安装依赖、运行 Web 构建、同步 Capacitor，并触发 @capgo/cli build 针对 iOS、Android 或两者的构建。

4

发布或测试

通过按钮触发 debug 构建，通过 tag 触发 release 构建，或在 main 上触发 smoke 构建。上传 artifacts 供 QA 使用，或将 release 构建提交到应用商店。

核心 CI 命令

先在本地运行 setup 并导出凭据，等你的项目构建和 Capacitor 同步完成后，再让 CI 调用 Capgo Build。

npx @capgo/cli@latest build init
npx @capgo/cli@latest build credentials manage --appId com.example.app
gh secret set CAPGO_TOKEN --body "your_capgo_api_key_here"
gh secret set -f .env.capgo.com.example.app

npm ci
npm run build
npx cap sync
npx @capgo/cli@latest build request com.example.app --platform android --build-mode release

CI 密钥包含哪些内容

  • Capgo API 密钥： CAPGO_TOKEN 具备构建权限。
  • iOS 签名： 证书、密码、描述文件映射、App Store Connect 密钥、issuer 和 team ID。
  • Android 签名： keystore、alias、密钥密码以及 Play Console 服务账号 JSON。
  • 可选的产物输出： 添加输出上传标志，用于生成 QA 下载链接和二维码。
查看 GitHub Actions 指南 管理构建凭据 开始使用 Capgo 构建

AI Agent 驱动的 CI/CD

让你的 Agent 编写 pipeline 并读取 build logs

Agent Skills 教 Claude Code、Codex 或 Cursor 如何把 Capgo Build 接入 GitHub Actions 或 GitLab CI。Capgo MCP server 让 Agent 发起构建，并在构建失败时读取 build logs。

试着这样问你的 Agent

  • 添加一个 GitHub Actions workflow，用 Capgo 构建我的 iOS app
  • 上次 Android build 为什么失败？查看 build logs
  • 每次 merge 到 main 时，从 CI 上传一个 live update bundle
探索 AI 工具

从 Expo 迁移过来？

Capacitor 的 EAS Workflows 替代方案

EAS Workflows 是 Expo 为 React Native 提供的托管 CI/CD。Capgo 则是 Capacitor 路径：保留 GitHub Actions、GitLab CI 或 Jenkins，然后调用 Capgo Build 来生成已签名的 iOS 和 Android 构建产物。Capgo 并非 EAS Workflows 的直接替代运行器，也不支持构建 Expo 项目。

对比 Capgo 与 Expo Application Services 打开 Capgo Builder →

客户证言

团队通过 Capgo 自动化 Capacitor 发布

一条流水线搞定 Native Build 和 Live Updates，全程无需 Mac。

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

sikafanka

设计，圆角半径 5

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

Nate van Jole

CTO, 私有

“配置不到一天就完成了。基于 Channel 的发布让我能先在自己的设备上测试，再推给生产用户。”

Kapil

NuTriQ 创始人

“无需等待完整的 App Store 审核周期，就能即时推送生产环境的 OTA 更新，这为我们带来了巨大的运营优势。”

准备好自动化 Native Build 了吗？

在 CI/CD 流水线中使用 Capgo Build 来编译、签名、测试并发布原生 iOS 和 Android build。

Live Update CI/CD 文档

Capgo 构建 • GitHub Actions 示例 • 凭据存储在 CI secrets 中