部署实时更新

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

本指南假设您已经完成了 Capgo 快速入门 已经有了：

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

2. 配置您的应用程序 ID 和更新频道 capacitor.config.ts

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

如果您尚未完成这些步骤，请先完成快速入门。

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

上传一个捆绑包

使用Capgo和SDK安装并配置后，您可以上传第一个实时更新捆绑包：

1. 构建您的Web资产：

   npm run build

2. 将捆绑包上传到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

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

上传故障排除

如果上传失败，请检查：

• 您的应用 ID capacitor.config.ts 在Capgo控制台中查看您的应用
• 您正在从Capacitor项目根目录运行上传命令
• 您的Web资产已构建并最新

如果您仍然遇到问题，请参阅 故障排除 section.

接收设备上的更新

上传包后，您可以在设备上测试实时更新：

1. 同步应用到设备：

   npx cap sync ios

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

   npx @capgo/cli@latest app debug

3. 在本地运行您的应用：

   npx cap run ios

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

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

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

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

请参见 Capgo 快速入门 了解更多关于实时更新测试的详细信息。

下一步

恭喜您成功部署了第一个实时更新！Capgo

要了解更多信息，请查看剩余的 Capgo 实时更新文档您应该检查的关键话题：

• 使用通道更新目标
• 自定义更新行为
• 实时更新回滚