Aktualisierungstypen

Eine Einrichtungsanfrage mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

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 auswählen können.

Anwenden Sie die Zeit

Steuerungselemente wenn ein Update angewendet wird, nachdem es heruntergeladen wurde.

Typ	Beschreibung	Verwendungszweck
Standard	__CAPGO_KEEP_0__	Die meisten Apps; minimale Störung
directUpdate: `atInstall`	Sofort anwenden nur bei frischer Installation oder App-Store-Update	Neue Benutzer erhalten das neueste; bestehende Benutzer verwenden den Standard-Flow
directUpdate: `onLaunch`	Sofort anwenden bei Installation, Store-Update oder nach App-Beendigung	Balance zwischen Frische und Sitzungsstabilität
direkterUpdate: `always`	Sofort anwenden, sobald ein Update heruntergeladen wird (einschließlich bei Wiederaufnahme)	Kritische Fixes, Apps mit einfacher Zustandsanzeige

Konfigurieren in capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen vor einer Aktualisierung installiert wird. Verwenden Sie um sie kombinieren (alle Bedingungen müssen erfüllt sein). setMultiDelay 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	__CAPGO_KEEP_0__
nativeVersion	Erfordern Sie eine Mindestversion des native Binärs	Blocken Sie Updates auf inkompatiblen native code
kill	Warten Sie, bis zum nächsten Anwendungs-kill-Ereignis	Ersetzen 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' },
  ],
});

Version Blockierung (Kanalrichtlinie)

Bestimmt, welche semver-Updates ein Kanal automatisch liefern wird. Über die --disable-auto-update Einstellungen auf Kanälen.

Strategie	Blockiert	Erlaubt	Verwendungsfall
keine	Keine Updates	Alle Updates	Standard; Vollautomatische Aktualisierung
Mehr	0.0.0 → 1.0.0	Selbe Hauptversion (z.B. 1.x → 1.y)	Verhindere Änderungen, die alte native Versionen brechen
Klein	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Selbe kleinere Version (z.B. 1.2.x → 1.2.y)	Strikter Kontrolle innerhalb der Hauptversion
Patching	Jede Änderung außer Patch-Bump	Nur 0.0.311 → 0.0.314	Sehr streng; Nur Patch-Updates
Metadaten	Aktualisierungen ohne `min_update_version`	Aktualisierungen mit expliziter Kompatibilitätsmetadata	Benutzerdefinierte Kompatibilitätsregeln pro Bundle

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

Lieferungstypen

Wie die Bündelübertragung zum Gerät erfolgt.

Typ	Beschreibung	Wann zu verwenden
Vollbündel	Das gesamte JS-Bündel wird heruntergeladen.	Erstes Installieren, große Änderungen oder wenn Delta nicht verfügbar ist.
Delta (Manifest)	Nur geänderte Dateien werden heruntergeladen	Viele Updates; schneller und bandbreitenfreundlich

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

Schnellreferenz

Kategorie	Typen
Zeitplan anwenden	Standard, `atInstall`, `onLaunch`, `always`
Verzögerungskriterien	`date`, `background`, `nativeVersion`, `kill`
Versionsblockierung	`none`, `major`, `minor`, `patch`, `metadata`
Lieferung	Vollbundle, Delta (Manifest)

Verwandte — Konfiguration der Anwendung von Zeitverzögerungen und -verzögerungen
Version-Zielsetzung — Kanalbasierte Routing von Versionen
Delta (Manifest)-Updates — Aktivieren von Teildownloads
Kanäle — Konfiguration und Vorrang von Kanälen