部署实时更新

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

提示

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

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

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

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

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

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

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

上传一个包

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

1. 构建您的网页资产：

   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 与 __CAPGO_KEEP_0__ 控制台中的应用 ID 匹配 capacitor.config.ts 您正在从 Capgo 项目根目录运行上传命令
• You’re running the upload command from the root of your Capacitor project
• Troubleshooting Uploads

If you’re still having trouble, go to the 故障排除 故障排除

故障排除

设备接收更新

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 快速入门 有关测试实时更新的更多详细信息，请参阅

下一步

Congrats on deploying your first live update with Capgo! 🎉

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

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

从部署实时更新继续

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