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

Delta アップデート

CapgoのLive Updateシステムは、変更されたファイルのみを送信することで、JSバンドルの全体を送信するのではなく、更新を高速かつ効率的に提供することができます。

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

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

デルタ（マニフェスト）更新のしくみ

「デルタ（マニフェスト）更新のしくみ」

Capgoでは、Capgoのデルタ（マニフェスト）更新は、Capgoプラグインがインストールされたアプリケーションで管理されます。新しいバージョンのアプリケーションをアップロードする際に、旗を使用すると、Capgoは以下のことを行います。 --delta flag, Capgo does the following:

  1. 各ファイルのチェックサムが生成される
  2. 新しいJSONマニフェストが作成され、ファイルとチェックサムがリストされる
  3. __CAPGO_KEEP_0__
  4. This manifest is uploaded to the Capgo database

When a device running your app checks for an update, the Capgo plugin receives the new manifest from the server. It compares this manifest to the one it currently has, identifying which files have changed based on the checksums and file paths.

The plugin then downloads only the changed files, rather than the entire JS bundle. It reconstructs the new version of the app by combining these downloaded files with the unchanged files it already has.

Delta (manifest)更新の有効化

セクション：Delta (manifest)更新の有効化

Delta (manifest)更新を有効にするには、Capgoアプリのために次のフラグを使用して新しいバージョンをアップロードしてください。 --delta ターミナル画面

コピー
npx @capgo/cli@latest bundle upload --delta

もし directUpdate が有効になっている場合、 capacitor.configで、CLIはそれを検出します。非対話型環境では、Delta (マニフェスト) アップデートを自動的に送信し、対話型環境ではアップロードする前に確認を求めます。 --no-delta を使用して、フル バンドル アップロードを強制します。

Delta (マニフェスト) アップデートを強制する

「Delta (マニフェスト) アップデートを強制する」セクション

すべてのアップロードがDelta (マニフェスト) アップデートであることを保証し、誤ってフル バンドル アップロードを防止したい場合は、 --delta-only フラグを使用できます。

ターミナルウィンドウ
npx @capgo/cli@latest bundle upload --delta-only

が使用されている場合、__CAPGO_KEEP_0__は個々のファイルのみをアップロードし、マニフェストを生成します。Delta (マニフェスト) アップデートをサポートしていないデバイスはアップデートをダウンロードできません。 --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 __CAPGO_KEEP_0__

  • Delta (マニフェスト) アップデートを常に使用し、フル バンドル アップロードを許可しないようにします
  • CI/CD パイプラインを設定し、すべての自動アップロードが Delta (マニフェスト) アップデートであることを確認したい
  • アプリケーションが大きく帯域幅が制限されているため、アップロード/ダウンロードサイズを最小限に抑えたい

__CAPGO_KEEP_0__ --delta-only がセットされている場合、単にアップロード コマンドを実行してください。 --delta-onlyこれは、必要な場合にのみフル バンドルをプッシュできるように、設定をオーバーライドします。

トラブルシューティング

「トラブルシューティング」のセクション

Delta (マニフェスト) アップデートが機能しないように見えます (つまり、デバイスは小さな変更でも常にフル JS バンドルをダウンロードしている場合)、次のことを確認してください:

  • 「__CAPGO_KEEP_0__」 --delta 新バージョンをアップロードするたびにフラグを付ける
  • 使用している場合、 --delta-onlyフラグを含まないようにしてください。 --delta フラグ
  • デバイスは最新のCapgoプラグインを実行しています
  • デバイスは安定したネットワーク接続を持ち、Capgoサーバーにアクセスできます

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

  1. ウェブアプリにアクセス アプリをクリック
  2. 統計バーのバンドル数をクリック
  3. 最後のバンドルを選択
  4. Select the last bundle
  5. 確認してください Partial フィールド バンドルタイプ

問題が続きます場合は、Capgo サポートに連絡してください。サーバーログを確認して、デリタ(マニフェスト)のアップロードが正しく処理されているか、デバイスが更新されたマニフェストを受信しているかを確認してください。

それがすべてです！ --delta Capgo におけるフラグは、個々のファイルのアップロードとマニフェストの生成が必要なデリタ(マニフェスト)の更新を実行するように指示します。

デリタ(マニフェスト)のアップデートとして配信したいバージョンごとに、常に使用してください。フラグを省略すると、__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.