Update Arten

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.

Anwendungszeitpunkt

Steuerungselemente als ein Update angewendet wird, nachdem es heruntergeladen wurde. 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 Steuerungselemente, die diesen Zeitraum (Standard 10 Minuten) einstellen.

Typ	Beschreibung	Verwendungsfall
kontrollieren: atBackground	Überprüfen und herunterladen bei jedem Vordergrund-Überprüfung, anwenden, wenn die App in den Hintergrund bewegt wird	Viele Apps; minimale Störung
__CAPGO_KEEP_0__ atInstall	Automatische Aktualisierung: atBackground	Sofort anwenden, nur nach einer frischen Installation oder einer Aktualisierung aus dem App-Store; andernfalls verwenden Sie
Neue Benutzer erhalten die neueste Version; bestehende Benutzer verwenden die Hintergrundaktualisierung onLaunch	Automatische Aktualisierung: atBackground	Sofort anwenden, nur bei einem kalten Start (beendet → Vordergrund); dann fällt zurück auf
Balance zwischen Aktualität und Sitzungsstabilität always	Automatische Aktualisierung:	Überprüfen Sie bei jeder Vordergrund-Übergabe und aktualisieren Sie sofort, wenn eine Aktualisierung verfügbar ist
Kritische Korrekturen, Apps mit einfacher Zustandsanzeige onlyDownload	Automatische Aktualisierung: Überprüfen und herunterladen Sie automatisch, emit updateAvailableund wenden Sie sie nie automatisch an.	Apps, die ihren eigenen Update-Bildschirm 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'
  }
}

Tipps

Zur vollständigen Details und Splashscreen-Verwaltung siehe Updateverhalten.

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen vorher, im Kontext eines Capgo-UI-Strings (Elternschlüssel `create_an_issue_and_discuss_before_working_on_a_new_feature`). Seite/ Bereich: Capgo-Marketingwebsite. Rolle: Langen Marketing- oder Rechtsparagraphen. Gesehen in: Seite contributing.astro. Nachrichtenschlüssel `create_an_issue_and_discuss_before_working_on_a_new_feature` (Create An Issue And Discuss Before Working On A New Feature). | HTML-Textfragment aus einem längeren Capgo-UI-String (Elternschlüssel `mention_issue_before_working`). Seite/Bereich: Capgo-Marketingwebsite. Rolle: Website-Kopfzeilen. Gesehen in: Seite contributing.astro. Nachrichtenschlüssel `mention_issue_before_working` (Mention Issue Before Working). Ein Update wird installiert. 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
Native Version	Mindestversion des native Binärs anfordern	Blocken Sie Updates für inkompatible native code
kill	Warten Sie, bis das nächste App-kill-Ereignis eintritt	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' },
  ],
});

Warnung

Die kill Die Bedingung wird nach dem ersten Kill-Ereignis ausgelöst, nicht nach dem nächsten Hintergrundereignis wie bei den anderen. Dies wird in einer zukünftigen Version behoben.

Version-Blockierung (Kanalrichtlinie)

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

Strategie	Blockiert	Erlaubt	Verwendungszweck
keine	Nichts	Jede Zielversion eines Pakets	Standard; Vollautomatischer Update
Hauptupdate	Höherer Hauptupdate als version_build, zum Beispiel 1.2.3 -> 2.0.0	Selbst gleicher Hauptupdate, zum Beispiel 1.2.3 -> 1.9.0 oder 1.2.3 -> 1.2.4	Verhindern Sie Änderungen, die alte native code beschädigen
Kleiner Update	Verschiedener Haupt- oder kleiner Update als version_build, zum Beispiel 1.2.3 -> 1.3.0	Selbst gleicher Haupt- und kleiner Update, zum Beispiel 1.2.3 -> 1.2.4	Halten Sie Updates innerhalb einer nativen kleineren Zeile
Patch	Jeder Änderungsvorschlag, z.B. 1.0.0 -> 1.0.1	Während MAJOR.MINOR.PATCH identisch bleibt, z.B. 1.0.0-beta.1 -> 1.0.0-beta.2 oder 1.0.0+build.1 -> 1.0.0+build.2	oder
bleibt gleich, z.B.	oder min_update_versionfehlt version_build , oder	unter ihm min_update_version Ziel-Bundle, dessen version_build	ist kleiner oder gleich als

Aus diesen Kontrollen wird das Zielpaket gegen das native Baseline verglichen, das als version_buildnicht das derzeit installierte heruntergeladene Paket, das als version_name.

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

Vorsicht

patch und metadata Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: page trust.astro. Message key `and` (And). CLI Befehle und Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: page trust.astro. Message key `and` (And). Zielversionierung

Lieferungstypen

Wie die Bundle wird zum Gerät übertragen zum Gerät übertragen.

Typ	Beschreibung	Wann zu verwenden
Vollbundle	Ganze JS-Bundle wird heruntergeladen	Erste Installation, große Änderungen oder wenn Delta nicht verfügbar ist
Kontext: Seite/Bereich: Capgo Builder / native cloud Build-Produktseite. Rolle: Kurzer UI-Label oder Navigationspunkt. Nachrichten Schlüssel `native_build_builder_credit_first` (Native Build Builder Credit First).	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

Tipps

Wenn Sie Instant-Apply-Modi verwenden (atInstall, onLaunch, oder always) aktivieren Sie Delta-Updates Delta-Updates

um die Herunterladegeschwindigkeit zu minimieren und die Benutzererfahrung zu verbessern.

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

Zugehöriges

• Verhaltensweise bei Updates — Konfigurieren Sie Zeitpunkt und Verzögerung anwenden
• Versionsziel — Kanalbasierte Versionsrouting
• Deltas (Manifest) Updates — TeilDownloads aktivieren
• Kanäle — Kanalkonfiguration und Vorrang

Fortsetzung: Update-Typen

Wenn Sie live-updaten planen Update-Typen um diese mit Capgo Live Updates zu verbinden 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 Anleitung zum Starten für die Implementierungsdetails in Anleitung zum Starten