Live Update をデプロイ

CapgoのLive Updates機能を使えば、アプリのUIやビジネスロジックをリアルタイムでリモート更新できます。App Storeを経由せずにJS bundleをユーザーへ直接配信できるため、バグ修正や新機能のリリースを即座に行えます。

ヒント

Capgoは生成されたweb buildフォルダをアップロードします。HTML、CSS、JavaScript、アセット、および純粋なJavaScriptパッケージの変更は、bundle化されていればOTAで配信可能です。ただし、 capacitor.config.tsネイティブプラグインの設定、ネイティブパッケージ、またはiOS/Androidのプロジェクトファイルへの変更には、Native Buildによるアプリのリリースが必要です。

このガイドでは、以下の手順が完了していることを前提としています。 Capgo クイックスタートを完了して、 および、既に以下が完了しているものとします：

1. のインストール済み @capgo/capacitor-updater Capacitor アプリでの SDK の設定

2. アプリIDとアップデートチャネルの設定 capacitor.config.ts

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

まだこれらのステップを完了していない場合は、まずクイックスタートに戻って完了させてください。

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

Bundle のアップロード

Capgo の SDK のインストールと設定が完了しました。準備ができたら、最初の live update bundle をアップロードしましょう：

1. Webアセットのビルド：

   npm run build

2. Capgo に bundle を upload します:

   コンソール

   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

   これにより、コマンドで指定した channel に新しい bundle バージョンが upload されます。

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

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

• アプリの 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 クイックスタートを完了して、 の Live Updates テストに関する項目を参照してください。

次のステップ

Capgo を使って、最初の live update のデプロイ完了、おめでとうございます！ 🎉

さらに詳しく知るには、以下の Capgo Live Updates ドキュメントの続きを確認してください。次にチェックすべき主なトピックは以下の通りです：

• Channel を使用したアップデートのターゲット指定
• アップデート動作のカスタマイズ
• 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の実装詳細については。