开始使用

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

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

您需要什么

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

一个 Capacitor 本地构建成功的应用
安装了 Node.js 20 或更高版本
一个 Capgo 帐户（免费试用即可开始）
您的应用已经在 Capgo 中注册（运行 npx @capgo/cli@latest app add if not)
（无需提前准备签名凭证 — 我们将在下一步中设置它们。）

配置您的签名凭证

Capgo 需要签名凭证才能构建和提交您的应用 — 但您不必手动处理它们。回答几个问题，我们将指向您需要运行的exact命令：

运行您的第一个构建

你需要使用 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

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 在专用基础设施上编译和签署原生项目。
日志流式传输 - 实时日志通过服务器发送事件流式传输到您的终端。
清理 - 构建环境和临时项目数据在构建后被清理;输出保留取决于所选的工件和存储交付选项。

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

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

然后使用准备好的本机项目调用 Capgo 构建。Capgo 接收准备好的 ios/ 或 android/ __CAPGO_KEEP_0__ 构建不需要您的私有 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/`	您的网页源code仍然是本地的
`dist/`, `www/`, `build/` (根级别)	已经同步到本机文件夹中的 `cap sync`
`.git/`	版本控制历史
`.gradle/`, `.idea/`, `.swiftpm/`	构建缓存和IDE设置
`.env`，密钥	Never uploaded

您的责任

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

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

将项目复制到Capgo Build中。

标题：__CAPGO_KEEP_0__ Build处理的内容
原生 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构建 - 设置keystore和Google Play商店
故障排除上下文:支持/高级支持页面或底部支持部分。角色:部分或页面标题。见于:页面support-policy.astro。消息键`support_policy_troubleshooting_title` (支持政策故障排除标题).
CLI Reference __CAPGO_KEEP_0__参考

- 完整命令文档

查看帮助故障排除指南
加入我们的 Discord 社区
通过以下电子邮件联系我们的支持团队 support@capgo.app