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

我们很高兴地宣布 Capgo 云构建 - 一种新方法，直接在云端为 iOS 和 Android 构建您的 Capacitor 应用，无需本地开发环境或 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

那就好了。没有 Xcode，没有 Android Studio，没有复杂的 CI/CD 配置。只需一个命令：

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

如何工作

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

但是以下是我们与 Expo EAS Build 的不同之处： 我们已经在做这件事三年了我们从 Capgo 开始就一直在为客户内部构建原生应用，我们已经了解了构建 Capacitor 应用所需的所有内容

我们的专长

过去三年，我们已经:

建立了我们自己的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

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

Dependency installation
Build compilation
Code signing
App store submission
任何错误或警告

而这里的重要之处是: 我们不存储您的日志.它们只在您的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服务器上的凭据将自动删除

Security Guarantees

我们保证您的凭据的安全性如下

✅ Never stored permanently - 凭据仅在构建过程中存在于Capgo服务器上
✅ Automatic deletion - 构建完成后立即删除（即使构建失败，也不会超过24小时）
✅ No logs, no artifacts - 我们不存储可能包含凭据痕迹的构建日志或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（用于自动提交）

查看我们的凭证文档获取详细的设置说明。

隐私 & 安全优先

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

无日志存储: Build logs stream to your terminal in real-time via Server-Sent Events (SSE) but are never persisted to disk or databases
无 Artifact 存储: Your built IPA/APK files go directly from our build machines to App Store/Play Store servers - Capgo never stores them
自动清理:
- Android: Build sandbox destroyed instantly after completion
- iOS: Mac user account cleaned after build, machine dismissed after 24 hours
隔离构建: Each iOS build runs in a completely separate macOS user account with its own keychain
您的 Code隐私: We only build native parts - your JavaScript/HTML/CSS never touches our servers
无构建历史: We don’t maintain a database of your builds, versions, or any build metadata beyond what’s needed for active builds

无论何时何地使用

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/CD 集成了解更多详细信息。

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

简单透明的定价

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

安卓构建上下文：Capgo Builder / 原生云构建产品页面。角色：短 UI 标签或导航项。见于：页面 native-build.astro。消息键 `native_build_v2_calc_android` (原生构建 V2 计算安卓)。
: 1 倍乘数iOS 构建

上下文：Capgo Builder / 原生云构建产品页面。角色：短 UI 标签或导航项。见于：页面 native-build.astro。消息键 `native_build_v2_calc_ios` (原生构建 V2 计算 iOS)。

Your Code, Your Responsibility

One important principle of Capgo Cloud Build: 您的__CAPGO_KEEP_0__，您的责任。.

您的 JavaScript、HTML 和 CSS 都在您的身边。我们不会处理、检查或存储您的 web code。您负责在本地使用 (或您的喜爱的构建工具) 构建您的 web 资产，我们处理原生编译。 npm run build 或您的喜爱的构建工具)，我们处理原生编译。

这是一种故意的分离:

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

关于实时更新?

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

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

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

当前状态：已完全发布

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

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

开始

准备好无忧地构建吗？查看 Cloud Build 文档了解更多关于：

设置凭证 - iOS 证书和 Android 密钥库
快速入门 - 在 5 分钟内完成您的第一个构建
iOS 专用设置 - 证书、分发配置文件和 App Store Connect
Android 专用设置 - 密钥库和 Play Store 配置
CI/CD 集成 - pipeline 自动化
故障排除 context":"Page/area: Support / premium support page or footer support section. Role: Section or page heading. Seen in: page support-policy.astro. Message key `support_policy_troubleshooting_title` (Support Policy Troubleshooting Title)."

- 常见问题和解决方案

接下来是什么?

我们正在积极工作:更快的 iOS 构建
: 缓存依赖项以减少构建时间构建工件存储
: 可选下载 IPA/APK 文件进行手动分发自定义构建脚本
: 支持预/后构建钩子和自定义 Fastlane 通道: Optional log storage for debugging and audit trails

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

开心编码！

了解更多

我们正在构建Capgo Cloud Build，使其成为构建原生移动应用的最简单、最友好的方式。如果您有任何反馈或功能建议，我们很乐意在我们的Discord社区中与您交流。我们致力于为开发者提供最好的体验。

If you are using 介绍 Capgo 云构建 - 无需烦恼地构建原生应用 为了计划 CI/CD 自动化,连接它与 Capgo CI/CD 为 Capgo CI/CD 中的产品工作流程 Capgo 原生构建为 Capgo 原生构建中的产品工作流程 Capgo 集成为 Capgo 集成中的产品工作流程 CI/CD 集成为 CI/CD 集成中的实现细节 GitHub 动作集成为 GitHub Actions Integration 的实现细节。