跳过主内容
Capgo logo
不再手动构建原生代码

仍然手动构建iOS & Android
为什么还要手动构建APP?

手动构建耗时数小时 不同环境导致bug，团队成员等待构建，生产力受损 每次手动部署都在减少生产力

如果构建可以 自动触发每次提交?

Capgo Build让CI/CD pipeline触发云端的已签名iOS和Android构建，然后下载构建文件或提交到应用商店

查看工作流

✓ Capgo Build • ✓ iOS & Android CI/CD • ✓ GitHub Actions-ready

Native Build 构建噩梦

每个移动开发者都知道手动构建的痛苦。Capgo Build 如何融入 CI/CD 中

没有 CI/CD

手动构建花费数小时

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

环境不一致

"我的机器上工作" 的 bug 来自不同的构建环境

证书和签名混乱

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

没有构建历史

无法追踪何时构建了什么或重现过去的构建

Result: 慢速发布、团队瓶颈、浪费开发者时间

With Capgo 构建 CI/CD

Build iOS 无需 Mac

基于云的构建意味着您的整个团队都可以构建 iOS 应用

自动签名 & 证书

再也不用担心过期的证书或配置文件了

每次都能得到一致的构建

相同的环境，相同的结果 - 再也不用担心 "我的机器上工作"

自动提交应用商店

自动上传到 TestFlight 和 Play Console

Result: 高效团队、可靠的构建、更快的发布周期

与您的现有 CI/CD 设置兼容

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

从 Code 到应用商店 自动

停止手动构建 并管理证书。以下是 CI/CD 如何转变您的工作流程:

1

准备构建凭证

运行 Capgo 在本地构建一次，然后将 iOS 和 Android 签名凭证导出为 CI 秘密。 您的管道获取所需的凭证，而不需要将它们提交到 Git。

✓ 凭证在您的 CI 秘密存储中
2

推送 Code、触发 Capgo 构建

GitHub 动作、GitLab CI、Jenkins 或任何运行器都可以在您的 Web 构建和 Capacitor 同步之后调用 Capgo CLI。 不需要 Mac 运行器即可进行 iOS 构建。

✓ 从相同的工作流程中重复构建
3

下载或提交 artifact

使用调试构建进行测试，上传 artifact 进行 QA，或者让发布构建提交到 TestFlight 和 Play Store。 您的 CI/CD 工作流程控制每个路径何时运行。

✓ 同样的 CLI 对于手动和发布工作流程

您浪费了多少时间在手动构建上?

每个手动构建都耗费了数小时的开发人员时间。 不一致的环境会导致需要花费几天时间来调试的bug。 您的团队的生产力正在受损。

打开GitHub操作指南

观看您的应用程序自动构建

推送code并观看CI/CD处理所有内容 - 从构建到签名到部署

iOS构建 - GitHub操作
正在运行
$ git push origin main
✓ 触发的工作流程：构建和部署iOS
构建iOS 设置构建环境...
✓ macOS-latest运行器已预订
✓ Xcode 15.0 已经被选中
[Fastlane] 🚀 运行目标：ios build
✓ 正在同步证书与 match...
✓ 正在安装配置文件...
[Xcode Build] 正在构建 MyApp.xcworkspace
▸ 编译 AppDelegate.swift
▸ 编译 ViewController.swift
▸ 链接 MyApp
✓ 构建成功 (2m 34s)
[TestFlight] 正在上传到 App Store Connect...
✓ 已成功上传构建 1.2.45
✓ iOS 部署完成!
Android Build - GitLab CI
正在运行
$ git push origin main
✓ Pipeline #1847 已启动
[Build Android] 正在准备 Docker 镜像...
✓ 使用镜像: cimg/android:2023.11
[Gradle] 正在启动构建...
> 任务：app：preBuild UP-TO-DATE
> 任务：app：preReleaseBuild UP-TO-DATE
> 任务：app：compileReleaseJavaWithJavac
> 任务：app：bundleRelease
构建成功 1m 42s
✓ 生成 app-release.aab
[Play Console] 上传到 Google Play...
✓ 已上传到内部测试轨道
✓ 创建发布 1.2.45
✓ 安卓部署完成！
0
手动步骤要求
100%
构建成功率
5 分钟
平均构建时间

为什么使用 CI/CD 自动化?

通过这些强大的优势来转换您的移动部署工作流程

自动化原生构建

推送 code 并自动获得原生 iOS 和 Android 构建。无需手动 Xcode 或 Android Studio - 构建在云端运行。

在不拥有 Mac 的情况下构建 iOS 应用

零停机时间更新

在应用运行时，更新发生在后台。用户永远不会遇到中断或强制更新。

无缝的后台安装

自动质量门控

只有测试通过时才部署。与您的现有测试套件和质量检查集成，确保发布的安全性。

只有测试通过时才部署

即时回滚安全

构建物件自动版本化并存储。发现问题后立即回滚到任何以前的构建版本。

完整的构建历史和物件存储

高级CI/CD功能

通过这些强大的功能提升您的部署策略

多环境部署

根据分支、环境或自定义条件部署到不同通道。适合用于测试、beta和生产工作流。

  • 基于分支的部署
  • 环境特定的通道
  • 条件部署

渐进式发布

从小部分用户开始，逐渐增加。监控指标并在出现问题时自动停止发布。

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

REST API 集成

自定义集成时提供完整的 API 访问权限。您可以自行构建发布工具或与现有系统进行集成。

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

将本机构建从您的管道中发送

Capgo Build集成到您的CI/CD流程中：安装依赖项、构建Web资产、同步Capacitor，然后调用CapgoCLI以在云中编译已签名的本机应用

定价

一项Capgo计划包括OTA更新、约15个本机构建/月，以及基于信用额度的计费额外的构建分钟

起始于

$12/月

包含使用

OTA + ~15个构建

每月

信用使用

按分钟

额外的构建分钟

1

Initialize Build

在Capgo中注册应用并在本地运行构建向导，以验证iOS证书、配置文件、Android密钥库和商店凭证。

2

Export Secrets

使用凭证管理器导出一个本地文件，然后将其推送到__CAPGO_KEEP_0__ Actions secrets中。 .env.capgo.* file, then push it into GitHub Actions secrets with gh secret set -f.

3

您的工作流程安装依赖项、运行Web构建、同步__CAPGO_KEEP_0__，并触发iOS、Android或两者的构建。

Your workflow installs dependencies, runs your web build, syncs Capacitor, and triggers @capgo/cli build 从按钮触发调试构建、从标签触发发布构建或在主分支上触发烟雾测试。上传QA的工件或将发布构建提交到商店。

4

Core CI Commands

在本地运行设置、导出凭证，然后让CI调用__CAPGO_KEEP_0__ Build后您的项目构建和__CAPGO_KEEP_1__同步。

Initialize Build

Run setup locally, export the credentials, then let CI call Capgo Build after your project build and Capacitor sync.

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 com.example.app --platform android --build-mode release

What Goes Into CI Secrets

  • Capgo API key: CAPGO_TOKEN 具有构建权限。
  • iOS签名: 证书、密码、分发配置文件、App Store Connect密钥、发行者和团队ID。
  • Android签名: keystore、别名、密钥密码和Play Console服务账户JSON。
  • 可选输出文件: 添加输出上传标志以便QA下载链接和二维码。
打开GitHub Actions指南 管理构建凭证 从Capgo Build开始

准备自动化您的原生构建?

使用 Capgo 从您的 CI/CD pipeline 构建原生 iOS 和 Android 构建。

实时更新 CI/CD 文档

Capgo 构建 • GitHub 动作示例 • 凭据保留在 CI 秘密中

继续使用 Capgo CI/CD

如果您正在为 Capacitor 发布设置 CI/CD，请连接此页面 CI/CD 集成 用于基线 GitHub 动作 用于实时更新 Capgo 原生构建 对于签名二进制文件、 PR 预览解决方案 对于审查构建和 OTA Pipelines 中的常见 CI/CD bottle neck 避免慢速发布。