Aktualisierungsarten

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

Anwendungszeitpunkt

Steuerungselemente wenn ein Update nach dem Download angewendet wird.

Typ	Beschreibung	Verwendungsfall
autoUpdate: atBackground	Hintergrund herunterladen, anwenden, wenn Benutzer die App in den Hintergrund schickt oder sie beendet.	Die meisten Apps; minimale Störung
autoUpdate: atInstall	Sofort anwenden, nur bei frischer Installation oder App-Store-Update	Neue Benutzer erhalten das neueste; bestehende Benutzer verwenden den Standard-Flow
autoUpdate: onLaunch	Sofort anwenden bei Installation, Store-Update oder nach App-Beendigung	Balance zwischen Frische und Sitzungsstabilität
autoUpdate: always	Sofort anwenden, sobald ein Update heruntergeladen wird (einschließlich bei Wiederaufnahme)	Kritische Fixes, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Automatisch herunterladen und ausgeben, updateAvailableaber nie anwenden oder den nächsten Bundle automatisch setzen	Apps, die ihr eigenes Update-Fenster anzeigen oder genau bestimmen, wann ein Update aufgerufen wird set()

Konfigurieren 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 Splashscreen-Handling siehe Updateverhalten.

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen bevor ein Update installiert wird. Verwenden Sie setMultiDelay sind 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	Block updates auf inkompatible native code
kill	Wait until the next app kill event	Apply only on full restart

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 Kill-Ereignis ausgelöst, nicht nach dem nächsten Hintergrund wie die anderen. Dies wird in einer zukünftigen Version behoben.

Version Blockierung (Kanalrichtlinie)

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

Strategie	Blöcke	Ermöglicht	Verwendungsfall
keine	Nichts	Alle Updates	Standard; Vollautomatischer Update
Hauptupdate	0.0.0 → 1.0.0	Selbe Hauptversion (z.B. 1.x → 1.y)	Verhindere Änderungen, die alte native Versionen beeinträchtigen
kleine Änderung	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Selbe kleine Änderung (z.B. 1.2.x → 1.2.y)	Strikter Kontrolle innerhalb der Hauptversion
kleine Änderung	Jede Änderung außer Patch-Bump	Nur 0.0.311 → 0.0.314	Sehr streng; nur Patch-Updates
Metadaten	Updates ohne min_update_version	Updates mit expliziter Kompatibilitäts-Metadaten	Benutzerdefinierte Kompatibilitätsregeln pro Bundle

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

Vorsicht

patch und metadata erfordern eine sorgfältige Einrichtung. Siehe CLI Befehle und Zielversionierung für Details.

Lieferungstypen

Wie die Bündelübertragung

zum Gerät erfolgt.	Typ	Beschreibung
Wenn zu verwenden	Vollständiges Bündel	Das gesamte JS-Bündel wird heruntergeladen
Zuerst installieren, große Änderungen oder wenn Delta nicht verfügbar ist	Delta (Manifest)	Die meisten Updates; schneller und bandbreitenfreundlicher

# 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 Delta-Updates um den Downloadzeit und die Benutzererfahrung zu verbessern.

Schnellreferenz

Kategorie	Typen
Zeitpunkt anwenden	off, atBackground, atInstall, onLaunch, always, onlyDownload
Verzögerungskriterien	date, background, nativeVersion, kill
Version blockieren	none, major, minor, patch, metadata
Lieferung	Vollbundle, Delta (Manifest)

Zugehörige

• Aktualisierungsverhalten — Konfigurieren Sie Zeitpunkt und Verzögerung
• Versionziel — kanalbasierte Versionsrouting
• Delta (manifest) Updates — Aktiviere teilweise Downloads
• Kanäle — Konfiguration und Vorrang von Kanälen

Weitermachen von Update-Typen

Wenn Sie " Update-Typen" zum Planen der Live-Update-Übermittlung verwenden, verbinden Sie es mit __CAPGO_KEEP_0__ Live Updates für das Produktworkflow in Capgo Live Updates, for the product workflow in Capgo Live Updates, Übersicht __CAPGO_KEEP_0__ Funktionen __CAPGO_KEEP_1__ Aktualisierungsverhalten __CAPGO_KEEP_2__ Einführung __CAPGO_KEEP_3__