ライブアップデートの配布

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

このガイドは、Capgoクイックスタートを完了し、以下の作業が済んでいることを前提としています：

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

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

3. コードにCapacitorUpdater.notifyAppReady()メソッドを追加

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

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

バンドルのアップロード

Capgo SDKのインストールと設定が完了したら、最初のライブアップデートバンドルをアップロードする準備が整いました：

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

   npm run build

2. バンドルをCapgoにアップロードします：

   Console

   npx @capgo/cli@latest upload --channel=Production

   Github Actions

   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@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 18
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Deploy to Capgo
         run: bunx @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

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

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

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

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

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

デバイスでのアップデートの受信

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

1. アプリをデバイスに同期します：

   npx cap sync ios

2. 別のターミナルで以下のコマンドを実行してアップデートの状態を確認します：

   npx @capgo/cli@latest app debug

3. アプリをローカルで実行します：

   npx cap run ios

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

4. バックグラウンドでアップデートがダウンロードされるように、アプリを約30秒間開いたままにします

5. ログが更新されるまで数秒かかり、アップデートの状態が表示されます

6. アプリを閉じて再度開きます。ライブアップデートが適用されているはずです！

ライブアップデートのテストについての詳細は、Capgoクイックスタートを参照してください

次のステップ

Capgoで最初のライブアップデートのデプロイに成功しましたね！🎉

詳細を学ぶには、Capgoライブアップデートのドキュメントの残りを確認してください。次に確認すべき重要なトピック：

• チャンネルを使用したアップデートのターゲティング
• アップデート動作のカスタマイズ
• ライブアップデートのロールバック