Update-Typen

Capgo unterstützt mehrere Arten von über die Luft (OTA) Updates. Diese Seite listet und erklärt alle davon, damit Sie die richtige Combination für Ihre App wählen können.

Zuordnen von Zeitpunkt

Steuerung wenn ein Update angewendet wird, nachdem es heruntergeladen wurde.

Typ	Beschreibung	Anwendungsfall
autoUpdate: atBackground	Herunterladen im Hintergrund, anwenden, wenn der Benutzer die App in den Hintergrund stellt oder sie beendet.	Die meisten Apps; minimale Störung
autoUpdate: atInstall	Sofort anwenden, nur bei frischer Installation oder App-Store-Update	Neue Benutzer erhalten das neueste; bestehende Benutzer verwenden den Standard-Flow
autoUpdate: onLaunch	Sofort an der Installation, beim Speichern der Aktualisierung oder nach App-Beendigung anwenden	Balance zwischen Aktualität und Sitzungsstabilität
autoUpdate: always	Sofort anwenden, sobald eine Aktualisierung heruntergeladen wird (einschließlich bei Wiederanfang)	Kritische Fixes, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Automatisch herunterladen und ausgeben, updateAvailableaber nie automatisch anwenden oder die nächste Bundle setzen	Apps, die ihre eigene Aktualisierungsanzeige anzeigen oder genau bestimmen, wann aufgerufen wird set()

Konfigurieren in capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

Tip

Für vollständige Details und Splashscreen-Handling, siehe Update-Verhalten.

Zusatzbedingungen

Bedingungen, die erfüllt sein müssen bevor eine Aktualisierung installiert wird. Verwenden Sie setMultiDelay um sie kombinieren (alle Bedingungen müssen erfüllt sein).

Bedingung	Beschreibung	Beispiel
Datum	Warten, bis nach einem bestimmten Datum/Uhrzeit	Koordinieren Sie sich mit der Server-Seitigen Veröffentlichung
Hintergrund	Warten Sie eine Mindestdauer (ms) nachdem die App im Hintergrund geschaltet wurde	Vermeiden Sie die Anwendung während schneller App-Wechsel
nativeVersion	Erhalten Sie eine Mindestversion des native Binärs	Blockieren Sie Updates auf inkompatiblen native code
kill	Warten Sie, bis zum nächsten App-Tötungsereignis	Nur auf Neustart anwenden

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

Gefahr

Die kill Die Bedingung wird nach dem ersten Tötungsereignis ausgelöst, nicht wie die anderen im Hintergrund. Dies wird in einer zukünftigen Version behoben.

Version Blockierung (Kanalrichtlinie)

Bestimmt, welche semver-Updates ein Kanal automatisch liefern wird. Über --disable-auto-update auf Kanälen festgelegt.

Strategie	Blöcke	Ermöglicht	Anwendungsbereich
keine	Nichts	Jede Zielbündelversion	Standard; Vollautomatik-Update
Höherer Major als	Zum Beispiel version_buildSelbst gleicher Major, zum Beispiel 1.2.3 -> 2.0.0	für beispielsweise 1.2.3 -> 1.9.0 oder 1.2.3 -> 1.2.4	Verhindern Sie, dass Änderungen, die die Kompatibilität beeinträchtigen, auf alte native code
klein	Verschiedene Haupt- oder Versionsnummer als version_buildzum Beispiel 1.2.3 -> 1.3.0	Selbe Haupt- und Versionsnummer, zum Beispiel 1.2.3 -> 1.2.4	Halten Sie Updates innerhalb einer native Versionslinie
Patch	Jede Änderung der Haupt-, Versions- oder Patchnummer, zum Beispiel 1.0.0 -> 1.0.1	Nur Suffix-Änderungen während MAJOR.MINOR.PATCH identisch bleibt, zum Beispiel 1.0.0-beta.1 -> 1.0.0-beta.2 oder 1.0.0+build.1 -> 1.0.0+build.2	Striktster Modus: keine Versionsbewegung der Kernkomponente
Metadaten	Fehlend min_update_version, oder version_build unter ihr	Zielpaket, dessen min_update_version ist kleiner als oder gleich version_build	Eigene Kompatibilitätsregeln pro Paket

Diese Überprüfungen vergleichen das Zielpaket mit der native Baseline, die als version_build, nicht mit dem derzeit installierten heruntergeladenen Paket, das als version_name.

npx @capgo/cli channel set production --disable-auto-update major

Achtung

patch und metadata erfordert eine sorgfältige Einrichtung. Siehe CLI Befehle und Zielversionierung Details.

Übertragungsarten

Wie das Bündel übertragen wird zum Gerät.

Typ	Beschreibung	Wann zu verwenden
Vollbundle	Gesamter JS-Bundle wird heruntergeladen	Zuerst installieren, große Änderungen oder wenn Delta nicht verfügbar ist
Delta (Manifest)	Nur geänderte Dateien werden heruntergeladen	Meisten Updates; schneller und bandbreitenfreundlich

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

Tip

Wenn Sie Instant-Apply-Modi (atInstall, onLaunch, oder always) verwenden, aktivieren Sie Delta-Updates um den Downloadzeit und die Benutzererfahrung zu verbessern.

Quick Reference

Kategorie	Typen
Anwendungszeitpunkt	off, atBackground, atInstall, onLaunch, always, onlyDownload
Verzögerungskriterien	date, background, nativeVersion, kill
Versionsblockierung	none, major, minor, patch, metadata
Lieferung	Vollbundle, Delta (Manifest)

Zugehörige

• Aktualisierungsverhalten — Konfigurieren Sie die Anwendung von Zeitpunkten und Verzögerungen
• Versionsziel — Kanalbasierte Versionsrouting
• Delta (Manifest)-Updates — Aktivieren Sie partielle Downloads
• Kanäle — Konfiguration und Vorrang der Kanäle

Weitermachen von Update-Typen

Wenn Sie "Update-Typen" verwenden, um die Live-Update-Übermittlung zu planen, verbinden Sie es mit Live-Updates von Capgo für den Produktworkflow in Live-Updates von Capgo, Capgo Live Updates for the product workflow in Capgo Live Updates, Funktionen — Channel configuration and precedence Keep going from Update Types für die Implementierungsdetails in Features, Aktualisierungsverhalten für die Implementierungsdetails in Aktualisierungsverhalten, und Einstieg für die Implementierungsdetails in Einstieg.