部署 Live Update

使用 Capgo 的 Live Updates 功能，实时远程更新应用的 UI 和业务逻辑。无需经过应用商店，即可直接向用户推送 JS bundle 更新，即时修复 bug 并发布新功能。

提示

Capgo 会上传生成的 web build 文件夹。一旦打包进去，HTML、CSS、JavaScript、assets 以及纯 JavaScript 包的变更都可以通过 OTA 更新。而针对 capacitor.config.ts原生插件配置、原生包或 iOS/Android 项目文件的变更，则需要发布原生应用版本。

本指南假设你已完成 Capgo 快速入门 并已完成以下操作：

1. 已安装 @capgo/capacitor-updater 在您的 Capacitor 应用中使用 SDK

2. 已在以下内容中配置您的 App ID 和更新通道： capacitor.config.ts

3. 已在您的 code 中添加 CapacitorUpdater.notifyAppReady() 方法

如果您尚未完成这些步骤，请返回并先完成快速入门指南。

添加应用 在您的 Capgo 账户中添加应用，并在应用中安装插件

上传 Bundle

安装并配置好 Capgo SDK 后，您就可以上传第一个 live update bundle 了：

1. 构建 Web 资源：

   npm run build

2. 将 bundle 上传至 Capgo：

   控制台

   npx @capgo/cli@latest bundle upload --channel=production

   Github 操作

   .github/workflows/build_and_deploy.yml

   name: Build source code and send to Capgo
   
   concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
   
   on:
   push:
     branches:
       - main
   
   jobs:
   deploy_to_capgo:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
       - uses: actions/setup-node@v6
         with:
           node-version: '24'
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} --channel ${{ env.CHANNEL }}
         env:
           CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

   Gitlab

   .gitlab-ci.yml

   stages:
     - build
   
   build:
     stage: build
     image: node:18
     cache:
       - key:
           files:
             - package-lock.json
         paths:
           - .node_modules/
     script:
       - npm install
       - npm run build
       - npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN --channel $CAPGO_CHANNEL
     artifacts:
       paths:
         - node_modules/
         - dist/
     only:
       - master

   这将把新的 bundle 版本上传到命令中指定的 channel。

上传故障排查

如果上传失败，请检查：

• 您的 app ID 为 capacitor.config.ts App ID 是否与 Capgo dashboard 中的应用一致
• 你是否在 Capacitor 项目的根目录下运行上传命令
• 你的 Web 资源已构建且为最新版本

如果问题仍然存在，请前往 故障排除 章节。

在设备上接收更新

bundle 上传完成后，你可以在设备上测试 live update：

1. 将你的 App 同步到设备：

   npx cap sync ios

2. 打开另一个终端，运行以下命令检查更新状态：

   npx @capgo/cli@latest app debug

3. 在本地运行你的 App：

   npx cap run ios

   或者在 Xcode/Android Studio 中打开 iOS/Android 项目，以原生方式运行。

4. 让 App 保持打开约 30 秒，以便更新在后台下载。

5. 日志需要几秒钟才能更新并显示更新状态。

6. 关闭并重新打开 App。你应该能看到 live update 已生效！

请参阅 Capgo 快速入门 以了解更多关于测试 Live Updates 的详情。

下一步

恭喜你使用 Capgo 完成了首次 live update 部署！ 🎉

欲了解更多信息，请阅读其余的 Capgo Live Updates 文档。接下来可以关注以下核心主题：

• 通过 Channels 定向更新
• 自定义更新行为
• Live Update 回滚

继续阅读：部署 Live Update

如果你正在使用 部署 Live Update 规划 CI/CD 自动化，并将其与 Capgo CI/CD 用于 Capgo CI/CD 中的产品工作流， Capgo Native Build 用于 Capgo Native Builds 中的产品工作流， Capgo 集成 用于 Capgo 集成中的产品工作流， CI/CD 集成 了解 CI/CD 集成的实现细节，以及 GitHub Actions 集成 有关 GitHub Actions 集成的实现细节。