ライブアップデートのデプロイ

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

ヒント

Capgoは生成されたウェブビルドフォルダをアップロードします。HTML、CSS、JavaScript、アセット、純粋なJavaScriptパッケージの変更は、そこにバンドルされたら、OTAで変更できます。 capacitor.config.ts, native plugin configuration, native packages, or iOS/Android project files require a native app release.

このガイドでは、 Capgo Quickstart Quickstart

1. Capgo @capgo/capacitor-updater SDK in your Capacitor app

2. Capgo capacitor.config.ts

3. Added in your code the CapacitorUpdater.notifyAppReady() Capgo

Capgo

Capgo Add an app to your Capgo account, and install the plugin in your app

アップロードするバンドル

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

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

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

アップロードが失敗した場合、次の点を確認してください。

• アプリ ID capacitor.config.ts matches your app in the Capgo dashboard
• You’re running the upload command from the root of your Capacitor project
• 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_KEEP_0__のクイックスタート Capgo Quickstart 次のステップ

次のステップ

初めてのライブアップデートを成功させたことには、Capgo!

詳しく知りたい場合は、以下の Capgo ライブアップデートのドキュメントを確認してください。 ここでは、次の重要なトピックについて説明します。

• アップデートのターゲット設定
• アップデートのカスタマイズ
• ライブアップデートのロールバック

Deploy a Live Update

Deploy a Live Update を使用している場合、CI/CDの自動化を計画するには、 Deploy a Live Update Capgo CI/CD Capgoの製品ワークフロー向け Capgo Native Builds Capgoの製品ワークフロー向け Capgo Integrations Capgoの製品ワークフロー向け CI/CD Integration CI/CD統合 GitHub Actions Integration GitHubアクション統合