开始使用

复制安装步骤和完整的 Markdown 指南。

开始使用 Capgo Cloud Build，仅需几分钟即可创建您的第一个 iOS 或 Android 原生构建。

您需要的内容

在开始之前，请确保您有：

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

标题：配置您的签名凭证

Capgo needs signing credentials to build and submit your app — but you don’t have to wrangle them by hand. Answer a couple of questions and we’ll point you to the exact command to run:

标题：运行您的第一个构建

Capgo

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

如果您刚刚运行 build init您已经准备好了 — 在导航过程中，导航将为您提供开始构建的选项，因此您的第一个构建可能已经在路上了。 🎉

否则，请自行启动构建 build request — 设置 --platform 到您正在构建的

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

The CLI 将准备好的本机项目上传并在终端中实时流式传输构建日志。 Capgo 构建可以返回签名的 artifact 或将其提交到 App Store Connect 或 Google Play 当您配置适当的发布流程时。

了解构建过程

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

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

在您的CI中准备 - 构建Web层，解决私有依赖项，并将完成的资产同步到本机项目中。
上传 - 准备的本机项目上传到安全云存储中进行构建。
构建执行 - Capgo 在专用基础设施上编译和签署本机项目。
日志流式传输 - 实时日志通过Server-Sent Events流式传输到您的终端。
清理 - 构建环境和临时项目数据在构建后清理；输出保留依赖于所选的工件和存储交付选项。

使用 Capgo 与 Bitrise 或另一个 CI 构建

Capgo 构建不会替换您的现有 CI。保留需要您的私有访问的步骤：在 Bitrise 或另一个 CI 系统中安装私有注册表、通过 SSH 解析私有 CocoaPods、运行自定义本机设置、构建 web 层和运行 npx cap sync.

然后用准备好的本机项目调用 Capgo 构建。Capgo 接收到已准备好的 ios/ 或 android/ 项目以编译和签名。因此，它不需要您的私有 Nexus、CocoaPods SSH 或 web-build 凭据。已编译的 web 资产已经包含在该准备好的本机项目中；它们用于构建而不是保留为源代码仓库。

构建什么

Capgo 构建接收到编译您的应用所需的准备好的本机项目。您的 web 源 code、私有依赖安装和 Capacitor 同步仍然保留在您的 CI 中。

上传什么

包含	描述
`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`, 秘密	从未上传

您的责任

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

在您的 CI 中准备 - 在 Bitrise 或您的现有 CI 中解决私有包注册表、基于 SSH 的 CocoaPods、设备 SDK、扩展和任何自定义本机准备。
构建您的 Web 资产 - 运行 npm run build (或您的框架的构建命令)。
同步到本机 - 运行 npx cap sync to copy the compiled web assets into the prepared native project.
请求原生构建 - 发送准备好的 ios/ 或 android/ 项目到 Capgo Build。

Capgo Build 处理的内容

原生 iOS 编译 (Xcode, Fastlane)
原生 Android 编译 (Gradle)
Code 使用您的凭据进行签名
Optional App Store Connect 或 Google Play 提交
支持本机构建配置和凭据值通过环境变量传递

Capgo 构建不需要访问您的私有Nexus注册表或SSH凭据，一旦CI准备好了本机项目。请参阅构建配置支持的环境变量和存储选项。

如果要通过MDM分发的kiosk风格，请配置Android项目/构建以生成APK。请求构建时，使用两个标志跳过Google Play并检索签名输出：

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload 即使保存了Play凭据，仍然会阻止Play Store上传； --output-upload 提供对签名输出的有限期链接。通过您的MDM分发该APK。

下一步

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

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

需要帮助？

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