开始使用

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

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

您需要的内容

开始之前，请确保您有：

一个 Capacitor 本地构建成功的应用
安装了 Node.js 20 或更高版本
A 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，您已经准备好了 —— 安装过程会在结束时为您启动一个构建，因此您的第一个构建可能已经在路上了。 🎉

否则，自己启动一个构建使用 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 和隐藏文件）
上传 - 压缩包上传到安全的云存储（Cloudflare R2）
构建执行 - 你的应用在专用基础设施上构建
日志流 - 实时日志通过服务器发送事件流式传输到你的终端
自动清理 - 构建产物被删除（Android：即刻，iOS：24小时）

构建什么

Capgo Build only uploads the 仅上传编译本机原生应用所需的 to compile your native app. Your full source code never leaves your machine.

文件

Section titled “什么被上传”	包含
`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/` (root level)	已同步到本机文件夹中 `cap sync`
`.git/`	版本控制历史
`.gradle/`, `.idea/`, `.swiftpm/`	构建缓存和IDE设置
`.env`, 秘密	从未上传

您的责任

在 bunx @capgo/cli@latest build:

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

什么Capgo构建处理

原生iOS编译（Xcode，Fastlane）
原生Android编译（Gradle）
Code使用您的凭据进行签名
应用商店提交（如果配置）

下一步

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

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

需要帮助？

检查故障排除指南
加入我们的 Discord社区
在__CAPGO_KEEP_0__.app中发送电子邮件支持邮箱：support@capgo.app