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

We’re excited to announce Capgo Cloud Build - 一种新方法来在云端直接为 iOS 和 Android 构建您的 Capacitor 应用程序，无需本地开发环境或 CI/CD 基础设施。

The Problem We’re Solving

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

• Local Development Tools: 安装和维护 Xcode（30+ GB）和 Android Studio
• Mac 硬件: iOS 构建需要 Mac，这可能会很昂贵或在 Linux/Windows CI 运行器上不可用
• CI/CD 配置: 设置复杂的 GitHub Actions 或其他 CI/CD 工作流程，包括构建缓存、凭据管理等
• Dependency Management简化您的构建流程

如果您可以跳过所有这些步骤并只运行一个命令呢?

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（如果配置）

如何工作

We built Capgo Cloud Build using the same approach as Expo EAS Build - dedicated cloud infrastructure that handles all the complexity for you.

但这里是我们与众不同的原因： 我们已经在做这件事三年了. 我们自从Capgo的开始就一直在为客户内部构建原生应用，并且我们已经了解了构建Capacitor应用的确切方法。

我们的专长

过去三年，我们已经：

• 页面/区域：Capgo Builder / 原生云构建产品页面。角色：短的UI标签或导航项。消息键`native_build_builder_credit_over` (原生构建构建者信用过) - We’ve created custom Fastlane configurations specifically optimized for Capacitor apps
• - 我们创建了专门针对Capacitor应用的定制Fastlane配置 掌握了Capacitor构建
• - 我们对构建__CAPGO_KEEP_0__应用的重要知识有深入的了解，从插件配置到原生依赖项 - We build only the native parts (iOS and Android). Your JavaScript stays on your side - we never touch or store your web code
• - 我们只构建原生部分（iOS和Android）。您的JavaScript将留在您的侧面 - 我们永远不会触摸或存储您的web__CAPGO_KEEP_0__ - 数千个内部构建帮助我们完善我们的构建系统，直到它可供您使用

This isn’t a new experiment. It’s battle-tested infrastructure we’ve relied on for years, now available as a service.

For Android

Android builds run in secure Cloudflare sandboxes with instant cleanup after completion. Your app is compiled using Gradle with our Capacitor-optimized build scripts, signed, and ready to submit to the Play Store.

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

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.

在 iOS 上

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

• 实时日志
• 与其他解决方案不同，我们将构建日志直接流式传输到您的终端，实时观看:
• Code signing
• 构建编译过程中：__CAPGO_KEEP_0__ 签名
• 任何错误或警告

而这里的重要部分是： 我们不会存储您的日志.它们仅在您的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 直到您要求构建。它们将安全地保存在您的机器上。

在构建期间发生什么

When you run a build command:

1. 本地: CLI 从读取凭证 ~/.capgo/credentials.json
2. 上传: 凭证安全地通过 HTTPS 发送到 Capgo 的构建服务器中，带上您的项目
3. 构建context: 首页产品特性区域。角色：短 UI 标签或导航项。见于：组件首页/AutomationFeatures.astro。消息键 `landing_automation_build` (Landing Automation Build)。
4. : 凭证仅在构建过程中使用: Credentials are automatically deleted from Capgo servers after the build completes

: 凭证在构建完成后自动从 __CAPGO_KEEP_0__ 服务器中删除

安全保证

• ✅ : 我们保证关于您的凭证的以下内容： - 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：

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

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

隐私 & 安全优先

除了凭据之外，我们还将整个构建系统设计为隐私和安全的考虑:

• 无日志存储区域: Capgo Builder / 本地云构建产品页面。角色: 部分或页面标题。消息键 `native_build_security_feature4_title` (Native Build Security Feature4 Title)。
• ：构建日志实时通过 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 小时后销毁隔离构建
• Your Code Privacy: 我们只构建原生部分 - 你的 JavaScript/HTML/CSS 从未接触我们的服务器
• No Build History: 我们不维护你的构建、版本或任何构建元数据的数据库，除了所需的构建

Use It Anywhere

: 云构建在任何地方都有效 - 你的本地机器、GitHub Actions、GitLab CI 或任何 CI/CD 平台

Local Development

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

# 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 Integration

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

Option 1: Save credentials in 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 会在云端处理所有这些。

简洁透明的定价

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

• 安卓构建1倍乘数
• iOS 云构建: 2倍乘数（因為專用 Mac 硬體成本）

No surprise fees, no minimum commitments. You only pay for what you use.

Your Code, Your Responsibility

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

Your JavaScript, HTML, and CSS stay on your side. We never process, inspect, or store your web code. You’re responsible for building your web assets locally (using npm run build 或您喜爱的构建工具)，我们处理原生编译。

This separation is intentional:

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

关于实时更新

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

• Cloud Build: 对于需要 App Store/Play Store 审核的本机应用程序更改（插件、权限、本机 code）
• 实时更新: For web code changes (HTML, CSS, JavaScript) that can be deployed instantly without review

: 对于可以立即部署而无需审核的 Web __CAPGO_KEEP_0__ 更改（HTML、CSS、JavaScript）

使用 Cloud Build 时添加新插件或更改本机配置。使用实时更新进行其他操作。它们共同提供最快的部署工作流程。

Cloud Build has been fully released since January 2026 and is available to all Capgo users. We’re continuing to improve the experience based on production feedback.

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

开始

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

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

- 下一步

- 我们正在积极工作:

• - 更快的 iOS 构建- 缓存依赖项以减少构建时间
• - 构建产物存储: __CAPGO_KEEP_0__ 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

在Capgo中迁移Capawesome： Introducing Capgo Cloud Build - Build Native Apps Without the Hassle 如果您正在使用 Capgo CI/CD for the product workflow in Capgo CI/CD, Capgo CI/CD Capgo CI/CD Capgo 原生构建 为Capgo集成流程 CI/CD集成 CI/CD集成的实现细节 GitHub动作集成 GitHub动作集成的实现细节