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 als ein Update angewendet wird, nachdem es heruntergeladen wurde. Der Plugin prü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
kontext: Seite/ Bereich: Capgo-Lösungen-Marketingseite. Rolle: Kurze UI-Bezeichnung oder Navigationspunkt. Gesehen in: Seite Lösungen/Cordova-to-Capacitor-AI.astro. Nachrichtenschlüssel `solutions_cordova_to_capacitor_ai_table_use_case` (Lösungen Cordova To Capacitor Ai Table Use Case). atBackground	autoUpdate:“ Überprüfen und herunterladen bei jedem Vordergrund-Check, anwenden, wenn die App in den Hintergrund bewegt wird	Viele Apps; minimale Störung
autoUpdate: atInstall	Erst nach einer frischen Installation oder einem Update im native App-Store; andernfalls verwenden Sie atBackground	Neue Benutzer erhalten das neueste; bestehende Benutzer verwenden Hintergrundanwendung
autoUpdate: onLaunch	Erst bei kaltem Start (beendet → Vordergrund); dann fällt zurück auf atBackground	Balance zwischen Aktualität und Sitzungsstabilität
autoUpdate: always	Überprüfen Sie bei jeder Vordergrund-Übergabe und wenden Sie das Update sofort an, wenn ein Update verfügbar ist	Wichtige Korrekturen, Apps mit einfacher Zustandsanzeige
autoUpdate: onlyDownload	Überprüfen und automatisch herunterladen, 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'
  }
}

Tipp

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

Verzögerungsbedingungen

Bedingungen, die erfüllt sein müssen vorher, im Kontext eines HTML-Textfragments aus einem längeren Capgo-UI-String (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-Kopfsatz. 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
Nativversion	Mindestversion des native Binärcode erfordern	Blocken Sie Updates für inkompatible native code
kill	Warten Sie, bis das nächste Anwendungs-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 Hintergrund wie die anderen. Dies wird in einer zukünftigen Version behoben.

Version-Blockierung (Kanalrichtlinie)

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

Strategie	Blockiert	Erlaubt	Verwendungszweck
keine	Nichts	Jede Zielversion eines Pakets	Standard; Vollautomatischer Update
major	Höherer Major als version_build, zum Beispiel 1.2.3 -> 2.0.0	Selben Major, zum Beispiel 1.2.3 -> 1.9.0 oder 1.2.3 -> 1.2.4	Verhindern Sie Änderungen, die alte native code beschädigen
minor	Ein anderer Major oder Minor als version_build, zum Beispiel 1.2.3 -> 1.3.0	Selben Major und Minor, zum Beispiel 1.2.3 -> 1.2.4	Halten Sie Updates innerhalb einer einzigen native Minor-Linie
patch	Jeder Änderungsvorschlag, z.B. 1.0.0 -> 1.0.1	Nur Suffixänderungen während MAJOR.MINOR.PATCH bleibt identisch, z.B. 1.0.0-beta.1 -> 1.0.0-beta.2 oder 1.0.0+build.1 -> 1.0.0+build.2	oder
Strengster Modus: keine Versionsänderung des Kerns	Metadaten min_update_versionFehlende version_build oder	darunter min_update_version Zielbundle, dessen version_build	kleiner oder gleich ist als

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

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

Vorsicht

patch und metadata erforderliche sorgfältige Einstellungen. Siehe CLI Befehle und Versionenziel Details

Lieferungstypen

Wie die Bundle wird 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).
Delta (Manifest)	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	Arten
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

• — Konfigurieren Sie Zeitpunkt und Verzögerung Enterprise-Delivery
• Versionszielung — Kanalbasierte Versionsrouting
• Deltas (Manifest) Updates — Aktiviere partielle Downloads
• Kanäle — Kanalkonfiguration und Vorrang

Fortsetzung von Update Typen

Wenn Sie Live-Updates planen Update Typen um die Lieferung von Live-Updates zu planen, 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 Anleitung zum Starten für die Implementierungsdetails in Anleitung zum Starten