Update Typen

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

Apply Timing

Steuerungen wenn ein Update nach dem Download angewendet wird. Das 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 diesen Zeitraum (Standard 10 Minuten) einstellen.

Typ	Beschreibung	Verwendung
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 zurück auf atBackground	Balance zwischen Neuheit und Sitzungsstabilität
autoUpdate: always	Überprüfen Sie bei jeder Vordergrundübergabe 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, emit 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

Für detaillierte Informationen und die Behandlung des Splashscreens, 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 während schneller App-Wechsel
nativeVersion	Bereitstellen Sie eine Mindestversion des nativen Binärcode	Blockieren Sie Updates auf inkompatiblen nativen code
App-Tötung	Warten Sie, bis das nächste App-Tötungsereignis eintritt	Nur auf Vollstart 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 und nicht nach dem nächsten Hintergrund wie die anderen. Dies wird in einer zukünftigen Version behoben.

Versionsblockierung (Kanalrichtlinie)

Bestimmt, welche semver-Updates Ein Kanal wird automatisch liefern. Über --disable-auto-update auf Kanäle.

Strategie	Blöcke	Ermöglicht	Verwendungsfall
keine	Nichts	Jede Zielbundle-Version	Standard; Voll-Auto-Update
mehr als	Höhere Hauptversion als version_build, zum Beispiel 1.2.3 -> 2.0.0	Selben 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	Verschiedene Haupt- oder kleinere Version als version_build, zum Beispiel 1.2.3 -> 1.3.0	Selbe Haupt- und kleinere Version, zum Beispiel 1.2.3 -> 1.2.4	Halte Updates innerhalb einer native kleineren Version
Patch	Jede Änderung der Haupt-, kleinere oder Patch-Nummer, 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 Bewegung der Kernversion
Metadaten	Fehlend min_update_version, oder version_build darunter	Zielbundle, dessen min_update_version 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 metadata erfordert eine sorgfältige Einrichtung. Siehe CLI Befehle und Zielversionierung für Details.

Lieferungstypen

How die Bundle wird an das Gerät übertragen. Typ

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

# 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 Zeitpunkten	off, atBackground, atInstall, onLaunch, always, onlyDownload
Bedingungen verzögern	date, background, nativeVersion, kill
Versionssperren	none, major, minor, patch, metadata
Lieferung	Vollbundle, Delta (Manifest)

Zugehörige

• Aktualisierungsverhalten — Konfigurieren Sie die Zuweisung von Zeitpunkten und Verzögerungen
• Versionziel — Kanalbasierte Routing von Versionen
• Delta (manifest) Updates — Teilweise herunterladen aktivieren
• Kanäle — Konfiguration und Vorrang von Kanälen

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 Einstieg für die Implementierungsdetails in Einstieg