Delta-Updates

Ein Setup-Vorschlag mit den Installations-Schritten und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

Capgo’s Live-Update-System kann Updates schneller und effizienter liefern, indem nur die geänderten Dateien gesendet werden, anstatt das gesamte JS-Bundle.

Dies ist insbesondere für Benutzer auf langsamen oder abgerechneten Netzwerkverbindungen vorteilhaft, da es den Datenverkehr minimiert.

Ein zweiter Vorteil ist, wenn die App große Assets hat, die selten geändert werden, wie Bilder oder Videos, verglichen mit den zugezogenen JS-Dateien werden diese nur einmal heruntergeladen.

Wie Delta (Manifest)-Updates funktionieren

Delta-(manifest)-Updates in Capgo werden durch den Capgo-Plugin in Ihrer App gehandhabt. Wenn Sie eine neue Version Ihrer App mit der Flag hochladen, führt Capgo die folgenden Schritte aus: --delta flag, Capgo does the following:

Prüfsummen werden für jede Datei generiert
__CAPGO_KEEP_1__
Aus einem neuen JSON-Manifest wird eine Liste aller Dateien und ihrer Prüfsummen erstellt
Dieses Manifest wird an die Capgo-Datenbank hochgeladen

Wenn ein Gerät, das Ihre App ausführt, nach einer Aktualisierung sucht, erhält das Capgo-Plugin das neue Manifest vom Server. Es vergleicht dieses Manifest mit dem, das es derzeit hat, und identifiziert auf der Grundlage der Prüfsummen und der Dateipfade, welche Dateien geändert wurden.

Das Plugin lädt dann nur die geänderten Dateien herunter, anstatt die gesamte JS-Bundle. Es rekonstruiert die neue Version der App, indem es diese heruntergeladenen Dateien mit den unveränderten Dateien kombiniert, die es bereits hat.

Delta-(Manifest)-Updates aktivieren

Um Delta-(Manifest)-Updates für Ihre Capgo-App zu aktivieren, verwenden Sie einfach die Flagge, wenn Sie eine neue Version hochladen: --delta Terminalfenster

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

Wenn autoUpdate sich auf eine Instant-Apply-Modus ("atInstall", "onLaunch", oder "always") in Ihrem capacitor.config, einstellt, erkennt CLI es. In nicht-interaktiven Umgebungen sendet es Delta-(Manifest)-Updates automatisch, und in interaktiven Umgebungen fragt es Sie nach Bestätigung, bevor es hochlädt. Legacy- directUpdate Konfiguration wird weiterhin erkannt. Verwenden Sie --no-delta um eine vollständige Bundle-Hochladung durchzuführen.

Delta-(Manifest)-Updates durchsetzen

Wenn Sie sicherstellen möchten, dass alle Hochläufe Delta-(Manifest)-Updates sind und jede ungewollte vollständige Bundle-Hochladung verhindern möchten, können Sie den --delta-only Flag verwenden:

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

Wenn --delta-only wird Capgo nur einzelne Dateien hochladen und eine Manifestdatei erstellen. Jedes Gerät, das Delta-Updates (Manifest) nicht unterstützt, kann das Update nicht herunterladen.

Sie möchten möglicherweise --delta-only wenn:

Sie möchten immer Delta-Updates (Manifest) verwenden und vollständige Bundle-Hochladungen nie zulassen
Sie setzen ein CI/CD-Pipeline ein und möchten sicherstellen, dass alle automatisierten Uploads Delta-Updates (Manifest) sind
Ihr App ist groß und die Bandbreite ist eingeschränkt, daher müssen Sie die Upload- und Download-Größe minimieren

Wenn Sie ein vollständiges Bundle-Upload benötigen, während --delta-only gesetzt ist, führen Sie einfach den Upload-Befehl ohne --delta-onlydies wird die Einstellung für diesen einzelnen Upload überschreiben, sodass Sie ein vollständiges Bundle pushen können, wenn Sie es benötigen.

Fehlersuche

Wenn Delta (manifest) -Updates nicht funktionieren (d. h. Geräte laden immer die vollständige JS-Bundle, auch bei kleinen Änderungen), überprüfen Sie bitte, ob:

Sie das --delta Flag immer wieder verwenden, wenn Sie eine neue Version hochladen
Wenn Sie --delta-onlyverwenden, stellen Sie sicher, dass Sie das --delta Flag nicht versehentlich weggelassen haben
Ihr Gerät läuft die neueste Version des Capgo-Plugins
Ihr Gerät hat eine stabile Netzwerkverbindung und kann die Capgo-Server erreichen

Sie können auch die Capgo-Webapp verwenden, um die Details Ihrer letzten Uploads zu überprüfen:

Gehen Sie zu den Webanwendung
Klicken Sie auf Ihre Anwendung
Klicken Sie auf die Anzahl der Pakete in der Statistikleiste.
Wählen Sie das letzte Paket
Überprüfen Sie das Partial Feld

Wenn Sie weiterhin Schwierigkeiten haben, wenden Sie sich bitte an Capgo-Support, um weitere Unterstützung zu erhalten. Sie können die Serverprotokolle überprüfen, um sicherzustellen, dass Ihre Delta-(Manifest)-Uploads korrekt verarbeitet werden und dass Geräte die aktualisierten Manifeste empfangen.

Das ist es! Die --delta Flagge sagt Capgo an, die einzelnen Dateianlagen und die Manifestgenerierung durchzuführen, die für Delta-(Manifest)-Updates erforderlich sind.

Hinweis: Sie müssen --delta jedes Mal verwenden, wenn Sie eine neue Version hochladen, die Sie als Delta-(Manifest)-Update liefern möchten. Wenn Sie die Flagge auslassen, wird Capgo die gesamte JS-Bundle als einzelne Datei hochladen und die Geräte werden die ganze Bundle herunterladen, auch wenn nur ein kleiner Teil geändert wurde.

Bleiben Sie bei Delta-Updates

Wenn Sie Delta-Updates für die Planung der Live-Update-Übermittlung verwenden, verbinden Sie es mit Capgo Live Updates für den Produktworkflow in Capgo Live Updates, Übersicht für die Implementierungsdetails in Übersicht, Funktionen für die Implementierungsdetails in Funktionen, Aktualisierungsverhalten für die Implementierungsdetails in Updateverhalten und Update-Typen für die Implementierungsdetails in Update-Typen.