跳过主要内容
产品

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

在云端为iOS和Android构建Capacitor应用,类似于Expo。无需在本地使用Xcode或Android Studio - 直接从CLI提交到应用商店。

文章来源

马丁·多纳迪厄

作者

瓦莱里亚

审稿人

乔丹

编辑器

介绍 Capgo 云构建 - 无需烦恼地构建本机应用

我们很高兴地宣布 Capgo 云构建 - 一种新方法来构建您的 Capacitor 应用程序直接在云中,

而无需在本地开发环境或 CI/CD 基础设施中进行本地开发。

我们解决的问题

  • 构建本机移动应用程序一直是 web 开发人员的痛点。您需要:本地开发工具
  • : 安装和维护 Xcode (30+ GB) 和 Android StudioMac 硬件
  • : iOS 构建需要 Mac,可能会很贵或在 Linux/Windows CI 运行器上无法实现。: 在 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(如果配置)

How It Works

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

但这里是我们与众不同的地方: 我们已经做了三年。我们自Capgo开始就为客户内部构建原生应用,并且我们已经了解了构建Capacitor应用的可靠性所需的所有内容

我们的专长

过去三年,我们已经:

  • Page/area: Capgo Builder / native cloud build product page. Role: Short UI label or navigation item. Message key `native_build_builder_credit_over` (Native Build Builder Credit Over). - We’ve created custom Fastlane configurations specifically optimized for Capacitor apps
  • - 我们创建了专门针对Capacitor应用的自定义Fastlane配置 掌握了Capacitor构建
  • - 我们对构建__CAPGO_KEEP_0__应用的重要性有深入的了解,从插件配置到原生依赖项 - 我们只构建原生部分(iOS 和 Android)。您的 JavaScript 将保留在您的侧 - 我们永远不会触摸或存储您的 web code
  • 优化了我们的基础设施 - 数千个内部构建帮助我们完善我们的构建系统,之后才将其提供给您

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

对于 Android

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

对于 iOS

iOS 构建在 Scaleway Mac mini 上运行(预先配置的 Mac 机器),按需分配。我们使用我们的自定义 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 直到您请求一个构建。它们安全地保存在您的机器上。

What Happens During a Build

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

  1. Local: CLI 从中读取凭证 ~/.capgo/credentials.json
  2. Upload: 凭证安全地通过 HTTPS 发送到 Capgo 的构建服务器中,伴随着您的项目
  3. Build: 凭证仅在构建过程中使用
  4. Cleanup: 构建完成后,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 密钥(用于自动提交)

对于 Android:

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

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

隐私 & 安全优先

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

  • 无日志存储上下文:Capgo Builder / 原生云构建产品页面。角色:部分或页面标题。消息键 `native_build_security_feature4_title` (原生构建安全功能4标题)。
  • :构建日志实时流向您的终端通过服务器发送事件(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构建在一个完全独立的macOS用户帐户中运行,拥有自己的密钥链
  • 您的Code隐私: 我们只构建原生部分 -您的JavaScript/HTML/CSS永远不会触及我们的服务器
  • 无构建历史: 我们不维护您的构建、版本或任何构建元数据的数据库,除了所需的构建

随处使用

: 云构建在任何地方都有效 -您的本地机器、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集成

上下文: Capgo Builder / 原生云构建产品页面。角色: 短UI标签或导航项。消息键`native_build_feature_ci_cd` (Native Build Feature Ci Cd)。

选项 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:在行内提供凭据 (适用于高级用例)

您还可以在环境变量中直接传递凭据 - 请参阅 凭据文档 凭据文档

No need to configure Mac runners, manage build caches, or install SDKs in your CI environment. Capgo handles all of that in the cloud.

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

简单透明的定价

  • 我们根据实际使用的构建时间收费:安卓构建
  • iOS 构建: 2 倍乘数(由于专用 Mac 硬件成本)

无惊喜费用,无最低承诺。您只为使用的内容付费。

您的 Code,您的责任

Capgo 云构建的一个重要原则是: 我们只构建原生部分.

您的 JavaScript、HTML 和 CSS 将留在您的侧面。我们永远不会处理、检查或存储您的 Web code。您负责在本地构建您的 Web 资产(使用 npm run build 或您的偏好构建工具),我们处理原生编译。

这种分离是有意的:

  • 更好的安全性 - 您的应用逻辑永远不会离开您的控制
  • 更快的构建 - 我们不浪费时间重建您的 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 并让我们知道 - 我们很乐意帮助您启动第一个构建。

开始

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

- 下一步是什么?

- 我们正在积极工作:

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

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

开心构建!


了解更多

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

继续阅读Introducing Capgo Cloud Build - 无需烦恼即可构建原生应用 Introducing Capgo Cloud Build - Build Native Apps Without the Hassle 继续阅读Introducing Capgo Cloud Build - 无需烦恼即可构建原生应用 Capgo CI/CD Capgo CI/CD 在Capgo CI/CD中为产品工作流程使用Capgo Native Builds 为Capgo原生构建的产品工作流程 Capgo集成 为Capgo集成的产品工作流程 CI/CD集成 为CI/CD集成的实现细节 GitHub动作集成 为GitHub动作集成的实现细节

实时更新Capacitor应用

当 Web 层 bug 活跃时,通过 Capgo 直接将修复推送给用户,而不是等待几天的应用商店审批。用户在后台接收更新,而原生代码仍然遵循正常的审查流程。

人工支持来自Martin

立即开始

最新博客

Capgo 为您提供了创建真正专业的移动应用所需的最佳见解。