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.

Zeitplan anwenden

Steuerungen wenn ein Update nach dem Download angewendet wird. Der Plugin überprüft Updates, wenn die App in den Vordergrund bewegt wird und auf einem wiederholenden Timer, während die App geöffnet bleibt. periodCheckDelay Steuerungen, die Intervall (Standard 10 Minuten).

Typ	Beschreibung	Verwendungsfall
autoUpdate: atBackground	Überprüfen und herunterladen bei jedem Vordergrund-Check, anwenden, wenn die App in den Hintergrund bewegt wird	Die meisten Apps; minimale Störung
autoUpdate: atInstall	Anwenden Sie ihn sofort nur nach einer frischen Installation oder einem Update im native App-Store; ansonsten verwenden Sie atBackground	Neue Benutzer erhalten die neueste Version; bestehende Benutzer verwenden den Hintergrundanwendungsbetrieb
autoUpdate: onLaunch	Anwenden Sie ihn sofort nur bei einem kalten Start (beendet → Vordergrund); dann fällt er auf atBackground	Balance zwischen Aktualität und Sitzungsstabilität
autoUpdate: always	Überprüfen Sie bei jeder Vordergrundübergang und wenden Sie ihn sofort an, wenn ein Update verfügbar ist	Kritische Fixes, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Überprüfen und herunterladen Sie automatisch, Ausgaben updateAvailable, und wenden Sie ihn niemals automatisch an	Apps, die ihre eigene Updateanzeige anzeigen oder genau bestimmen, wann sie aufgerufen werden sollen set()

Konfigurieren Sie in capacitor.config.ts:

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

Tipp

Zur vollständigen Details und Splashscreen-Verwaltung siehe Aktualisierungsverhalten.

Verzögerungsbedingungen

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 serverseitigen Veröffentlichung
Hintergrund	Warten Sie eine Mindestdauer (ms) nachdem die App im Hintergrund ist	Vermeiden Sie die Anwendung bei schnellen App-Wechseln
nativeVersion	Erhalten Sie eine Mindestversion des native Binärs	Blockieren Sie Updates auf inkompatiblen native code
kill	Bis zum nächsten Anwendungsabbruchereignis warten	Nur bei vollständiger 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 Abbruchereignis ausgelöst, nicht nach dem nächsten Hintergrund wie die anderen. Dies wird in einer zukünftigen Version behoben.

Version Blockierung (Kanalrichtlinie)

Bestimmt welche semver-Updates Autorouting aktivieren. Über --disable-auto-update auf Kanäle.

Strategie	Blöcke	Ermöglicht	Verwendungsfall
keine	Keine	Jede Zielbündelversion	Standard; Vollautomatik
Höher als Major	Höhere Major als version_buildzum Beispiel 1.2.3 -> 2.0.0	Selbe Major, zum Beispiel 1.2.3 -> 1.9.0 oder 1.2.3 -> 1.2.4	Verhindere Änderungen, die alte native code beschädigen
Minor	Verschiedene Major oder Minor als version_buildzum Beispiel 1.2.3 -> 1.3.0	Selbe Major und Minor, zum Beispiel 1.2.3 -> 1.2.4	Halte Updates innerhalb einer native Minor-Linie
Patch	Jeder Änderung von Major, Minor oder Patch, zum Beispiel 1.0.0 -> 1.0.1	Nur Suffix-Änderungen während MAJOR.MINOR.PATCH bleibt identisch, 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 Bewegung der Kernversion
Metadaten	Fehlend min_update_version, oder version_build unter ihr	Zielbundle, dessen min_update_version ist kleiner als oder gleich version_build	Eigene Kompatibilitätsregeln pro Bundle

Diese Überprüfungen vergleichen das Zielbundle mit der native Baseline, die als version_build, nicht das derzeit installierte heruntergeladene Bundle, das als version_name.

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

Vorsicht

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

Lieferungstypen

Wie der Bundle

Typ	Beschreibung	Wenn 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	Bei 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

Tipp

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

Schnellreferenz

Kategorie	Typen
Zuweisung von Zeit	off, atBackground, atInstall, onLaunch, always, onlyDownload
Bedingungen verzögern	date, background, nativeVersion, kill
Version blockieren	none, major, minor, patch, metadata
Lieferung	Vollbundle, Delta (Manifest)

Zugehörige

• Aktualisierungsverhalten — Konfigurieren Sie die Zuweisung von Zeit und Verzögerungen
• Versionziel — Kanalbasierte Versionenrouting
• Delta (manifest) Updates — Teilweise herunterladen aktivieren
• Kanäle — Kanal-Konfiguration und Vorrang

Weitermachen von Update-Typen

Wenn Sie " Update-Typen zur 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 Aktualisierungsverhalten, und Anleitung zum Starten für die Implementierungsdetails in Anleitung zum Starten.