Introducing Capgo Cloud Build - Build Native Apps Without the Hassle

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

我们解决的问题

构建本机移动应用程序一直是 web 开发人员的痛点。您需要：

• 本地开发工具: 在您的机器上安装和维护 Xcode (30+ GB) 和 Android Studio
• Mac 硬件: iOS 构建需要 Mac，这可能很昂贵或在 Linux/Windows CI 运行器上是不可能的
• CI/CD 配置: 设置复杂的 GitHub Actions 或其他 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 配置。只需一条命令，它将:

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

如何工作

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

但以下是我们与众不同的原因： 我们已经在做这件事三年了. 我们从Capgo开始就一直在内部为客户构建原生应用，并且我们已经了解了构建可靠的Capacitor应用所需的所有内容。

我们的专长

在过去的三年里，我们已经：

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

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

For Android

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

For iOS

iOS构建在 Scaleway Mac minis 上的预先配置的 Mac 机器上运行。我们使用自定义的 Fastlane 配置 - 经过多年Capacitor构建的精炼 - 来编译、签名和提交您的应用到 TestFlight。每个构建在 macOS 用户帐户中运行以实现安全性，机器在 24 小时后自动清除

Real-Time Logs

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

• 依赖项安装
• 构建编译
• 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 直到您要求构建。它们将安全地保存在您的机器上。

构建期间发生的事情

当您运行一个构建命令时：

1. 本地: CLI 从中读取凭据 ~/.capgo/credentials.json
2. 上传: 凭据以安全的 HTTPS 方式发送到 Capgo 的构建服务器中，伴随着您的项目
3. 构建: 凭据仅在构建过程中使用
4. 清理: 构建完成后，凭据自动从 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

什么凭据是必需的？

For iOS:

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

For Android:

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

查看我们的 凭证文档 查看详细的设置指南。

隐私和安全优先

除了凭证之外，我们还将整个构建系统设计为以隐私和安全为首：

• 无日志存储: 构建日志实时通过服务器发送事件 (SSE) 流向您的终端，但永远不会持久保存到磁盘或数据库中
• 无工件存储: 构建的 IPA/APK 文件直接从我们的构建机器传输到 App Store/Play Store 服务器 - Capgo 从未存储它们
• 自动清理:
  • Android：构建沙盒在完成后立即销毁
  • iOS：Mac 用户帐户在构建后清理，机器在 24 小时后注销
• 隔离构建: 每个 iOS 构建在一个完全独立的 macOS 用户帐户中运行，具有自己的密钥链
• Your Code 隐私: 我们只构建原生部分 - 你的 JavaScript/HTML/CSS 从未接触我们的服务器
• 无构建历史: 我们不维护你的构建、版本或任何构建元数据的数据库，除了所需的构建

随处使用

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 将留在您的控制下。我们永远不会处理、检查或存储您的 web code。您负责在本地使用 npm run build 或您的偏好构建工具）构建您的 web 资产，我们处理原生编译。

这种分离是有意的：

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

关于实时更新?

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

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

使用 Cloud Build 时添加新插件或更改原生配置。对于其他情况，请使用实时更新。它们共同提供了最快的部署工作流程。

当前状态：已完全发布

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

需要帮助开始? 加入我们的Discord 并告诉我们 - 我们很乐意帮助您在5分钟内完成第一个构建。

开始

准备在不麻烦的情况下构建吗？检查 Cloud Build 文档 了解更多关于：

• 设置凭据 - iOS证书和Android密钥库
• 入门指南 - 在5分钟内完成您的第一个构建
• iOS特定设置 - 证书、配置文件和 App Store Connect
• - Android 专用设置 - Keystores 和 Play Store 配置
• CI/CD 集成 - 在管道中自动化构建
• 故障排除 - 常见问题和解决方案

接下来是什么?

我们正在积极工作于:

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

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

开心构建!

了解更多

• Cloud Build概览
• 凭证设置指南
• Cloud Build入门
• iOS 构建配置
• Android 构建配置
• 加入我们的 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 for the product workflow in Capgo CI/CD, Capgo Native Builds for the product workflow in Capgo Native Builds, Capgo Integrations 为产品工作流程在Capgo Integrations中 CI/CD集成 为CI/CD集成的实施细节 GitHub Actions集成 为GitHub Actions集成的实施细节