部署实时更新

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

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

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

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

3. 在代码中添加 CapacitorUpdater.notifyAppReady() 方法

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

添加应用程序 Add an app to your Capgo account, and install the plugin in your app

上传包

安装并配置 Capgo SDK 后，您就可以上传第一个实时更新包了：

1. 构建您的网络资产：

   npm run build

2. 将捆绑包上传到 Capgo：

   Console

   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

   这会将新的捆绑包版本上传到命令中指定的通道。

上传疑难解答

如果您的上传失败，请仔细检查：

• capacitor.config.ts 中的应用 ID 与 Capgo 仪表板中的应用匹配
• 您正在从 Capacitor 项目的根目录运行上传命令
• 您的网络资产已构建并且是最新的

如果您仍然遇到问题，请转到疑难解答 部分。

在设备上接收更新

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

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 实时更新文档 的其余部分。接下来要检查的一些关键主题：

• 通过渠道进行定向更新
• 自定义更新行为
• 实时更新回滚