Capgo 云构建 帮助 Capacitor 团队在不拥有 Mac 设备的情况下构建和签署 iOS 和 Android 应用。保留您的 web 构建、测试和 npx cap sync 在您的现有管道中，随后调用 Capgo 构建 在一个 CLI 步骤中为已签名的二进制文件和可选的商店提交。有关产品概述和定价，请参见 Capgo 本地构建. 任务级别的答案存放在 Capacitor iOS 无需 Mac FAQ.
我们解决的问题
构建本机移动应用程序一直是网页开发者的痛点。您需要:
- 本地开发工具: 安装和维护 Xcode (30+ GB) 和 Android Studio 在您的机器上
- Mac 访问:传统上，传输 iOS 构建需要在每台开发机器和发布路径上访问 Mac
- 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 - 专用云基础设施，处理所有复杂性以便您使用。
但这里是我们与众不同的原因： 我们已经在做这件事3年了。我们自Capgo开始就一直在内部为客户构建原生应用，并且我们已经了解了构建Capacitor应用所需的所有内容。
我们的专长
在过去的三年里，我们已经：
- 构建了自己的Fastlane系统 - 我们创建了专门针对Capacitor应用的定制Fastlane配置
- 掌握了Capacitor构建 - 我们对构建Capacitor应用的重要性有深入的了解，从插件配置到原生依赖项
- 专注于原生 - 我们只构建原生部分（iOS和Android）。您的JavaScript将留在您的侧面 - 我们永远不会触摸或存储您的webcode
- 优化了我们的基础设施 - 数千个内部构建帮助我们完善我们的构建系统，直到它可供您使用
这是我们多年来依赖的稳定基础设施，现已开放为服务。
For Android
Android构建在安全的Cloudflare沙盒中运行，完成后立即清理。您的应用程序使用Gradle编译，使用我们的Capacitor优化的构建脚本签名，准备好提交到Play Store。
For iOS
iOS构建在 Scaleway Mac minis 上运行的专用 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 直到您请求构建。它们将安全地保存在您的机器上。
在构建期间发生什么
当您运行构建命令时：
- 本地: CLI 从读取凭据
~/.capgo/credentials.json - 上传: 凭据以安全的 HTTPS 方式发送到 Capgo 的构建服务器，伴随您的项目
- 构建安全保证
- 我们关于您的凭据的保证如下：: 在建置完成后，Capgo 服务器会自动删除凭证
Credentials are sent securely over HTTPS to __CAPGO_KEEP_0__’s build servers along with your project
Credentials are used ONLY during the active build process
- ✅ Credentials are automatically deleted from __CAPGO_KEEP_0__ servers after the build completes - 只在活动构建期间在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（用于自动提交）
查看我们的 凭证文档 详细的设置指南。
隐私 & 安全第一
我们不仅仅关注凭证安全，整个构建系统也以隐私和安全为设计原则:
- 无日志存储context: Capgo Builder / native cloud build product page. Role: Section or page heading. Message key `native_build_security_feature4_title` (Native Build Security Feature4 Title).
- : 构建日志实时流向您的终端，通过 Server-Sent Events (SSE)，但不会被持久存储到磁盘或数据库：您的构建的IPA/APK文件直接从我们的构建机器传输到App Store/Play Store服务器 - Capgo永不存储它们
- : 构建的 IPA/APK 文件直接从我们的构建机器传输到 App Store/Play Store 服务器，__CAPGO_KEEP_0__ 不会存储它们:
- 自动清理
- Android: 构建沙盒在完成后立即销毁
- iOS: 构建后清除 Mac 用户账户，24 小时后销毁机器隔离构建
- Your Code隐私保护: 我们只构建原生部分 - 你的JavaScript/HTML/CSS永远不会触及我们的服务器
- 无构建历史: 我们不维护你的构建、版本或任何构建元数据的数据库，除了所需的构建
在任何地方使用
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 iosCI/CD集成
在CI环境中，您可以选择：
在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 环境中配置 Mac 运行器、管理构建缓存或安装 SDK。Capgo 将在云端处理所有这些。
无需配置 Mac 运行器、管理构建缓存或在 CI 环境中安装 SDK。__CAPGO_KEEP_0__ 在云端处理所有这些。
简单透明的定价
- 我们根据实际使用的构建时间收费：安卓构建
- iOS 云构建: 1 倍乘数
无任何惊喜费用，无任何最低承诺。您只为使用的内容付费。
Your Code, Your Responsibility
Capgo 云构建的一个重要原则是 我们只编译原生部分.
Your web source code and dependency installation stay with you. After cap sync,编译好的 JavaScript、HTML 和 CSS 在原生项目中上传并使用，临时项目数据清理。您需要在本地构建您的网页资产（使用 npm run build 或您的首选构建工具），我们负责原生编译。
这种分离是有意为之:
- 更好的安全性 - 您的应用逻辑永远不会离开您的控制
- 更快的构建 - 我们不浪费时间重建您的 web code
- 简化责任 - 您控制您的 Web 构建过程，我们处理本机复杂性
关于实时更新
Cloud Build 补充我们的现有 live update 系统. 这是它们如何协同工作的示例:
- Cloud Build: 对于本机应用程序更改（插件、权限、本机 code）需要 App Store/Play Store 审核
- 实时更新: 为即刻部署的网页code变更（HTML、CSS、JavaScript）
: 对于 Web __CAPGO_KEEP_0__ 更改（HTML、CSS、JavaScript）可以立即部署而无需审核
使用 Cloud Build 时添加新插件或更改本机配置时使用 Cloud Build。对于其他内容使用实时更新。它们一起为您提供最快的部署工作流程。
自 2026 年 1 月起，Cloud Build 已全面发布，所有 Capgo 用户均可使用。我们将继续根据生产反馈改进体验。
需要帮助开始使用? 加入我们的Discord 让我们知道 - 我们很乐意帮助您启动第一个构建。
开始使用
准备在不麻烦的情况下构建？请查看 Cloud Build 文档 了解更多关于：
- 设置凭证 - iOS 证书和 Android 密钥库
- 快速入门指南 - 在 5 分钟内完成第一个构建
- iOS专用设置 iOS专用设置
- - 证书、分发配置文件和App Store Connect Android专用设置
- Android专用设置 - 密钥库和Play Store配置
- CI/CD集成 CI/CD集成
- 在管道中自动构建
故障排除
- 故障排除- 常见问题和解决方案
- 构建产物存储: 可选下载IPA/APK文件用于手动分发
- 自定义构建脚本: 支持预/后构建钩子和自定义Fastlane车道
- 构建日志历史: 可选日志存储用于调试和审计
我们正在构建Capgo Cloud Build以成为构建原生移动应用的最简单、最友好的方式。如果您有反馈或功能请求，我们很乐意在我们的 Discord社区.
开心构建!
常见问题
How does Capgo Build help Capacitor teams?
Capgo Build如何帮助CLI团队？
什么是 Capgo?
Capgo 是一个 Capacitor 应用的发布平台。Capgo Build 处理签名的本机二进制文件和存储提交。Capgo Live Updates 发送 JavaScript 和资产变化之间的本机发布。
了解更多
继续使用云 iOS 构建无需 Mac 的 Capacitor 和 CI
如果您正在使用 云 iOS 构建无需 Mac 的 Capacitor 和 CI 为 CI/CD 自动化规划,连接它 Capgo 构建/持续集成 为产品工作流程在 Capgo CI/CD 中 Capgo 原生构建 为产品工作流程在 Capgo 原生构建 中 Capgo 集成 为产品工作流程在 Capgo 集成 中 集成 为 CI/CD 集成的实现细节,并 GitHub 动作集成 为 CI/CD 集成的实现细节在 GitHub 动作集成 中
