デルタアップデート

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

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

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

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

Capgoのデルタ（マニフェスト）アップデートは、Capgoプラグインがインストールされたアプリで管理されます。アプリの新バージョンをアップロードする際に、Capgoのフラグを設定すると、Capgoは以下のことを行います。 --delta flag、Capgoは以下のことを行います。

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

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.

マニフェスト

Manifest

Delta (マニフェスト)更新の場合、デバイスはダウンロードしたすべてのファイルを共通のキャッシュに格納します。 Capgo はそれを消去しませんが、OSはいつでも消去できます。

Delta (マニフェスト)更新の有効化

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

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

場合

は autoUpdate , または "atInstall", "onLaunch", or "always"、アップロード --delta。 そのモードは、ユーザーが待っている間適用されるため、フルZIPはユーザー体験を遅らせます。 また、 autoSplashscreen: true と @capacitor/splash-screen アップロード launchAutoHide: false。 以下の を参照してください。.

更新の動作 autoUpdate もし"atInstall", "onLaunch", or "always"、または capacitor.config) すると、CLI はそれを検出します。 非対話型環境では、Delta (マニフェスト) アップデートを自動的に送信し、対話型環境ではアップロードする前に確認を求めます。 互換性のある directUpdate 設定はまだ検出されます。 互換性のある --no-delta 全バンドルアップロードを強制します。

Deltaアップデートの制限事項

• 空のファイル: CLI ログ Ignoring empty file... 空のファイルをDeltaマニフェストから除外し、アップロードを中断せずにアップロードを続行します。空のファイルを含むDeltaバンドルパスを含めないでください。
• パス内のスペース: Deltaアップロードは、バンドルパスにスペースが含まれている場合にアップロードを中断し、ファイルまたはディレクトリ名を変更してスペースを除去する必要があります。

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

全アップロードがDelta (マニフェスト) アップデートであることを保証し、誤って全バンドルアップロードを実行しないようにするには、次のフラグを使用できます。 --delta-only フラグ:

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

場合 --delta-only 使用される場合、Capgoは、個々のファイルのみをアップロードし、メニューを生成します。Delta (メニュー)更新をサポートしないデバイスは、更新をダウンロードできません。

使用する場合 --delta-only もし:

• 常にDelta (メニュー)更新を使用し、完全なバンドルアップロードを許可しない場合
• CI/CDパイプラインを設定し、すべての自動アップロードがDelta (メニュー)更新であることを保証したい場合
• アプリケーションが大きく、帯域幅が制限されているため、アップロード/ダウンロードサイズを最小限に抑えたい場合

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

トラブルシューティング

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

• Capacitor --delta Capacitor
• flag --delta-onlyCapacitor --delta Capacitor
• あなたのデバイスは最新のバージョンの Capgo プラグインを実行しています。
• Your device has a stable network connection and can reach the Capgo servers

あなたは、最後のアップロードの詳細を確認するために、Capgo ウェブアプリも使用できます。

1. Capacitor webapp
2. アプリをクリック
3. 統計バーのバンドル数をクリック
4. 最後のバンドルを選択
5. 確認する Partial フィールド

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

完了！ --delta フラグは、Capgo に個々のファイルのアップロードとマニフェストの生成を実行するように指示します。

注意: __CAPGO_KEEP_0__ を使用する必要があります。 --delta Capgo を使用しない場合は、デバイスは変更された部分のみをダウンロードするのではなく、全バンドルをダウンロードします。

Deltal updateから続ける

あなたがDeltal updateを使用している場合 Deltal update Live Update を計画するには、live update を接続する Deltal updateを計画するCapgoの配信に接続するには Deltal updateのCapgo Live Updates Overview Deltal updateの__CAPGO_KEEP_0__ Live Updatesの製品ワークフローについて 概要 Deltal updateの__CAPGO_KEEP_0__ Live Updatesの実装詳細について 機能 Live Update アップデートの種類 Update Types