部署一个实时更新

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

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

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

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 Actions

   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 控制台中匹配您的应用
• You’re running the upload command from the root of your Capacitor project
• 您的 Web 资产已构建并且最新

如果您仍然遇到问题，请前往 故障排除 部分。

在设备上接收更新

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

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 实时更新文档。一些关键话题供您检查：

• 通过频道更新
• 自定义更新行为
• 实时更新回滚