Aktualisierungstypen

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.

Anwendungszeitpunkt anwenden

Steuerungselemente wenn ein Update angewendet wird, nachdem es heruntergeladen wurde. 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 Einstellungen für Intervall (Standard 10 Minuten).

Typ	Beschreibung	Verwendungsfall
autoUpdate: atBackground	Überprüfen und herunterladen bei jedem Vordergrund-Check, anwenden wenn die App in den Hintergrund wechselt	Die meisten Apps; minimale Störung
autoUpdate: atInstall	Anwenden, sobald die App neu installiert oder über den native App Store aktualisiert wurde; andernfalls im Hintergrund anwenden atBackground	Neue Benutzer erhalten die neueste Version; bestehende Benutzer verwenden Hintergrundanwendung
autoUpdate: onLaunch	Anwenden, sobald die App neu gestartet wird (getötet → Vordergrund); dann auf Hintergrundanwendung zurückgreifen atBackground	Balance zwischen Frische und Sitzungsstabilität
autoUpdate: always	Überprüfen Sie bei jeder Vordergrundübergabe und wenden Sie es sofort an, sobald ein Update verfügbar ist	Kritische Fixes, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Überprüfen und automatisch herunterladen, ausgeben updateAvailable, und wenden Sie es nie automatisch an	Apps, die ihre eigene Update-Anzeige 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

For vollständige Details und Splashscreen-Handling, siehe Update-Verhalten.

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen vorher bevor setMultiDelay eine Aktualisierung installiert wird. Verwenden Sie

um sie kombinieren (alle Bedingungen müssen erfüllt sein).	Bedingung	Beschreibung
Beispiel	Warte, bis nach einer bestimmten Zeit/Datum	Koordiniere dich mit der Server-Seitigen Veröffentlichung
Hintergrund	Warte einen Mindestzeitraum (ms) nachdem die App im Hintergrund ist	Vermeide Anwendungen während schneller App-Wechsel
nativeVersion	Erhalte eine Mindestversion des nativen Binärs	Blockiere Updates auf inkompatiblen nativen code
kill	Warte, bis zum nächsten App-Tötungsereignis	Erstelle nur bei vollständiger Neustart

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 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 gesetzt.

Strategie	Blockiert	Ermöglicht	Verwendungsfall
keine	Nichts	Jede Zielbündelversion	Standard; Vollautomatische Aktualisierung
Hauptversion	Höhere Hauptversion als version_build, zum Beispiel 1.2.3 -> 2.0.0	Selbe Hauptversion, zum Beispiel 1.2.3 -> 1.9.0 oder 1.2.3 -> 1.2.4	Verhindere, dass veraltende Änderungen alte native code erreichen
kleine	Verschiedenes Haupt- oder Nebenversion als version_build, zum Beispiel 1.2.3 -> 1.3.0	Selbe Haupt- und Nebenversion, zum Beispiel 1.2.3 -> 1.2.4	Aktualisierungen innerhalb einer nativen Nebenversionslinie beibehalten
Patch	Jede Änderung der Haupt-, Neben- 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 Kernversion
Metadaten	Fehlende min_update_version, oder version_build darunter	Zielbundle, dessen min_update_version ist kleiner als oder gleich version_build	Benutzerdefinierte Kompatibilitätsregeln pro Bundle

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

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

Vorsicht

patch und erfordern eine sorgfältige Einrichtung. Siehe metadata __CAPGO_KEEP_0__ Befehle CLI commands Zielversion für Details. Lieferarten

Abschnitt mit dem Titel „Lieferarten“

Bündelübertragung an das Gerät erfolgt. Typ

Version Targeting	Beschreibung	Wann verwenden
Vollbundle	Das gesamte JS-Bundle wird heruntergeladen	Zuerst installieren, große Änderungen oder wenn Delta nicht verfügbar ist
Delta (Manifest)	Nur geänderte Dateien werden heruntergeladen	Die 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-Apply-Modi (atInstall, onLaunch, oder always) verwenden, aktivieren Sie Delta-Updates um den Downloadzeit und die Benutzererfahrung zu verbessern.

Schnellreferenz

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 und die Verzögerung
• Zielversion — Kanalbasierte Versionsrouting
• Delta (Manifest)-Updates — Aktivieren Sie partielle Downloads
• Kanäle — Kanalkonfiguration und Vorrang

Bleiben Sie bei Update-Typen

Wenn Sie Update-Typen verwenden, um die Live-Update-Übermittlung zu planen, verbinden Sie es mit Live-Updates von Capgo Live-Updates von Capgo, um das Produktworkflow in Live-Updates von Capgo zu verbinden, Capgo Live Updates for the product workflow in Capgo Live Updates, Features Features, um die Implementierungsdetails in Features zu sehen, Update-Verhalten Update-Verhalten Update-Verhalten für die Implementierungsdetails in Update Behavior, und Einstieg für die Implementierungsdetails in Einstieg.