复制页面选项

Get started with Capgo Cloud Build and create your first iOS or Android native build in minutes.

包含安装、同步和源Markdown指南。

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

• 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您已经准备好了 — 在 onboard 过程中，会提供开始构建的选项，因此您的第一个构建可能已经在路上了。 🎉

否则，请自行启动构建 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]

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

使用 Capgo 与 Bitrise 或其他 CI

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

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

什么被构建

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

什么被上传

包含	简介
ios/ 或 android/	您正在构建的原生平台文件夹
package.json, package-lock.json	依赖清单
capacitor.config.*	Capacitor 配置
resources/	应用图标、启动屏幕
原生插件 code	仅有 ios/ 或 android/ 每个 Capacitor 插件的子文件夹

未上传的内容

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

注意

您的构建的Web资产（JS、CSS和HTML）仅因为 npx cap sync 已将它们复制到本机项目中。Web源和依赖项安装步骤仍然在您的CI中；准备好的本机项目用于构建二进制文件，然后清理。

您的责任

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

1. 在您的CI中准备 - 解决私有包注册表、基于SSH的CocoaPods、设备SDK、扩展和任何Bitrise或您的现有CI中的自定义本机准备。
2. 构建您的Web资产 - 运行 npm run build - (或您的框架的构建命令)。
3. 同步到本机 - 运行 npx cap sync 将编译的 Web 资产复制到准备好的原生项目中。
4. 请求原生构建 - 发送准备好的 ios/ 或 android/ 项目到 Capgo 构建。

什么 Capgo 构建处理

• 原生 Android 编译 (Gradle)
• __CAPGO_KEEP_0__ 使用您的凭据签名
• 使用您的凭据进行Code签名
• 原生 iOS 编译 (Xcode, Fastlane)
• 支持本机构建配置和凭证值作为环境变量传递

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 Store 上传，即使保存了 Play 凭据; --output-upload 提供一个有限期的链接到已签名输出。通过您的 MDM 分发该 APK。

下一步

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

• 配置 iOS 构建 配置 iOS 构建
• - 设置证书和配置文件 配置 Android 构建
• Troubleshooting 故障排除
• CLI 参考文档 - 常见问题和解决方案

需要帮助？

• 需要帮助? 查看故障排除指南
• 加入我们的 加入我们的Discord社区
• 通过电子邮件向我们发送支持请求 支持@capgo.app