Live Update をデプロイ

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

ヒント

Capgo は生成された Web ビルドフォルダをアップロードします。HTML、CSS、JavaScript、アセット、純粋な JavaScript パッケージの変更は、そこにバンドルされれば OTA 配信できます。以下への変更： capacitor.config.tsネイティブプラグインの設定、ネイティブパッケージ、iOS/Android プロジェクトファイルは、ネイティブアプリのリリースが必要です。

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

1. インストール済み @capgo/capacitor-updater SDK を Capacitor アプリに

2. アプリ ID と更新チャネルを以下に設定しました capacitor.config.ts

3. code に以下を追加しました CapacitorUpdater.notifyAppReady() メソッド

まだこれらの手順を行っていない場合は、まずクイックスタートを完了してください。

アプリの追加 Capgo アカウントにアプリを追加し、アプリにプラグインをインストールします

Bundle のアップロード

Capgo SDK のインストールと設定が完了したので、最初の live update bundle をアップロードする準備が整いました:

1. Webアセットをビルドします:

   npm run build

2. Capgo に bundle をアップロード:

   コンソール

   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

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

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

アップロードに失敗したら、次を再確認してください：

• アプリの App ID が capacitor.config.ts Capgo ダッシュボードのアプリと一致しているか
• Capacitor プロジェクトのルートからアップロードコマンドを実行しているか
• Web アセットがビルド済みで最新か

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

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

bundle のアップロードが完了したら、デバイス上で live update をテストできます：

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. アプリを閉じて再度開いてください。live update が適用されているはずです！

詳細については、 Capgo クイックスタートを完了して、 を参照してください。

次のステップ

Capgo を使用して最初の live update をデプロイしたおめでとうございます！🎉

さらに詳しく知るには、 Capgo Live Updates ドキュメントの残りの部分を確認してください。次にチェックすべき主要トピック：

• チャンネルによるアップデートのターゲット指定
• アップデート動作のカスタマイズ
• Live Update ロールバック

Live Update のデプロイから続行する

使用している場合 Live Update をデプロイ CI/CD自動化を計画するには、次と連携してください Capgo での CI/CD 設定 Capgo CI/CDでのプロダクトワークフローについては、 Capgo Native Build Capgo Native Buildsでのプロダクトワークフローについては、 Capgo インテグレーション Capgo インテグレーションでのプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integrationの実装詳細については、 GitHub Actions 連携 GitHub Actions Integrationの実装詳細については。