Introducing Capgo Cloud Build - Build Native Apps Without the Hassle

我们很高兴地宣布 Capgo 云构建 - 一种新方法来在云端直接构建您的 Capacitor 应用程序，适用于 iOS 和 Android，无需本地开发环境或 CI/CD 基础设施

我们解决的问题

构建原生移动应用一直是 web 开发者的痛点。您需要：

本地开发工具：安装和维护 Xcode (30+ GB) 和 Android Studio 在您的机器上
Mac 硬件: iOS builds 需要一台 Mac，价格可能很高或在 Linux/Windows CI 运行器上是不可能的
CI/CD 配置: 配置复杂的 GitHub 动作或其他 CI/CD 工作流程，包括构建缓存、凭据管理等
依赖管理: 在所有环境中保持最新的构建工具、SDK 和证书

如果您可以跳过所有这些步骤，只需运行一个命令就可以了吗?

Cloud Build 简介

使用 Capgo Cloud Build，您的应用程序可以通过以下方式轻松构建:

# First time: Save your credentials locally
npx @capgo/cli@latest build credentials save --platform ios
npx @capgo/cli@latest build credentials save --platform android

# Then build
npx @capgo/cli@latest build com.example.app

只需这样做。无需 Xcode、无需 Android Studio、无需复杂的 CI/CD 配置。只需一条命令就可以：

将您的项目压缩到本地
将其上传到 Capgo 的云基础设施
使用保存的凭据在专用基础设施上构建您的应用程序
实时将日志流向您的终端
如果配置了，提交到App Store和Play Store

如何工作

我们使用与Expo EAS Build相同的方法构建了Capgo Cloud Build - 专用云基础设施，处理所有复杂性

但以下是我们与其他人不同的关键点： 我们已经在过去的3年中.我们从Capgo开始内部为客户构建原生应用，并且我们已经了解了构建Capacitor应用的确切方法

我们的专长

过去三年中，我们已经

建立了自己的Fastlane系统 - 我们创建了针对Capacitor应用的自定义Fastlane配置，专门优化了
掌握了Capacitor构建 - 我们对构建Capacitor的重要方面有深入的了解，从插件配置到原生依赖
专注于原生-only - 我们只构建原生部分（iOS和Android）。您的JavaScript将保留在您的侧 - 我们永远不会触摸或存储您的webcode
优化了我们的基础设施 - 数千个内部构建帮助我们完善我们的构建系统，之后将其提供给您

这不是一个新的实验。它是经过多年测试的基础设施，我们已经依赖它多年，现在作为一个服务提供给您

为Android

Android构建在安全的Cloudflare沙盒中运行，完成后立即清除。您的应用程序使用Gradle与我们的Capacitor优化的构建脚本编译，签名并准备好提交到Play Store

为iOS

iOS构建在按需分配的Mac机器（Scaleway Mac minis）上运行。我们使用自定义的Fastlane设置 - 经过多年Capacitor构建的精炼 - 构建、签名并提交您的应用程序到TestFlight。每个构建在安全的macOS用户帐户中运行，机器在24小时后自动清除

实时日志

与其他解决方案不同，我们直接将构建日志流式传输到您的终端。您可以观看:

依赖安装
构建编译
Code 签名
应用商店提交
任何错误或警告

重要的是： 我们不存储您的日志. 他们只在您的CLI会话期间可用，确保您的隐私。

凭证工作原理

在您可以构建之前，您需要提供您的签名凭证。Capgo以最大安全性为目标处理此问题。

本地保存凭证

您的凭证在您的机器上以本地方式存储 ~/.capgo/credentials.json:

# For iOS - provide certificates and provisioning profiles
npx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./path/to/cert.p12 \
  --p12-password "your-password" \
  --provisioning-profile ./path/to/profile.mobileprovision

# For Android - provide keystore and passwords
npx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password"

这些凭证将 不会上传到 Capgo 直到您请求构建。它们将安全地保存在您的机器上。

构建过程中的发生

当您运行构建命令时：

本地: CLI 从 ~/.capgo/credentials.json
上传:凭证以安全的 HTTPS 方式发送到 Capgo 的构建服务器以及您的项目
构建:凭证仅在构建过程中使用
清理: Capgo服务器上自动删除凭据，直到构建完成

安全保证

我们关于您的凭据的保证是：

✅ 永不永久存储 - 凭据仅在Capgo服务器上存在于构建期间
✅ 自动删除 - 构建完成后立即删除（即使构建失败，也不超过24小时）
✅ 无日志，无痕迹 - 我们不存储可能包含凭据痕迹的构建日志或IPA/APK文件
✅ 临时环境 - 构建环境在使用后完全销毁
✅ 直接到商店 - 应用直接发布到App Store/Play Store - Capgo永远不会保留它们

管理您的凭据

您完全控制保存的凭据:

# List saved credentials (passwords masked)
npx @capgo/cli@latest build credentials list

# Clear credentials for a specific platform
npx @capgo/cli@latest build credentials clear --platform ios

# Clear all credentials
npx @capgo/cli@latest build credentials clear

什么凭据是必需的?

对于iOS:

构建证书(.p12文件和密码)
分发配置文件(.mobileprovision文件)
可选: App Store Connect API密钥(用于自动提交)

对于Android:

Keystore文件(.jks或.keystore)
Keystore别名
Keystore密钥密码
Keystore存储密码
可选：Google Play服务账户JSON（用于自动提交）

参见我们的凭证文档凭证文档

凭证文档

隐私 & 安全第一

除了凭证之外，我们还设计了整个构建系统，考虑到了隐私和安全：无日志存储
: 构建日志实时流向您的终端通过Server-Sent Events（SSE），但永远不会持久保存到磁盘或数据库: Your built IPA/APK files go directly from our build machines to App Store/Play Store servers - Capgo never stores them
: 构建的IPA/APK文件直接从我们的构建机器传输到App Store/Play Store服务器 - __CAPGO_KEEP_0__永远不会存储它们:
- Android: 构建沙盒在完成后立即被销毁
- iOS: 构建后 Mac 用户账户被清理，机器在 24 小时后被关闭
隔离构建：每个 iOS 构建都在一个完全独立的 macOS 用户账户中运行，拥有自己的密钥链
您的 Code隐私：我们只构建原生部分 -您的 JavaScript/HTML/CSS never touches 我们的服务器
无构建历史：我们不维护您的构建、版本或任何构建元数据的数据库，除了所需的构建活动

随处使用

Cloud Build 可以在任何地方使用 -您的本地机器、GitHub Actions、GitLab CI 或任何 CI/CD 平台。

本地开发

在您的本地机器上，保存凭证一次，随时构建：

# One-time credential setup
npx @capgo/cli@latest build credentials save --platform ios \
  --certificate ./certs/dist.p12 \
  --p12-password "$P12_PASSWORD" \
  --provisioning-profile ./certs/profile.mobileprovision

# Build anytime
npx @capgo/cli@latest build com.example.app --platform ios

CI/CD 集成

在 CI 环境中，您可以选择:

选项 1：在 CI 中保存凭据 (推荐的简便方法)

# GitHub Actions example
- name: Save credentials and build
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
    P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
  run: |
    # Decode base64-encoded credentials from secrets
    echo "${{ secrets.IOS_CERTIFICATE_BASE64 }}" | base64 -d > cert.p12
    echo "${{ secrets.PROVISIONING_PROFILE_BASE64 }}" | base64 -d > profile.mobileprovision

    # Save credentials
    npx @capgo/cli@latest build credentials save --platform ios \
      --certificate ./cert.p12 \
      --p12-password "$P12_PASSWORD" \
      --provisioning-profile ./profile.mobileprovision

    # Build
    npx @capgo/cli@latest build com.example.app --platform ios

选项 2：在命令行中提供凭据 (适用于高级用例)

您还可以通过环境变量直接传递凭据 - 请参阅凭据文档了解详细信息。

无需在 CI 环境中配置 Mac 运行器、管理构建缓存或安装 SDK。Capgo 在云端处理所有这些功能。

简单透明的定价

我们根据实际使用的构建时间收费：

Android构建: 1倍乘数
iOS构建: 2倍乘数（由于专用Mac硬件成本）

没有惊喜费用，沒有最低承诺。您只为使用的内容付费。

您的Code，您的责任

One important principle of Capgo Cloud Build: 我们只编译原生部分.

您的JavaScript、HTML和CSS将保留在您的侧面。我们不会处理、检查或存储您的Webcode。您负责在本地使用 npm run build 或您的首选构建工具）构建Web资产，我们处理原生编译。

这种分离是有意为之：

更好的安全性 - 你的应用逻辑永远不会离开你的控制
更快的构建 - 我们不浪费时间重建你的 web code
明确的责任 - 你控制你的 web 构建过程，我们处理原生复杂性

关于实时更新?

Cloud Build 补充了我们的现有实时更新系统. 这是它们如何一起工作的:

Cloud Build: 对于原生应用程序更改（插件、权限、原生 code）需要 App Store/Play Store 审核
实时更新: For web code changes (HTML, CSS, JavaScript) 可以立即部署无需审查

使用 Cloud Build 时，添加新插件或更改本机配置时使用。对于其他所有内容，使用实时更新。它们共同为您提供了最快的部署工作流程。

当前状态：已完全发布

Cloud Build 已于 2026 年 1 月全面发布并对所有 Capgo 用户开放。我们将继续根据生产反馈改进体验。

需要帮助开始? 加入我们的 Discord 并让我们知道 - 我们很乐意帮助您启动第一个构建。

开始

准备无需麻烦地构建？查看 Cloud Build 文档以了解更多关于：

设置凭证 - iOS certificates 和 Android keystores
开始使用指南 - 在 5 分钟内完成您的第一个构建
iOS 专用设置 - 证书、分发配置文件和 App Store Connect
Android 专用设置 - Keystores 和 Play Store 配置
CI/CD 集成 - 在您的管道中自动构建
故障排除 - 常见问题和解决方案

接下来是什么?

我们正在积极工作于：

加快 iOS 构建: 缓存依赖项以减少构建时间
构建工件存储: 可选下载 IPA/APK 文件用于手动分发
自定义构建脚本: 支持预/后构建钩子和自定义 Fastlane 通道
构建日志历史: 可选日志存储用于调试和审计

我们正在构建 Capgo Cloud Build 以成为构建原生移动应用的最简单、最友好的方式。如果您有反馈或功能请求，我们很乐意在我们的 Discord 社区.

开心构建!

了解更多

Keep going from Introducing Capgo Cloud Build - Build Native Apps Without the Hassle

如果您正在使用 Introducing Capgo Cloud Build - Build Native Apps Without the Hassle 来规划CI/CD自动化,连接它与 Capgo CI/CD 为产品工作流程在Capgo CI/CD中 Capgo 本机构建为产品工作流程在Capgo 本机构建中 Capgo 集成为产品工作流程在Capgo 集成中 CI/CD 集成 CI/CD 集成的实现细节 GitHub 动作集成 for the implementation detail in GitHub Actions Integration.