コンテンツにスキップ
Capgo - Capacitor アプリ向けのリアルタイム更新 Capgo

デルタ更新

Capgoのライブアップデートシステムは、変更されたファイルのみを送信することで、JSバンドルのすべてを送信するのではなく、更新をより効率的に迅速に提供できます。

特に、速度が遅いまたはメトロッドネットワーク接続のユーザーにとっては、ダウンロードする必要があるデータの量を最小限に抑えることで、特に有益です。

アプリケーションが大きなアセットを持っており、頻繁に変更されない場合、例えば画像や動画の場合、圧縮されたJSファイルと比較して、ダウンロードされるのは一度だけです。

デルタ(マニフェスト)アップデートのしくみ

「デルタ(マニフェスト)アップデートのしくみ」

Capgoでは、Capgoプラグインがインストールされているアプリケーションでデルタ(マニフェスト)アップデートが処理されます。アプリケーションの新しいバージョンをアップロードするときに --delta Capgoは以下を実行します:

  1. 各ビルドファイルは個別にアップロードされます
  2. 各ファイルに対してチェックサムが生成されます
  3. 新しいJSONマニフェストが作成され、すべてのファイルとチェックサムがリストされます
  4. このマニフェストはCapgoデータベースにアップロードされます

アプリを実行しているデバイスがアップデートをチェックするとき、Capgoプラグインはサーバーから新しいマニフェストを受け取ります。プラグインはこのマニフェストを現在持っているものと比較し、チェックサムとファイルパスを基に変更されたファイルを特定します。

プラグインは変更されたファイルのみをダウンロードし、全体のJSバンドルではなく、ダウンロードしたファイルと変更されていないファイルを組み合わせて新しいアプリのバージョンを再構築します。

Delta (マニフェスト)更新を有効にする

「Delta (マニフェスト)更新を有効にする」のセクション

Delta (マニフェスト)更新を有効にするには、Capgo アプリのために、次のフラグを使用して新しいバージョンをアップロードしてください。 --delta フラグ

ターミナル画面
npx @capgo/cli@latest bundle upload --delta

もし autoUpdate が即時適用モード ("atInstall", "onLaunch", または "always") に設定されている場合、__CAPGO_KEEP_0__ はそれを検出します。非対話型環境では、Delta (マニフェスト)更新を自動的に送信し、対話型環境ではアップロードする前に確認を求めます。 capacitor.config, the CLI detects it. In non-interactive environments it sends Delta (manifest) updates automatically, and in interactive environments it prompts you to confirm before uploading. Legacy directUpdate config はまだ検出されます。 --no-delta を使用して、フル バンドル アップロードを強制します。

Delta (マニフェスト)更新を強制する

「デルタ（マニフェスト）アップデート」強制設定

全てのアップロードがデルタ（マニフェスト）アップデートであることを確認し、誤ってフルバンドルアップロードを許可しない場合は、 --delta-only 旗:

ターミナル画面
npx @capgo/cli@latest bundle upload --delta-only

「」が使用されると、__CAPGO_KEEP_0__は個々のファイルのみをアップロードし、マニフェストを生成します。デルタ（マニフェスト）アップデートをサポートしていないデバイスはアップデートをダウンロードできません。 --delta-only is used, Capgo will only upload individual files and generate a manifest. Any device that does not support Delta (manifest) updates will not be able to download the update.

「」が使用されると、 --delta-only デルタ（マニフェスト）アップデートを常に使用し、フルバンドルアップロードを許可しない

  • CI/CDパイプラインを設定中で、自動アップロードがすべてデルタ（マニフェスト）アップデートであることを確認したい
  • アプリケーションが大きく、帯域幅が制限されているため、アップロード/ダウンロードサイズを最小限に抑えたい
  • フラグ:

If you need to do a full bundle upload while __CAPGO_KEEP_0__ is set, simply run the upload command without __CAPGO_KEEP_0__. This will override the setting for that single upload, allowing you to push a complete bundle when needed. --delta-only Troubleshooting --delta-onlySection titled “Troubleshooting”

If Delta (manifest) updates don’t seem to be working (i.e. devices are always downloading the full JS bundle even for small changes), double check that:

You’re using the --delta flag every time you upload a new version

If using Capacitor, make sure you haven’t accidentally omitted the --delta flag

  • Your device is running the latest version of the __CAPGO_KEEP_0__ plugin --delta Capacitor
  • Capacitor --delta-onlyCapacitor --delta Capacitor
  • Your device is running the latest version of the Capgo plugin
  • デバイスは安定したネットワーク接続を持ち、Capgoサーバーに接続できます。

また、Capgoウェブアプリを使用して、最後にアップロードした詳細を確認することもできます。

  1. Go to the ウェブアプリ
  2. Click on your app
  3. Click on the bundles number of the stats bar.
  4. Select the last bundle
  5. Check the Partial field bundle type

If you continue to have trouble, please reach out to Capgo support for further assistance. They can check the server logs to confirm that your Delta (manifest) uploads are being processed correctly and that devices are receiving the updated manifests.

That’s it! The --delta 旗子は、Capgo に、Delta (manifest) の更新用に必要な個別のファイルのアップロードとマニフェストの生成を実行するように指示します。

__CAPGO_KEEP_0__ を使用する場合、常に、Delta (manifest) の更新として配信したい新しいバージョンをアップロードする必要があります。フラグを省略すると、__CAPGO_KEEP_0__ は、単一のファイルとして JS バンドルをアップロードし、デバイスは、変更が小さくても、全体のバンドルをダウンロードすることになります。 --delta every time you upload a new version that you want to be delivered as a Delta (manifest) update. If you omit the flag, Capgo will upload the entire JS bundle as a single file, and devices will download the whole bundle even if only a small part has changed.

Delta更新から続ける

Delta更新を使用して、ライブアップデートの配信計画を立てている場合、__CAPGO_KEEP_0__ Live Updatesと接続する必要があります。

__CAPGO_KEEP_0__ Live Updates __CAPGO_KEEP_0__ Live Updates 概要 Capgo Live Updates Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_0__ 機能 機能の実装詳細について 更新動作 更新動作の実装詳細について 更新種類 更新種類の実装詳細について