ライブアップデートを展開

Capgoのライブアップデート機能を使用して、リアルタイムでアプリのUIとビジネスロジックをリモートで更新できます。アプリストアを経由せずに、直接ユーザーにJSバンドルアップデートをプッシュして、バグを即座に修正し、新機能を配信できます。

このガイドでは、次のことを前提としています。 Capgoのクイックスタートを完了し、以下のことを既に実行していることを想定しています。 __CAPGO_KEEP_0__を__CAPGO_KEEP_1__アプリにインストール

1. __CAPGO_KEEP_0__のアプリIDとアップデートチャネルを__に設定 @capgo/capacitor-updater SDK in your Capacitor app

2. まだこれらのステップを実行していない場合は、まずクイックスタートを完了してください。 capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() Includes install, sync, and the source markdown guide.

Use __CAPGO_KEEP_0__’s Live Updates feature to update the UI and business logic of your app remotely, in real-time. Push JS bundle updates directly to your users without going through the app store to instantly fix bugs and ship new features.

アプリを追加する アプリをあなたの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 capacitor.config.ts matches your app in the Capgo dashboard
• You’re running the upload command from the root of your Capacitor project
• __CAPGO_KEEP_0__プロジェクトのウェブアセットはビルドされ、最新の状態です

問題が解決しない場合は、 トラブルシューティング セクションをご覧ください。

デバイスでライブアップデートを受信する

バンドルがアップロードされたら、デバイスでライブアップデートをテストできます。

1. アプリをデバイスに同步する:

   npx cap sync ios

2. 別のターミナルを開いて、更新状況を確認するコマンドを実行してください:

   npx @capgo/cli@latest app debug

3. ローカルでアプリを実行する:

   npx cap run ios

   または、iOS/Android プロジェクトを開いてXcode/Android Studioでネイティブ実行してください。

4. __CAPGO_KEEP_0__ 秒ほど待ってください。

5. ログは数秒後に更新され、更新状況が表示されます。

6. アプリを閉じて再度開きます。ライブ更新が適用されていることを確認してください。

__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__

次のステップ

Capgo で初めてのライブアップデートを成功的にデプロイしたことをお祝いします！ 🎉

__CAPGO_KEEP_0__ ライブアップデートドキュメントの残りの部分を確認してください。 Capgo Live Updates documentationチャンネルを使用したアップデートのターゲット設定

• アップデートの動作のカスタマイズ
• ライブアップデートのロールバック
• 編集ページ