介绍 Capgo 云构建 - 无需烦恼地构建原生应用

我们很高兴宣布 Capgo Cloud Build - 云端构建您的Capacitor应用的新方式，直接在云端构建iOS和Android应用，无需本地开发环境或CI/CD基础设施

我们解决的问题

Building native mobile apps has always been a pain point for web developers. You need:

本地开发工具: 安装和维护 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

That’s it. No Xcode, no Android Studio, no complex CI/CD setup. Just one command that:

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

如何工作

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

但以下是我们与Expo EAS Build有所不同的方面 我们已经在__CAPGO_KEEP_0__开始以来为客户内部构建了3年. We’ve been building native apps for our clients internally since the beginning of Capgo, and we’ve learned exactly what it takes to build Capacitor apps reliably.

我们的专长

过去三年，我们已经:

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

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

适用于Android

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

For iOS

iOS builds run on dedicated Mac machines (Scaleway Mac minis) provisioned on-demand. We use our custom Fastlane setup - refined over years of Capacitor builds - to build, sign, and submit your app to TestFlight. Each build runs in an isolated macOS user account for security, and machines are automatically cleaned up after 24 hours.

Real-Time Logs

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

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

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

How Credentials Work

在开始构建之前，您需要提供您的签名凭证。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
上传: Capgo通过HTTPS安全地将凭据发送到Capgo的构建服务器中，伴随着您的项目
Build: 凭据仅在构建过程中使用
Cleanup: 构建完成后，Capgo自动从Capgo服务器中删除凭据

Security Guarantees

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

✅ 永不永久存储 - 凭据仅在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密钥（用于自动提交）

For Android:

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

参见我们的凭证文档了解详细设置指南。

隐私 & 安全第一

除了凭证之外，我们还设计了整个构建系统，考虑到了隐私和安全：

无日志存储: Build logs实时流向您的终端，通过Server-Sent Events（SSE）进行，但永远不会持久保存到磁盘或数据库中
No Artifact Storage: 构建的IPA/APK文件直接从我们的构建机器传输到App Store/Play Store服务器 - Capgo 不会存储它们
Automatic Cleanup:
- Android: 构建沙盒在完成后立即销毁
- iOS: Mac用户帐户在构建后清洁，机器在24小时后注销
Isolated Builds: 每个iOS构建在一个完全独立的macOS用户帐户中运行，拥有自己的密钥链
Your Code Privacy: 我们只构建原生部分 -您的JavaScript/HTML/CSS永远不会触及我们的服务器
No Build History: 我们不维护您的构建、版本或任何构建元数据的数据库，除了所需的构建活动之外

无论何时何地使用它

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：提供凭据 (适用于复杂场景)

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

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

简单透明的定价

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

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

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

您的Code，您的责任

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

Your JavaScript, HTML, and CSS stay on your side. 我们永远不会处理、检查或存储您的 web code。您负责在本地（使用 npm run build 或您的偏好构建工具）构建您的 web 资产，我们处理原生编译。

This separation is intentional:

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

关于实时更新?

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

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

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

当前状态：已完全发布

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

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

开始

准备好无忧地构建吗？查看 Cloud Build 文档

了解更多关于：设置凭据
- iOS 证书和 Android 密钥库入门指南
- 在 5 分钟内完成您的第一个构建 iOS 专用设置
- 证书、分发配置文件和 App Store Connect Android 专用设置
- 密钥库和 Play Store 配置 - 在您的管道中自动化构建
故障排除 - 常见问题和解决方案

接下来是什么?

我们正在积极工作于:

更快的 iOS 构建: 缓存依赖项以减少构建时间
构建工件存储: 可选下载 IPA/APK 文件用于手动分发
自定义构建脚本: 支持预/后构建钩子和自定义 Fastlane 通道
构建日志历史: Optional log storage for debugging and audit trails

我们正在打造 Capgo Cloud Build，成为构建原生移动应用的最简单、最友好的方式。如果您有任何反馈或功能建议，我们非常欢迎您在我们的加入我们的.

快乐编码!

了解更多

继续阅读：介绍 Capgo Cloud Build - 无需烦恼地构建原生应用

If you are using 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 for the product workflow in Capgo Integrations, CI/CD 集成为 CI/CD 集成的实现细节 GitHub Actions Integration 为 GitHub Actions Integration 的实现细节。

云端构建Capgo - 无需烦恼的原生应用构建