部署一个Live Update

使用Capgo的实时更新功能来远程更新您的应用程序的UI和业务逻辑。直接将JS包更新推送给您的用户，无需通过应用商店即可立即修复bug并发布新功能。

提示

Capgo上传生成的Web构建文件夹。HTML、CSS、JavaScript、资产和纯JavaScript包的更改可以通过OTA进行一次性更改。更改 capacitor.config.ts原生插件配置、原生包或iOS/Android项目文件需要发布原生应用程序。

本指南假设您已完成 Capgo 快速入门 并且已经:

1. 安装了 @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_1__ 应用程序 capacitor.config.ts

3. 在您的code中添加 CapacitorUpdater.notifyAppReady() 添加到您的

__CAPGO_KEEP_0__ 中的

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

添加一个应用程序到您的__CAPGO_KEEP_0__账户，并在您的应用程序中安装插件

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

1. 构建您的 Web 资产：

   npm run build

2. 将包上传到 Capgo：

   控制台

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

   Github 操作

   github 动作项

   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

   这将上传一个新的包版本到命令中指定的频道。

上传故障排除

如果您的上传失败，请检查以下内容：

• 您的应用 ID 与 __CAPGO_KEEP_0__ 控制台中的应用 ID 匹配 capacitor.config.ts 匹配您的应用程序在Capgo控制台
• 您正在从您的Capacitor项目根目录运行上传命令
• 如果您仍然遇到问题，请前往

Troubleshooting Uploads Troubleshooting 故障排除

设备接收更新

在您的包裹上传后，您可以在设备上测试live update。

1. 设备接收更新

   npx cap sync ios

2. Sync your app to the device:

   npx @capgo/cli@latest app debug

3. 同步应用到设备上：

   npx cap run ios

   或在 Xcode/Android Studio 中打开 iOS/Android 项目并进行原生运行。

4. 保持应用程序打开约 30 秒，以便在后台下载更新。

5. 日志将在几秒钟内更新并显示更新状态。

6. 关闭并重新打开应用程序。您应该看到您的 live update 应用程序已应用!

请参阅 Capgo 快速入门 有关测试实时更新的更多详细信息。

下一步

恭喜您已成功部署第一个 live update 应用程序！ Capgo

为了了解更多信息，请查看剩余的 Capgo Live Updates 文档. 以下是您需要检查的关键话题:

• 使用频道来目标更新
• 自定义更新行为
• Live Update 回滚

继续部署Live Update

如果您正在使用 部署Live Update 来规划CI/CD自动化，连接它与 Capgo CI/CD 为产品工作流程在 Capgo CI/CD 中 Capgo 原生构建 为产品工作流程在 Capgo 原生构建中 Capgo 集成 为产品工作流程中的Capgo集成 为产品工作流程在 __CAPGO_KEEP_0__ 集成中 CI/CD 集成 GitHub Capgo 行动集成 为GitHub Actions 集成的实现细节。