开始

复制一个包含安装步骤和本插件的完整 Markdown 指南的配置提示。

使用 Capgo Cloud Build 在几分钟内创建您的第一个 iOS 或 Android 原生构建。

您需要的内容

开始之前，请确保您有：

一个 Capacitor 本地构建成功的应用
安装了 Node.js 20 或更高版本
一个 Capgo 帐户（免费试用即可开始）
您的应用程序已经在 Capgo (运行 bunx @capgo/cli@latest app add 如果没有)
(不需要提前准备签名凭证 — 我们将在下一步设置它们。)

配置您的签名凭证

Capgo 需要签名凭证才能构建和提交您的应用程序 — 但您不必手动处理它们。回答几个问题，我们将指向您需要运行的exact命令：

运行您的第一个构建

您需要在 Capgo 上进行身份验证才能构建。如果您尚未：

bunx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

如果您刚刚运行 build init, 您已经准备好 — 在 onboard 过程中，会提供一个开始构建的选项，直到您的第一个构建已经在路上。 🎉

否则，自己启动一个构建 build request — 设置 --platform 到您正在构建的任何一个

bunx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

The CLI 将上传您的项目，实时在您的终端中流式传输构建日志，并 — 一旦您的凭据配置好 — 自动将结果提交到商店。

理解构建过程

当您运行构建命令时，这是发生的事情：

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

本地准备 - 你的项目被压缩（不包括 node_modules 上传
- 压缩包上传到安全的云存储（__CAPGO_KEEP_0__ R2） - The zip is uploaded to secure cloud storage (Cloudflare R2)
- 你的应用在专用基础设施上构建 日志流
- 实时日志流到你的终端通过Server-Sent Events 自动清理
- 构建产物被删除（Android：即刻，iOS：24小时） What Gets Built

What Gets Built

Capgo 只上传编译本地应用所需的 最小文件 to compile your native app. Your full source code never leaves your machine.

什么会被上传

包含	描述
`ios/` 或 `android/`	本地平台文件夹
`package.json`, `package-lock.json`	依赖清单
`capacitor.config.*`	Capacitor 配置
`resources/`	应用图标、启动屏幕
原生插件 code	仅有 `ios/` 或 `android/` 每个 Capacitor 插件的子文件夹

什么没有上传

排除	为什么
`node_modules/` (大部分)	仅有原生插件 code 被包含，JS依赖不被包含
`src/`	您的 web 源 code 仍然在本地
`dist/`, `www/`, `build/` (根级)	已经同步到本地文件夹中 `cap sync`
`.git/`	版本控制历史
`.gradle/`, `.idea/`, `.swiftpm/`	构建缓存和IDE设置
`.env`, 秘密	从未上传

您的责任

在运行之前 bunx @capgo/cli@latest build:

构建您的 Web 资产 - 运行 bun run build (或您的框架的构建命令)
- 运行 将 Web 资产复制到本机项目 bunx cap sync - 运行
提交依赖项 - 确保所有本机插件都在 package.json

什么 Capgo 构建处理

本机 iOS 编译 (Xcode, Fastlane)
本机 Android 编译 (Gradle)
Code 使用您的凭据进行签名
应用商店提交 (如果配置)

下一步

现在您已经创建了第一个构建：

配置 iOS 构建 - 设置证书和配置文件
配置 Android 构建 - 配置.keystore 和 Google Play 商店
故障排除 - 常见问题和解决方案
CLI 参考 - 完整命令文档

需要帮助?

检查故障排除指南
加入我们的 Discord 社区
在 capgo@.app