概要

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 を参照してください。

Live Updates のしくみ

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

1. Capgo の SDK、これをアプリにインストールします。 SDK は、利用可能な更新をチェックし、バックグラウンドでダウンロードします。

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を使用するには、以下の手順に従ってください。

1. __CAPGO_KEEP_0__を完了してください。 Capgoにアプリをセットアップし、__CAPGO_KEEP_1__ __CAPGO_KEEP_2__をインストールするためのCapgoクイックスタートを実行してください。 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. 始め方

   npx @capgo/cli@latest app debug

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

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

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

セクション

アップデートの種類

リファレンス

チャンネル

進歩的なロールアウト

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

ロールバック

前の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-in-app-reviewのネイティブ機能を使用してください。 @capgo/capacitor-native-marketの実装詳細については、@capgo/capacitor-native-marketを参照してください。 @capgo/capacitor-native-marketを使用して、@capgo/capacitor-native-marketのネイティブ機能を使用してください。 @capgo/capacitor-native-market @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.