开始使用

复制一个包含安装步骤和本插件的完整 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, 您已经准备好 — 安装过程会在结束时为您启动一个构建，因此您的第一个构建可能已经在路上了。 🎉

否则，自己启动一个构建 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 只编译上传所需的 最少的文件 以编译您的本机应用。您的完整源代码 code 从未离开您的机器。

上传的内容

包含	描述
`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 (或您的框架的构建命令)
同步到原生 - 运行 bunx cap sync 将 Web 资产复制到原生项目
提交依赖项 - 确保所有本机插件都在 package.json

什么 Capgo 构建处理

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

下一步

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

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

需要帮助?

查看故障排除指南
加入我们的 Discord 社区
在 capgo