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.

Zeitpunkt anwenden

Steuerung als Ein Update wird nach dem Download angewendet. Der Plugin prüft Updates, wenn die App in den Vordergrund bewegt wird und auf einem wiederholten Timer, während die App geöffnet bleibt. periodCheckDelay Steuert diese 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; minimaler Störung
autoUpdate: atInstall	Anwenden, sobald nur nach einer frischen Installation oder einem Update aus dem Native App Store; andernfalls verwenden atBackground	New users get latest; existing users use background apply
autoUpdate: onLaunch	Sofort anwenden nur bei kaltem Start (beendet → Vordergrund); dann auf Fall-back zurückgreifen atBackground	Balance zwischen Aktualität und Sitzungsstabilität
autoUpdate: always	Überprüfen Sie bei jeder Vordergrundübergabe und wenden Sie die Änderung sofort an, sobald eine Aktualisierung verfügbar ist.	Kritische Fixes, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Überprüfen und automatisch herunterladen, ausgeben updateAvailable, und wenden Sie sich nie automatisch an	Apps, die ihre eigene Update-Anzeige anzeigen oder genau dann aufrufen, wenn sie es wünschen set()

Konfigurieren Sie in capacitor.config.ts:

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

Tip

Für weitere Details und Splashscreen-Handling, siehe Aktualisierungsverhalten.

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen vorher Bevor ein Update 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	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	Erhalten Sie eine Mindestversion des nativen Binärs	Blockieren Sie Updates auf inkompatiblen nativen code
kill	Warten Sie, bis zum nächsten App-Tötungsereignis	Erstwählen Sie 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 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 automatisch liefern wird. Über --disable-auto-update auf Kanäle gesetzt.

Strategie	Blöcke	Ermöglicht	Anwendungsfall
keine	Kein	Jede Ziel-Bundle-Version	Standard; Vollautomatik
Groß	Höherer Hauptversion als version_build, zum Beispiel 1.2.3 -> 2.0.0	Das gleiche Groß, zum Beispiel 1.2.3 -> 1.9.0 oder 1.2.3 -> 1.2.4	Verhindere, dass wichtige Änderungen alte native code erreichen
minor	Verschiedene Haupt- oder Minorversion als version_build, zum Beispiel 1.2.3 -> 1.3.0	Bleiben Updates innerhalb einer native Minorlinie 1.2.3 -> 1.2.4	Halten Sie Updates innerhalb einer nativen Minor-Linie
patch	Any major, minor, or patch number change, for example 1.0.0 -> 1.0.1	bleibt identisch, zum Beispiel MAJOR.MINOR.PATCH bleibt identisch, zum Beispiel 1.0.0-beta.1 -> 1.0.0-beta.2 or 1.0.0+build.1 -> 1.0.0+build.2	Stricteste Modus: keine Kernversionsbewegung
metadata	Fehlend min_update_version, oder version_build Darunter	Zielpaket, dessen min_update_version kleiner oder gleich version_build	Benutzerdefinierte Kompatibilitätsregeln pro Paket

Diese Prüfungen vergleichen das Zielpaket mit der native Baseline, die als version_build, nicht das derzeit installierte heruntergeladene Paket, das als version_name.

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

Achtung

patch und metadata erfordern sorgfältige Einrichtung. Siehe CLI Befehle und Zielgruppenorientierte Updates für weitere Details.

Update-Typen

zum Gerät. Übertragungsarten zur Geräte.

Typ	Beschreibung	Wann verwenden
Vollbundle	Das gesamte JS-Bundle wird heruntergeladen	Zuerst 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

Tip

Wenn Sie Instant-Apply-Modi verwenden (atInstall, onLaunch, oder always), aktivieren Sie Delta-Updates Zu minimalem Downloadzeit und verbessertem UX.

Schnellreferenz

Kategorie	Arten
Anwendungszeitpunkt	off, atBackground, atInstall, onLaunch, always, onlyDownload
Verzögerungsbedingungen	date, background, nativeVersion, kill
Version blockieren	none, major, minor, patch, metadata
Zustellung	Vollpaket, Delta

Zugehörig

• Updateverhalten — Konfiguration der Anwendungszeit und -verzögerung
• Version Zielgruppierung — Kanalbasierte Versionsrouting
• Deltaktualisierungen — Laden Sie nur die geänderten Dateien herunter
• Kanäle --- Kanal-Konfiguration und Vorrang

Fortsetzung von Update-Typen

Wenn Sie __CAPGO_KEEP_0__ verwenden Update-Typen um live update-Lieferungen zu planen, verbinden Sie es mit Capgo Live Updates für den Produktworkflow in Capgo Live Updates, Overview für die Implementierungsdetails im Überblick Features für die Implementierungsdetails in Features, Updateverhalten für die Implementierungsdetails in Updateverhalten, und Zur Einführung für die Implementierungsdetails in Zur Einführung.