Von V3 zu V4

Wozu diese Aktualisierung

Nach vielen Gesprächen in der Discord-Gemeinschaft mit Ihnen habe ich festgestellt, dass der manuelle Modus sehr manuell und nicht sicher war, zum Beispiel war die automatische Rückkehr nicht möglich, also wenn Sie bei der manuellen Aktualisierung scheiterten, mussten Sie die App entfernen und sie erneut installieren, was eine schlechte Benutzererfahrung ist.

Indessen sah ich dies als Gelegenheit, Ihnen mehr Freiheit zu geben und alle schlechten code zu entfernen, die ich gemacht habe.

Installieren

npm i @capgo/capacitor-updater@4

Automatische Aktualisierung im Cloud

Wenn Sie das grundlegende Beispiel in Ihrer App verwenden, sind Sie sicher, die neue Version zu migrieren, genießen Sie es!

Automatische Aktualisierung selbst gehostet

Für Sie bleibt es einfach, die Änderungen sind:

• Der Name der Einstellung von autoUpdateUrl in updateUrl
• Die Endpunkt-Methode wurde von GET zu POST

Benutzer mit manueller Installation

Für Sie ist dies der größte Wechsel, aber auch der beste! Sie erhalten viele Verbesserungen, lesen Sie sorgfältig.

Änderungen

• autoUpdateUrl Werden updateUrl da diese Einstellung nun auch in der manuellen Modus verwendet werden kann
• Löschen von cancelDelay und delayUpdate anstatt setDelay
• Keine mehr versionName im Satz
• Ändern version Schlüssel, der in den meisten Funktionen als Objekt zurückgegeben wurde BundleInfo

interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}

• Wurden umbenannt, um missverständliche Namen zu vermeiden (obwohl es nicht immer klar ist, aber beim Gebrauch ist es leicht zu verstehen):
  • was früher als version wird jetzt auf eine bundle
  • id beziehen Sie sich auf die alte version wer ein zufälliger String von 10 Zeichen war, dies id ist die einzige zuverlässige und einzigartige Möglichkeit, auf Ihre Pakete zuzugreifen, Beispiel 7Dfcd2RedN.
  • version beziehen Sie sich jetzt auf die versionName den Sie für ein Paket ausgewählt haben, Beispiel 1.0.0
• updateUrl von get zu postSeitdem waren benutzerdefinierte Header ein Problem für einige von Ihnen und post ist logischer, alle vorherigen Header gehen in den Körper und der Präfix cap_ verschwindet.
• versionName Methode wurde gelöscht, im Gegenzug getId
• Liste gibt jetzt eine Liste von BundleInfo
• Umbenennen getId in getDeviceId
• autoUpdate wird es standardmäßig wahr, wenn Sie den Manuellen Modus verwenden, setzen Sie es auf false.

Nachrichten

• Methode getLatestdieses Verfahren ermöglicht es Ihnen, von Ihrem mit Ihrem Server konfigurierten updateUrl die letzte verfügbare Version
• Methode setDelay welche {Art: „Hintergrund“ | „Beenden“ | „Native Version“ | „Datum“, Wert: string} als Argument, um die Verzögerung in verschiedenen Modi zu setzen.
• Methode next, um die Version in der nächsten Hintergrundverarbeitung festzulegen, im Gegensatz zu set wer es sofort tut.
• Methode isAutoUpdateEnabled, um Ihnen mitzuteilen, ob Sie sich im automatischen Updatekontext befinden
• Ereignis downloadComplete wenn der Download 100% erreicht hat
• Hinzugefügtes Pflichtfeld version in der Download-Methode
• notifyAppReady wird in der manuellen Mode ebenfalls obligatorisch, wenn nicht nach 10 Sekunden wird die App auf die vorherige Version zurückgesetzt.

Contributors

@lincolnthree Vielen Dank für die Anstrengung, es war ohne Ihre Hilfe unmöglich, diese Aktualisierung zu machen.

Fortsetzung von V3 zu V4

Wenn du V3 zu V4 verwendest Von V3 zu V4 um live update zu planen, verbinde es mit Capgo Live Updates für den Produktworkflow in Capgo Live Updates, Overview für die Implementierungsdetails in Überblick Merkmale zur Implementierungsdetails in Merkmale, Updateverhalten zur Implementierungsdetails in Updateverhalten, und Updatearten zur Implementierungsdetails in Updatearten.