Deploy a Live Update

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

ヒント

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

このガイドでは、 Capgoのクイックスタートを完了していることを前提としています。 とすでに:

1. 「__CAPGO_KEEP_0__」をあなたの「__CAPGO_KEEP_1__」アプリにインストールしました @capgo/capacitor-updater 「SDK」のアプリIDとアップデートチャンネルを「Capacitor」に設定しました

2. 「__CAPGO_KEEP_0__」に「__CAPGO_KEEP_0__」を追加しました capacitor.config.ts

3. 「code」のメソッド CapacitorUpdater.notifyAppReady() まだそれらのステップを実行していない場合は、まずクイックスタートを完了してください。

あなたの「__CAPGO_KEEP_0__」アカウントにアプリを追加し、アプリにプラグインをインストールしてください。

バンドルアップロード Add an app to your Capgo account, and install the plugin in your app

「__CAPGO_KEEP_0__」「__CAPGO_KEEP_1__」がインストールおよび設定されたら、最初のライブアップデートバンドルをアップロードする準備ができました。

With the Capgo SDK installed and configured, you’re ready to upload your first live update bundle:

1. Build your web assets:

   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__ コマンドで指定されたチャンネルに新しいバンドルバージョンをアップロードします。

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

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

• __CAPGO_KEEP_0__ ダッシュボードで capacitor.config.ts matches your app in the Capgo dashboard
• あなたの Capacitor ダッシュボードに登録されているアプリと一致していることを確認してください。
• あなたがアップロード コマンドを実行している __CAPGO_KEEP_0__ プロジェクトのルートディレクトリであることを確認してください。

あなたのウェブ アセットがビルドされ、最新の状態であることを確認してください。 あなたがまだ問題がある場合、 トラブルシューティング セクションに移動してください。

__CAPGO_KEEP_0__

__CAPGO_KEEP_2__

1. __CAPGO_KEEP_3__

   npx cap sync ios

2. __CAPGO_KEEP_6__

   npx @capgo/cli@latest app debug

3. __CAPGO_KEEP_9__

   npx cap run ios

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

4. アプリを約30秒間開いておくことで、バックグラウンドでアップデートをダウンロードすることができます。

5. ログは数秒間でアップデートされ、アップデートのステータスを表示します。

6. アプリを閉じて再度開きます。アップデートが正常に適用されたことを確認してください!

Refer back to the Capgoのクイックスタート を参照してください。

詳細については、

Congrats on deploying your first live update with Capgo! 🎉

To learn more, review the rest of the Capgoのライブアップデートの詳細については、. Some key topics to check out next:

• チャンネルを使用した更新のターゲット設定
• 更新の動作のカスタマイズ
• ライブ更新のロールバック

Deploy a Live Updateから続けて

__CAPGO_KEEP_0__ CI/CDを使用している場合 Deploy a Live Updateを__CAPGO_KEEP_0__ CI/CDと連携する __CAPGO_KEEP_0__ CI/CDの製品ワークフローで Capgoネイティブビルド for the product workflow in Capgo CI/CD, Capgo Native Builds 製品ワークフローにおけるCapgoネイティブビルドの Capgo統合 製品ワークフローにおけるCapgo統合の CI/CD統合 CI/CD統合の実装詳細については GitHubアクション統合 実装詳細についてはGitHubアクション統合