概要

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.

Public Asset Model

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

How Live Updates Work

CapgoのLive Updateシステムには2つの主なコンポーネントがあります。

1. CapgoのSDK、あなたがアプリにインストールするものです。SDKは、SDKが利用可能なアップデートをチェックし、バックグラウンドでダウンロードします。

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

アップロードした新しいJSバンドルをCapgoに割り当てると、チャンネルに設定されているアプリのCapgoSDKがアップデートを検知し、ダウンロードします。アプリが再起動すると、新しいバンドルがロードされます。

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

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

始動ガイド

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

1. __CAPGO_KEEP_0__の 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. __CAPGO_KEEP_0__は省略されました。

   npx @capgo/cli@latest app debug

5. アップデートがダウンロードされたら、アプリを閉じて再起動してください。

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

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

セクション

アップデートの種類

ライブアップデートの種類: アップデートのタイミング、遅延条件、バージョンブロッキング、配信についてのリファレンス。

チャンネル名です。Capgoのリリースチャンネル機能の名前です。Capgoのソリューションズマーケティングページで見ることができます。ソリューションズ/ホワイトラベル.astroページで見ることができます。Message key `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value)。

進化的なロールアウト

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

ロールバック

前のJSバンドルバージョンに戻る方法を知りましょう。更新が問題を引き起こした場合に。

更新の動作

カスタマイズして、更新がダウンロードされ、適用されるタイミングと方法をアプリ内で制御します。

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

開発/生産チャネルと --fail-on-incompatible、ネイティブ code の変更を意図的にアップロードする方法を学びましょう。

ネイティブ ビルドのテスト

ダウンロードされたライブ更新がネイティブ アセットをマスクしないように、ネイティブ バイナリを検証します。

高速更新

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

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

Capgoを使用している場合 概要 Capgoを使用してアプリのストアの承認と配布を計画する場合、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-in-app-reviewに接続してください。 @capgo/capacitor-in-app-reviewの実装詳細については、@capgo/capacitor-in-app-reviewを参照してください。 @capgo/capacitor-in-app-reviewを使用して、ネイティブ機能を実装してください。 @capgo/capacitor-native-marketの実装詳細については、@capgo/capacitor-native-marketを参照してください。 @capgo/capacitor-native-marketを使用して、ネイティブ機能を実装してください。 @capgo/capacitor-native-market @capgo/capacitor-native-market Capacitorネイティブマーケットの使用@capgo/capacitor-native-market Capacitorネイティブマーケットの使用@capgo/capacitor-native-market、そして Capacitor OTAアップデート: App Store承認ガイド for the practical context in Capacitor OTA Updates: App Store Approval Guide.