我们很高兴宣布 Capgo Cloud Build - 在云端直接构建您的 Capacitor 应用程序的 iOS 和 Android 版本,无需本地开发环境或 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 工作流程,包括构建缓存、凭证管理等
- 依赖管理: 在不同环境中保持最新的构建工具、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将保留在您的侧面 - 我们永远不会触摸或存储您的 code
- 优化了我们的基础设施 - 数千个内部构建帮助我们完善了我们的构建系统,然后将其提供给您
这不是一个新实验。这是经过多年测试的基础设施,现在作为服务提供给您
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.
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 签名
- App store submission
- 任何错误或警告
And here’s the important part: 我们不会存储您的日志. 他们仅在您的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 直到您请求构建。它们将安全地保存在您的机器上。
在构建期间发生什么
当您运行构建命令:
- 本地: CLI 从读取凭证
~/.capgo/credentials.json - 上传: 凭证通过 HTTPS 安全地发送到 Capgo 的构建服务器中,伴随着您的项目
- 构建: 凭证仅在构建过程中使用
- 清理: 构建完成后,凭证将自动从 Capgo 服务器中删除
安全保证
我们关于您的凭证的保证如下:
- ✅ 永不永久存储 - 凭证仅在构建过程中存在于 Capgo 服务器上
- ✅ 自动删除 - 在构建完成后立即删除(即使构建失败,也不超过24小时)
- ✅ No logs, no artifacts - 我们不存储可能包含凭据踪迹的构建日志或IPA/APK文件
- ✅ Ephemeral environments - 使用后,构建环境将被完全销毁
- ✅ 直接上架 - 应用程序直接上架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 (用于自动提交)
参见我们的 凭证文档 获取详细设置指南。
隐私 & 安全第一
除了凭证之外,我们还专门设计了整个构建系统,考虑到了隐私和安全性:
- 无日志存储: 构建日志通过服务器发送事件(SSE)实时流向您的终端,但永远不会持久保存到磁盘或数据库中
- 无工件存储: 构建的IPA/APK文件直接从我们的构建机器传输到App Store/Play Store服务器 - Capgo永远不会存储它们
- 自动清理:
- 安卓:构建沙盒在完成后立即销毁
- iOS:Mac用户帐户在构建后清理,机器在24小时后销毁
- 隔离构建: 每个iOS构建在一个完全独立的macOS用户帐户中运行,拥有自己的密钥链
- 您的Code隐私: 我们只构建原生部分 -您的JavaScript/HTML/CSS永远不会触及我们的服务器
- No Build History: 不会维护您的构建、版本或任何构建元数据的数据库,除了所需的构建活动
Use It Anywhere
Cloud Build 可以在任何地方使用 - 本地机器、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: 在 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
Option 2: inline 提供凭据 (适用于高级用例)
您也可以直接在环境变量中传递凭据 - 请参阅 凭据文档 了解详细信息。
无需配置Mac运行器、管理构建缓存或在CI环境中安装SDK。Capgo在云端处理所有这些。
简单透明的定价
我们基于实际使用的构建时间收费:
- Android构建: 1倍乘数
- iOS构建: 2倍乘数(由于专用Mac硬件成本)
没有惊喜费用,没有最低承诺。您只为使用的内容付费。
您的Code,您的责任
One important principle of Capgo Cloud Build: 我们只构建原生部分.
您的 JavaScript、HTML 和 CSS 将留在您的侧面。我们永远不会处理、检查或存储您的 Web code。您负责在本地构建您的 Web 资产(使用 npm run build 或您的偏好构建工具),我们处理原生编译。
这种分离是有意的:
- 更好的安全性 - 您的应用逻辑永远不会离开您的控制
- 更快的构建 - 我们不会浪费时间重建您的 Web code
- 明确的责任 - 您控制您的 Web 构建过程,我们处理原生复杂性
关于实时更新?
Cloud Build 与我们的现有 实时更新系统一起工作:
- Cloud Build: For native app changes (plugins, permissions, native code) that require App Store/Play Store review
- __CAPGO_KEEP_0__)需要App Store/Play Store审查: For web code changes (HTML, CSS, JavaScript) that can be deployed instantly without review
: 网页
__CAPGO_KEEP_0__)更改可以立即部署而无需审查
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.
当前状态:已完全发布 Cloud Build 已于 2026 年 1 月全面发布并可供所有用户使用。我们将根据生产反馈继续改进体验。 让我们知道 - 我们很乐意帮助您启动第一个构建。
开始
准备在不麻烦的情况下构建吗?检查一下 Cloud Build 文档 了解更多关于:
- 设置凭证 - iOS 证书和 Android 密钥库
- 入门指南 - 在 5 分钟内启动您的第一个构建
- iOS 专用设置 - 证书、分发配置文件和 App Store Connect
- Android 专用设置 - 证书存储和Play Store配置
- CI/CD集成 - 在管道中自动构建
- 故障排除 - 常见问题和解决方案
接下来是什么?
我们正在积极工作于:
- 更快的iOS构建: 缓存依赖项以减少构建时间
- 构建工件存储: 可选下载IPA/APK文件用于手动分发
- 自定义构建脚本: 支持预/后构建钩子和自定义Fastlane通道
- 构建日志历史: 可选日志存储用于调试和审计
我们正在构建 Capgo Cloud Build 以成为构建原生移动应用的最简单、最友好的方式。如果您有反馈或功能请求,我们很乐意在我们的 Discord社区.
开心构建!
了解更多
Capgo 云构建 - 无需烦恼地构建原生应用
如果您正在使用 Capgo 云构建 - 无需烦恼地构建原生应用 来规划CI/CD自动化,连接它与 Capgo CI/CD 在Capgo CI/CD中, Capgo 原生构建 在Capgo 原生构建中, Capgo 集成 在Capgo 集成中, CI/CD集成 CI/CD 集成的实现细节, GitHub Actions 集成 CI/CD 集成的实现细节在 GitHub Actions 集成中