ページのコピー

Capgoは、リアルタイムでアプリの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 in your Capacitor app

2. に設定 capacitor.config.ts

3. あなたの code に CapacitorUpdater.notifyAppReady() メソッド

を追加

あなたがまだそれらのステップを実行していない場合は、まずクイックスタートを完了してください。 あなたの Capgo アカウントにアプリを追加し、アプリにプラグインをインストールしてください。

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

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__のQuickstart Capgo Quickstart 次のステップ

ネイティブクラウドビルド製品ページ/ Capgo Builder / 画面/エリア: Native Build Builder Credit Next / 役割: UIラベルまたはナビゲーションアイテム

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

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

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

Deploy a Live Update

Deploy a Live Update を使用している場合、CI/CDの自動化を計画するには、 それを Capgo CI/CD Capgo製品フロー向けCI/CD Capgoネイティブビルド Capgo製品フロー向けネイティブビルド Capgo統合 Capgo製品フロー向け統合 CI/CD統合 __CAPGO_KEEP_0__アクション統合 GitHubアクション統合の実装詳細 for the implementation detail in GitHub Actions Integration.