部署实时更新

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

提示

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

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

1. 在你的 __CAPGO_KEEP_1__ 应用程序中安装了 @capgo/capacitor-updater SDK in your Capacitor app

2. 配置了你的应用 ID 和更新频道在 capacitor.config.ts

3. 添加了在你的 code 中 CapacitorUpdater.notifyAppReady() method

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

添加应用 在您的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

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

上传故障排除

如果上传失败，请检查：

• Your app ID in capacitor.config.ts Capgo 中的您的应用 ID
• 您正在从 Capacitor 项目根目录运行上传命令
• 您的 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_KEEP_0__ 快速入门

下一步

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

要了解更多信息，请查看剩余的 Capgo 实时更新文档。您可以查看以下关键话题：

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

继续部署实时更新

如果您正在使用 实时更新部署 以规划CI/CD自动化为目的，连接它与 Capgo CI/CD 在Capgo CI/CD中，为产品工作流程 Capgo 原生构建 在Capgo 原生构建中，为产品工作流程 Capgo 集成 在Capgo 集成中，为产品工作流程 CI/CD集成 在CI/CD集成中，实现细节 GitHub Actions Integration 用于实现详细信息的GitHub Actions Integration。