Deploy a Live Update

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

このガイドでは、次のことを前提としています。 Capgoのクイックスタート を完了し、以下のことを実行済みであることを前提としています。

1. __CAPGO_KEEP_0__を__CAPGO_KEEP_1__アプリにインストール @capgo/capacitor-updater SDK in your Capacitor app

2. __CAPGO_KEEP_1__ 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 アクション

   .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

   このコマンドで指定されたチャンネルに新しいバンドル バージョンをアップロードします。

トラブルシューティング アップロード

アップロードが失敗した場合、確認してください：

• __CAPGO_KEEP_0__ ダッシュボードのアプリ ID が capacitor.config.ts アプリ ID が Capgo ダッシュボードのアプリと一致していることを確認してください
• Capacitor プロジェクトのルートディレクトリからアップロードコマンドを実行していることを確認してください
• ウェブアセットがビルドされ最新版であることを確認してください

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

デバイスにアップデートを受信する

アップロードしたバンドルをテストするには、次の手順に進んでください：

1. デバイスにアプリを同期してください：

   npx cap sync ios

2. 別のターミナルを開いて、次のコマンドを実行してアップデートのステータスを確認してください: __CAPGO_KEEP_0__

   npx @capgo/cli@latest app debug

3. ローカルでアプリを実行してください: __CAPGO_KEEP_0__

   npx cap run ios

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

4. アプリを約30秒間開いて、バックグラウンドでアップデートをダウンロードするのを待ってください。

5. ログは数秒後にアップデートのステータスを表示するまでに時間がかかります。

6. アプリを閉じて再度開いてください。アップデートが適用されていることを確認してください!

再度確認してください Capgoのクイックスタート ライブ更新のテストに関する詳細については、__CAPGO_KEEP_0__のクイックスタートを参照してください。

次のステップ

Capgoで初めてのライブ更新を成功させたことには、🎉

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

• 更新の動作のカスタマイズ
• ライブ更新のロールバック
• __CAPGO_KEEP_0__のライブ更新ドキュメントの残りの部分を確認してください。

ライブアップデートから続けて

「__CAPGO_KEEP_0__ CI/CD」を使用している場合 ライブアップデート CI/CDの自動化を計画する場合、__CAPGO_KEEP_0__ CI/CDと接続する Capgo CI/CDの製品ワークフローにおけるCapgo CI/CDの接続 Capgo Native Buildsの製品ワークフローにおけるCapgo Native Buildsの接続 Capgo Integrationsの製品ワークフローにおけるCapgo Integrationsの接続 for the product workflow in Capgo Native Builds, Capgo CI/CDの製品ワークフローにおけるCapgo CI/CDの接続 Capgo Native Buildsの製品ワークフローにおけるCapgo Native Buildsの接続 __CAPGO_KEEP_0__ Integrationsの製品ワークフローにおける__CAPGO_KEEP_0__ Integrationsの接続 CI/CD統合の実装詳細について GitHub アクション統合 for the implementation detail in GitHub Actions Integration.