Update-Typen

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

Zur Anwendung zeitigen

Controls wann 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 den Intervall (Standard 10 Minuten) einstellen.

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; minimaler Störung
autoUpdate: atInstall	Sofort nur nach einer frischen Installation oder einem Update aus dem App-Store anwenden; andernfalls verwenden Sie atBackground	New users get latest; existing users use background apply
autoUpdate: onLaunch	Sofort nur bei kaltem Start (beendet → Vordergrund); dann fällt zurück auf atBackground	Balance zwischen Aktualität und Sitzungsstabilität
autoUpdate: always	Überprüfen Sie bei jeder Vordergrund-Übergabe und anwenden Sie sofort, wenn ein Update verfügbar ist	Kritische Fixes, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Überprüfen und automatisch herunterladen, ausgeben updateAvailable, und anwenden Sie niemals automatisch	Apps, die ihre eigene Update-Anzeige anzeigen oder genau bestimmen, wann sie aufgerufen werden sollen set()

Konfigurieren in capacitor.config.ts:

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

Tipp

Zum vollständigen Detail und Splashscreen-Handling siehe Updateverhalten.

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen vorher Ein Update wird installiert. Verwenden Sie setMultiDelay sind sie kombinieren (alle Bedingungen müssen erfüllt sein).

Bedingung	Beschreibung	Beispiel
Datum	Warten, bis nach einem bestimmten Datum/Uhrzeit	Coordinate with server-side release
Hintergrund	Warten Sie eine Mindestdauer (ms) nachdem die App im Hintergrund geschaltet wurde	Vermeiden Sie die Anwendung während schneller App-Wechsel
nativeVersion	Erzwingen Sie eine Mindestversion des native Binärs	Blockieren Sie Updates auf inkompatiblen native code
kill	Bis zum nächsten App-Tötungsereignis 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 Tötungsereignis ausgelöst, nicht nach dem nächsten Hintergrund wie die anderen. Dies wird in einer zukünftigen Version behoben.

Versionsblockierung (Kanalrichtlinie)

Regelt welche semver-Updates Ein Kanal liefert sich automatisch. Über --disable-auto-update auf Kanälen.

Strategie	Blöcke	Ermöglicht	Verwendungsfall
Keine	Nichts	Jede Ziel-Bundle-Version	Standard; Vollautomatik
Höher als	Höherer 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 Änderungen, die alte native code beschädigen
kleinere	Ein anderes Haupt- oder Versionsnummer als version_build, zum Beispiel 1.2.3 -> 1.3.0	Selbe Haupt- und Versionsnummer, zum Beispiel 1.2.3 -> 1.2.4	Halten Sie Updates innerhalb einer nativen Minor-Linie.
patch	Jeder Änderung der Haupt-, Versions- oder Patchesnummer, zum Beispiel 1.0.0 -> 1.0.1	Ersetzen Sie nur die Suffixe 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	Stricteste Modus: keine Kernversionsbewegung
oder	oder min_update_versionoder version_build oder	Target-Bundle, dessen min_update_version kleiner oder gleich version_build	Benutzerdefinierte Kompatibilitätsregeln pro Bundle

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

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

Vorsicht

patch und metadata sorgfältige Einrichtung ist erforderlich. Siehe CLI Befehle und Zielgruppensynchronisierung Zielgruppensynchronisierung

Update-Typen

Wie das Bundle an das Gerät übertragen wird. zur Geräte.

Typus	Beschreibung	Wann zu verwenden
Vollbundle	Gesamter JS-Bundle wird heruntergeladen	Erstes Installieren, große Änderungen oder wenn Delta nicht verfügbar ist
Delta	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 verwenden (atInstall, onLaunch, oder always), aktivieren Sie Deltaktualisierungen to minimize download time and improve UX.

Schnellverweis

Kategorie	Arten
Zeitpunkt anwenden	off, atBackground, atInstall, onLaunch, always, onlyDownload
Verzögerungskriterien	date, background, nativeVersion, kill
Version blockieren	none, major, minor, patch, metadata
Auslieferung	Vollbundle, Delta

Related

• Zugehörige Sektion — Konfiguration der Anwendungszeit und -verzögerung
• – Konfigurieren Sie Zeitpunkt und Verzögerung — Kanal-basierte Versionsrouting
• Delta-Updates — nur die geänderten Dateien herunterladen
• Kanäle — Konfiguration und Vorrang der Kanäle

Fortsetzung von Update-Typen

Wenn Sie __CAPGO_KEEP_0__ verwenden Update-Typen um die live update-Lieferung zu planen, verbinden Sie es mit Capgo Live Updates zur Produktworkflow in Capgo Live Updates Übersicht zur Implementierungsdetail in Übersicht Funktionen zur Implementierungsdetail in Funktionen Updateverhalten zur Implementierungsdetail in Updateverhalten, und Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten.