跳转至正文
B

通过 Capgo 使用 Bolt 发布你的移动应用

Bolt 负责构建、发布并为你的 Capacitor 应用提供 Live Update：无需 Mac 即可构建 iOS 和 Android 版本，分钟级 OTA 修复，支持一键回滚。

  • 应用构建器
  • 导出至 Capacitor
  • 托管 MCP
  • CLI

在 Bolt 中设置 Capgo

最多三步。按原样复制每个代码块即可。

  1. 步骤 1

    导出你的 Bolt 应用

    在 Bolt 中连接 GitHub 仓库（或下载项目），然后在本地电脑上进行 clone。

    终端
    $ git clone https://github.com/you/your-bolt-app.git $ cd your-bolt-app $ npm install $ npm run build

  2. 步骤 2

    使用 Capacitor 和 Capgo 进行封装

    为 iOS 和 Android 添加 Capacitor，然后通过 Capgo CLI 配置 Live Update。将 Bolt 应用的 build 文件夹作为 webDir（Vite 项目使用 dist）。

    终端
    $ npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android $ npx cap init "Your App" com.company.app --web-dir dist $ npx cap add ios && npx cap add android $ npx @capgo/cli@latest init

  3. 步骤 3

    云端构建并发布更新

    Capgo 负责签名并构建 iOS 和 Android 应用，无需 Mac。之后，所有的 Web 端更改都会作为 live update 发布。

    终端
    $ npx @capgo/cli@latest build init $ npx @capgo/cli@latest build request --platform ios $ npx @capgo/cli@latest bundle upload --channel production

你可以向 Bolt 提问什么

复制提示词并粘贴到 Bolt 中。将 App ID 和版本号替换为你自己的即可。

  • 构建

    “让这个应用适配 Capacitor: 保持客户端路由，并将静态文件构建到 dist 目录。”

  • 构建

    “安装 @capgo/capacitor-updater，并在应用启动时调用 notifyAppReady。”

  • 更新

    “添加一个 GitHub Actions 工作流，在每次 push 到 main 分支时，将 Capgo bundle 上传到 production channel。”

  • 构建

    “我在 Capgo 上最近一次 iOS build 的状态是什么？”

  • 回滚

    “将 production channel 回滚到上一个 bundle。”

  • Observe

    “显示 v2.3.0 在过去 7 天内的更新统计数据。”

  • 更新

    “暂停 production channel 上的 rollout。”

完整的发布闭环

从首次构建到下一次线上修复，一个账号覆盖所有环节。

  1. 1

    构建

    在云端完成 iOS 和 Android 的签名构建。无需 Mac，也无需 Xcode。

    Capgo 构建原生应用
  2. 2

    发布

    将构建版本发送至 TestFlight 和 Google Play，或提交应用商店审核。

    无需 Mac 即可构建并发布 iOS 应用
  3. 3

    更新

    几分钟内即可将 JavaScript、HTML 和 CSS 修复推送到 channel，一步即可回滚。

    Capgo 实时更新
  4. 4

    Observe

    查看哪些用户收到了更新、哪里失败，以及每个版本的表现。

    使用 Capgo Observe

Bolt 说明与限制

  • Bolt 支持自定义 MCP servers。在聊天框中打开 Connectors，添加 https://api.capgo.app/mcp（使用 HTTP transport 和 MCP OAuth），然后为该项目开启即可。
  • Bolt 无法代你运行 Capgo CLI。请在本地计算机或通过 GitHub Actions 进行 build 和 upload。
  • Bolt 项目通常是 Vite 应用，因此使用 dist 作为 webDir 是正确的。

常见问题

Capgo 与 Bolt：常见问题

Bolt 能在没有 Mac 的情况下构建我的 iOS App 吗？

可以，先导出 code。用 Capacitor 把 Web App 包一层，然后运行 npx @capgo/cli@latest build request。Capgo 会在云端签名并构建 iOS 和 Android App。

Native Build 文档

使用 Bolt 需要 Capgo API 密钥吗？

托管版 MCP 不需要 API 密钥：它通过 OAuth 登录。本地 CLI MCP 和 CLI 使用 API 密钥，你只需用 npx @capgo/cli@latest login 保存一次。请在 Capgo 控制台的 Settings > Organization > API keys 下创建该密钥。

创建 Capgo API 密钥

Bolt 可以回滚错误的更新吗？

可以。只需让 Bolt 将 channel 指向之前的 bundle 即可。设备会在下次检查更新时自动切换。此外，当新 bundle 启动失败时，Capgo updater 也会自动执行回滚。

Live update 文档

App Store 和 Google Play 允许使用 Live Updates 吗？

可以，但仅限 Web 层：JavaScript、HTML、CSS 和静态资源。Native code、新权限和新插件仍需通过应用商店发布，这一步可以交给 Capgo Build 完成。

通过 Bolt 使用 Capgo 的费用是多少？

MCP servers、skills 和 CLI 均可免费使用。你需要 Capgo 方案，所有方案都提供 14 天免费试用，无需信用卡。Builds、Live Updates 和 Observe 都包含在每个方案中。

定价

通过 Bolt 发布您的下一个版本

立即创建 Capgo 账号，连接 Bolt，并推送您的首次 build 或 live update。

文档

相关页面