开始
复制一个包含安装步骤和本插件的完整 Markdown 指南的配置提示。
使用 Capgo Cloud Build 开始并在几分钟内创建您的第一个 iOS 或 Android 原生构建。
在开始之前，请确保您有:
- 一个 Capacitor 本地构建成功的应用
- 安装了 Node.js 20 或更高版本
- 一个 Capgo 帐户（免费试用即可开始）
- 您的应用已经在 Capgo 中注册（运行
npx @capgo/cli@latest app add如果没有） - （无需提前准备签名凭证 — 我们将在下一步设置它们。）
配置您的签名凭证
Section titled “配置您的签名凭证”Capgo 需要签名凭证才能构建和提交您的应用 — 但您不必手动处理它们。回答几个问题，我们将指向您需要运行的具体命令：
运行您的第一个构建
开始你的第一个构建你需要使用 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 debugCLI 会上传准备好的原生项目，并在你的终端中实时直播构建日志。 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 Build 与 Bitrise 或另一个 CI
标题：使用 Capgo Build 与 Bitrise 或另一个 CICapgo Build 不会替换您的现有 CI。保留需要您的私有访问的步骤：从私有注册表中安装，通过 SSH 解析私有 CocoaPods，运行自定义本机设置，构建 web 层，运行 npx cap sync.
然后调用 Capgo Build 使用准备好的本机项目。 Capgo 接收准备好的 ios/ 或 android/ 在使用 Capgo 的过程中，您可能会遇到一些选择。例如，您可以使用 Appflow、Capawesome 或 Capgo 本身来管理您的项目。每个选项都有其优点和缺点，了解它们的区别非常重要。
然后将 __CAPGO_KEEP_0__ Build 的输出上传到您的 App Store 或 Google Play Store。 __CAPGO_KEEP_1__ 将负责处理上传过程中的所有细节。
什么被构建Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.
__CAPGO_KEEP_0__ Build 接收准备好的本机项目以编译您的应用。您的 web 源 __CAPGO_KEEP_1__、私有依赖安装和 __CAPGO_KEEP_2__ 同步仍然保留在您的 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/ | 构建缓存和IDE设置 |
.gradle/, .idea/, .swiftpm/ | ，密钥 |
.env已同步到本地文件夹中的版本控制历史 | Never uploaded |
您的责任
标题：您的责任在运行之前 npx @capgo/cli@latest build request:
- 在CI中准备 - 在Bitrise或您的现有CI中解决私有包注册表、基于SSH的CocoaPods、设备SDK、扩展和任何自定义本机准备。
- 构建您的Web资产 - 运行
npm run build或使用您的框架的构建命令。 - 同步到原生 - 运行
npx cap sync将编译的 Web 资产复制到准备好的原生项目中。 - 请求原生构建 - 发送准备好的
ios/或android/project to Capgo Build.
将项目设置为 Capgo 构建。
Capgo 构建处理什么- __CAPGO_KEEP_0__ 构建处理什么
- 原生 iOS 编译（Xcode，Fastlane）
- 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 Store 上传，即使保存了 Play 凭据; --output-upload 提供对签名输出的有限期链接。通过您的 MDM 分发该 APK。
下一步
下一步您已经创建了第一个构建:
- 配置 iOS 构建 - 设置证书和配置文件
- 配置 Android 构建 - 设置密钥库和 Google Play 商店
- 故障排除 常见问题和解决方案
- CLI 参考 - 完整命令文档
需要帮助?
需要帮助?- 查看帮助 故障排除指南
- 加入我们的 Discord 社区
- 通过以下电子邮件联系我们的支持团队 support@capgo.app