デルタアップデート

Capgo’s Live Update system can deliver updates faster and more efficiently by only sending the changed files, rather than the entire JS bundle.

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

A second benefit is when the app has large assets that change rarely, like images or videos, compared to zipped JS files, it will be downloaded only once.

How Delta (Manifest) Updates Work

Delta (manifest) updates in Capgo are handled by the Capgo plugin installed in your app. When you upload a new version of your app using the --delta flag, Capgo does the following:

1. Each file in your build is uploaded individually.
2. Checksums are generated for each file.
3. A new JSON manifest is created, listing all files and their checksums.
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 (マニフェスト) の更新の場合、デバイスはダウンロードしたすべてのファイルを共通のキャッシュに格納します。Capgo はそれを消去しませんが、OS はいつでも消去できます。

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

Capgo アプリのために Delta (マニフェスト) の更新を有効にするには、単に次の旗を使用して新しいバージョンをアップロードしてください: --delta ターミナル画面

npx @capgo/cli@latest bundle upload --delta

がデバイスのインスタント アプリケーション モード ( autoUpdate または"atInstall", "onLaunch" ) に設定されている場合、その "always"アプリケーション capacitor.config、CLIはそれを検出します。非対話型環境では、Delta (マニフェスト) アップデートを自動的に送信し、対話型環境ではアップロードする前に確認を求めるようになります。 directUpdate Legacy --no-delta configはまだ検出されます。

__CAPGO_KEEP_0__を強制的にフルバンドルアップロードするには使用します。

• Deltaアップデートの制限 The CLI logs Ignoring empty file... __CAPGO_KEEP_0__はログ
• 空のファイルをDeltaマニフェストから除外します。アップロードを中断せずにアップロード結果を変更するには、空のファイルを追加できます。Zero-byteファイルを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(マニフェスト)アップデートを使用し、フルバンドルアップロードを許可しない --delta-only CI/CDパイプラインを設定し、すべての自動アップロードがDelta(マニフェスト)アップデートであることを保証したい

• アプリケーションが大きく帯域幅が制限されているため、アップロード/ダウンロードサイズを最小限に抑えたい
• フルバンドルアップロードを実行する必要がある場合
• Your app is large and bandwidth is constrained, so you need to minimize upload/download sizes

If you need to do a full bundle upload while --delta-only を設定した場合、単にアップロードコマンドを実行してください。 --delta-onlyが設定されている場合、単にアップロードコマンドを実行してください。この設定は、必要に応じて完全なバンドルをプッシュするために、1回のアップロードのみにオーバーライドされます。

トラブルシューティング

Delta (マニフェスト) の更新が機能しないように見えます (例: 小さな変更にも関わらず、デバイスは常にフル JS バンドルをダウンロードしています)。

• Delta (マニフェスト) の更新が機能しないように見えます (例: 小さな変更にも関わらず、デバイスは常にフル JS バンドルをダウンロードしています)。 --delta Delta (マニフェスト) の更新が機能しないように見えます (例: 小さな変更にも関わらず、デバイスは常にフル JS バンドルをダウンロードしています)。
• Delta (マニフェスト) の更新が機能しないように見えます (例: 小さな変更にも関わらず、デバイスは常にフル JS バンドルをダウンロードしています)。 --delta-onlyDelta (マニフェスト) の更新が機能しないように見えます (例: 小さな変更にも関わらず、デバイスは常にフル JS バンドルをダウンロードしています)。 --delta Delta (マニフェスト) の更新が機能しないように見えます (例: 小さな変更にも関わらず、デバイスは常にフル JS バンドルをダウンロードしています)。
• Your device is running the latest version of the Capgo plugin
• Your device has a stable network connection and can reach the Capgo servers

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

1. ウェブアプリに移動します。 ウェブアプリ
2. アプリをクリックします。
3. 統計バーのバンドル数をクリックします。
4. 最後のバンドルを選択します。
5. バンドルの詳細を確認します。 Partial バンドルの種類

それがすべてです! このフラグは、CapgoにDelta (マニフェスト) アップデートのために必要な個々のファイルのアップロードとマニフェストの生成を実行するように指示します。

__CAPGO_KEEP_0__ --delta Capgo

Capgoを使用するには、Cloudflareのキャッシュを無効にする必要があります。 --delta 毎回、Delta (manifest) アップデートとして配信したい新しいバージョンをアップロードするたびに。フラグを省略すると、Capgo は、すべての JS バンドルを 1 つのファイルとしてアップロードし、デバイスは、変更が小さくても全てのバンドルをダウンロードすることになる。

Deltaアップデートから続けて

Capgoを使用している場合、ライブアップデートは自動的に有効になります。 Delta updates ライブアップデートの配信計画を立てるには、それを接続する Capgo ライブアップデート for the product workflow in Capgo Live Updates, ライブアップデートの差分 概要の実装詳細について 機能 Capgoの機能詳細の実装について アップデートの動作 アップデートの動作の実装詳細について、そして アップデートの種類 アップデートの種類の実装詳細について。