概要

Use Capgo’s Live Updates feature to update the JavaScript bundles of your app remotely, in real-time. Push JS updates directly to your users on iOS, Android, and Electron without going through store-level review cycles to fix bugs and ship new features faster.

注意

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new binary build through the usual platform distribution process.

公開アセットモデル

Capgo にアップロードされた非暗号化のバンドルは、パブリック デリバリ アセットとして扱う必要があります。チャンネルは、更新を提供するデバイスを決定しますが、チャンネルのプライバシーは、下位のバンドルの機密性を確保しません。暗号化は、ストレージとトランジットの保護を追加し、第三者が有効な暗号化された更新を生成することを防止しますが、デバイス上のウェブアセットを検査することは不可能ではありません。なぜなら、デバイスにはデコードに必要なパブリック キーが含まれているからです。詳しくは エンドツーエンド暗号化 を参照してください。

ライブ更新のしくみ

Capgo のライブ更新システムには、2 つの重要なコンポーネントがあります。

1. The Capgo SDK, which you install in your app. The SDK checks for available updates and downloads them in the background.

2. チャンネル、ユーザーを特定のグループにターゲットにすることができるものです。チャンネルを使用して、異なるリリース トラックを管理できます。 Production, Staging、 Dev.

When you upload a new JS bundle to Capgo and assign it to a channel, the Capgo SDK in apps configured for that channel will detect the update and download it. The next time the app restarts, the new bundle will be loaded.

なぜCapgoログが重要か (マーケティング視点)

• 即時ロールアウトの透明性: デバイスごとのタイムラインは、チェック、ダウンロード、インストール、ポリシーブロック、ロールバックなどを表示し、正確に何が起こったかを知ることができ、推測や「私の電話で動作する」などの議論はありません。
• 迅速なインシデント対応: アラートのようなコード (例: レート制限、チェックサムエラー、notifyAppReadyミス) は、ユーザーがサポートに溢れ始める前に表面化し、修正またはロールバックを数分で実行できます。
• チャンネルポリシー証明: ログは、ガードレール (メジャーをブロック、エミュレータ/開発用ビルドを無効化、プラットフォーム制限) が実際に生産を保護していることを証明します。
• 収益と評判の保護: 更新が悪いネットワークでストールしたり、計画制限に当たったりすると、セッション、レビューなどが減少する前に介入できます。
• 単一の真実の源: 製品、QA、サポートは同じクラウドログストリームを共有し、Xcode/Android Studioを探す必要がなく、エンジニアにDMする必要もありません。

Live Updatesの使用を開始する

Live Updatesを使用するには、以下の手順に従ってください。

1. Live Updatesを使用するには、以下の手順に従ってください。 CapgoのQuickstartを完了して、Capgoにアプリを設定し、__CAPGO_KEEP_1__ __CAPGO_KEEP_2__をインストールしてください。 to set up your app in Capgo and install the Capgo SDK.

2. code __CAPGO_KEEP_1__に、更新を受け取る準備ができたことを通知します。 CapacitorUpdater.notifyAppReady() after your app has finished initializing. This tells the Capgo SDK that your app is ready to receive updates.

3. Build your JS bundle and upload it to Capgo:

   npm run build
   npx @capgo/cli@latest bundle upload --channel=production

4. Open your app and wait for the update to download. You can check the status with:

   npx @capgo/cli@latest app debug

5. 更新がダウンロードされたら、アプリを閉じて再起動して新しいバンドルを読み込んでください。

詳細は ライブアップデートの Deploying Live Updates

のガイドを参照してください。

セクション

アップデートの種類

OTAアップデートの種類のリファレンス: アプリケーションの適用タイミング、遅延条件、バージョンブロッキング、配信方法など。

チャンネル

進化的なロールアウト

特定のグループに候補バンドルを配布し、モニタリングし、次にプロモートまたはロールバックします。

ロールバック

更新が問題を引き起こした場合に前のJSバンドルバージョンに戻る方法をご紹介します。

更新の動作

更新がダウンロードされ、適用される方法と時期をカスタマイズする方法をご紹介します。

ネイティブ + OTA ワークフロー

開発/生産チャネルと、ネイティブ __CAPGO_KEEP_0__ の変更を意図的にアップロードする方法について説明します。 --fail-on-incompatible, and how to upload when native code changes on purpose.

ダウンロードされたライブアップデートがネイティブビルドのウェブアセットをマスクしないようにする方法でネイティブバイナリを検証します。

高速アップデート

Progressive rollouts

高速更新を使用して更新プロセスを速める方法を学びましょう。

概要から続けてください。

「概要から続けてください。」というセクションのタイトルです。 Capgoを使用している場合 概要 Capgoを使用してストアの承認と配布を計画する場合、@capgo/capacitor-in-app-reviewに接続してください。 Capgoを使用して@capgo/capacitor-in-app-reviewの実装詳細を参照してください。 @capgo/capacitor-in-app-reviewを使用してネイティブ機能を実装してください。 @capgo/capacitor-native-marketを使用してネイティブ機能の実装詳細を参照してください。 Capgoを使用して@capgo/capacitor-native-marketを実装してください。 Capgoを使用して@capgo/capacitor-native-marketの実装詳細を参照してください。 Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market, and Capacitor OTA Updates: App Store Approval Guide for the practical context in Capacitor OTA Updates: App Store Approval Guide.