开始使用

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

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

您需要什么

开始之前，请确保您有：

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

配置您的签名凭证

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

运行您的第一个构建

您需要使用 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 在专用基础设施上编译和签名原生项目。
日志流式传输 - 通过Server-Sent Events将实时日志流式传输到您的终端。
清理 - 构建环境和临时项目数据在构建后被清理；输出保留依赖于所选的工件和存储交付选项。

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

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

然后调用 Capgo 构建准备好的本机项目。 Capgo 接收准备好的 ios/ 或 android/ project to compile and sign, so it does not need your private Nexus, CocoaPods SSH, or web-build credentials. The compiled web assets are already inside that prepared native project; they are used for the build rather than retained as a source repository.

context

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.

、

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

What Capgo Build Handles

__CAPGO_KEEP_0__ Build处理什么
标题：__CAPGO_KEEP_0__ Build处理什么
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