Zum Inhalt springen
Capgo - Live Updates für Capacitor Apps Capgo

Versionsierung

Capgo verwendet semantische Versionsnummerierung (semver) für Plugins, das CLI, und die Produkte, die wir liefern — die gleiche Praxis, die wir für Ihre eigenen App-Bundles empfehlen.

Dieses Dokument erklärt, wie sich diese Versionen zueinander verhalten, was im Laufe der Zeit kompatibel bleibt und wie ältere Capacitor-Majore mit LTS-Tags gesichert werden können.

Kurze Regeln

Schnelle Regeln
ProduktGroßversionierungKompatibilitätsanmerkungen
Capgo-ErweiterungenFolge der Übereinstimmung Capacitor-GroßversionPlugin-Großversion 8 Ziele Capacitor 8 7 Ziele Capacitor 7 und so weiter
Capgo CLIUnabhängigSynchonisiere CLI-Großversion nicht mit Erweiterungen oder Capacitor. Verwende immer die neueste CLI
Capgo KonsoleUnabhängigEigener Release-Zyklus; kompatibel mit unterstützten Updater-Plugin-Versionen

Plugins folgen Capacitor Hauptversionen

Abschnitt mit dem Titel “Plugins folgen Capacitor Hauptversionen”

Jedes Capgo-Plugin verfolgt die Capacitor-Major, für das es gebaut wird:

  • @capgo/capacitor-updater@8 → Capacitor 8
  • @capgo/capacitor-updater@7 → Capacitor 7
  • und das gleiche Muster für andere Capgo-Plugins

Wenn Capacitor eine neue Major-Version veröffentlicht, veröffentlicht Capgo eine entsprechende Plugin-Major-Version. Das ist der Zeitpunkt, an dem wir möglicherweise Änderungen vornehmen Standardoptionen Wenn ein neuer Standard die bessere langfristige Wahl für eine Capacitor-Generation ist.

API-Stabilität zwischen Majors

Abschnitt mit dem Titel "API-Stabilität zwischen Majors"

Plugin-APIs bleiben zwischen Majors stabil, es sei denn, ein Änderung ist für alle (z.B. eine Capacitor-Plattformanforderung, die denselben Bruch auf allen Konsumenten erzwingt). Sie sollten in der Regel in der Lage sein, zwischen Capgo-Plugin-Majors zu wechseln, während Sie Capacitor aktualisieren, ohne Ihre Integration neu zu schreiben.

Standardoptionen können sich auf einer neuen Major ändern. Überprüfen Sie die Release-Notes und die Migrationshinweise (siehe Updater-Upgrade und die Anleitungen unter Migrations im Updater-Sidebar) wenn Sie bump.

CLI und Konsole verwenden ihre eigenen Versionen

Abschnitt mit dem Titel „CLI und Konsole verwenden ihre eigenen Versionen“

Die Capgo CLI und Capgo Konsole verwendet keine große Versionen mit Plugins oder Capacitor.

  • Sie müssen keine CLI große 8 weil Sie auf Capacitor 8 oder Updater 8.
  • Installieren oder aufrufen Sie immer die neueste CLI.
  • Die neuesten CLI und Console bleiben mit jeder unterstützten Version kompatibel. @capgo/capacitor-updater (und der damit verbundene Updater) Hauptversion.

Ein altes CLI-Version festlegen wird abgeraten. Stattdessen bevorzugen Sie:

Terminalfenster
npx @capgo/cli@latest bundle upload --channel=production

LTS-Tags für vorherige Plugin-Hauptversionen

Abschnitt mit dem Titel “LTS-Tags für vorherige Plugin-Hauptversionen”

Wenn Sie sich an einer älteren Capacitor-Hauptversion befinden, installieren Sie die entsprechende Capgo-Plugin-Hauptversion mit einem LTS-Dist-Tag anstatt eine veraltete Lockdatei für immer zu kopieren.

Terminalfenster
# Latest Capgo updater for Capacitor 7
npm i @capgo/capacitor-updater@lts-v7


# Same pattern for other majors
npm i @capgo/capacitor-updater@lts-v6
npm i @capgo/capacitor-updater@lts-v5
npm i @capgo/capacitor-updater@lts-v4

Außerhalb des Updaters werden LTS-Versionen von vorherigen Plugin-Hauptversionen veröffentlicht On Demand.

Updater-Rückporten gegenüber anderen Plugins

Sektion: "Updater-Rückporten gegenüber anderen Plugins"
PaketZurückporten der Vormajorversionen
@capgo/capacitor-updaterMonatliche gespiegelte Rückporten zu v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 bleibt für Capacitor 4 verfügbar, ist aber nicht auf diesem monatlichen Rhythmus
Sonstige Capgo-PluginsSeite: Produkt/Preisliste für Unternehmen. Rolle: Website-Text. Gesehen in: Seite enterprise.astro. Produkt/Markenname und Entwicklertitel von Capgo werden genau beibehalten. Nachrichtenschlüssel `enterprise_130_plugins` (Unternehmen 130-Plugins).

On Demand

Die gleichen Funktionen, gespiegelte Versionsnummern

Sektion: "Die gleichen Funktionen, gespiegelte Versionsnummern"

If die neueste Version ist 8.3.4, dann wird die Capacitor 7 LTS-Linie als 7.3.4 mit dem selben Funktionsumfang und Fehlerbehebungen, angepasst an die Capacitor-Majortversion.

Installieren Sie mit dem Tag, wenn Sie "Neueste für diese Capacitor-Majortversion" möchten:

Terminalfenster
npm i @capgo/capacitor-updater@lts-v7   # resolves to the current 7.x LTS, e.g. 7.3.4

LTS ist eine Rückport der neuesten

Sektion mit dem Titel "LTS ist eine Rückport der neuesten"

Nachdem eine neue Plugin-Majortversion abgeschickt wurde, wird ein lts-v7 (oder lts-v6…) Release ist eine Rückport der neuesten so dass das gleiche Arbeitspaket auf dem vorherigen Capacitor Hauptversion läuft.

Da es die neuesten Versionen verfolgt, kann die öffentliche API der LTS-Linie sich ändern wenn sich die neuesten Versionen ändern – auch wenn die Hauptzahl auf __CAPGO_KEEP_0__ bleibt. Treat LTS als "aktuelles __CAPGO_KEEP_0__ Verhalten auf einem älteren __CAPGO_KEEP_1__" und nicht als ein gefrorener Legacy-__CAPGO_KEEP_2__ für immer." 7. Treat LTS as “current Capgo behavior on an older Capacitor,” not as a frozen legacy API forever.

Worauf das für Ihre App bedeutet

Stellen Sie sicher, dass Sie __CAPGO_KEEP_0__-Plugins aktualisieren, wenn Sie __CAPGO_KEEP_1__-Majors aktualisieren.
  1. Upgrade Capgo plugins when you upgrade Capacitor majors.
  2. – __CAPGO_KEEP_0__-Hauptversion synchron mit __CAPGO_KEEP_1__/Plugins ist unnötig. @capgo/cli@latest Upgrade CLI-Plugins, wenn Sie Capacitor-Majors aktualisieren.
  3. Bleiben Sie bei Capacitor 7 (oder älter)? Verwenden Sie @lts-v7 (oder die entsprechende Etikette), nicht eine zufällige alte 7.x Von Monaten her.
  4. Versionieren Sie Ihre eigenen Live-Update-Bundles mit semver in der gleichen Weise, wie Capgo seine Pakete versioniert. Siehe Bundle-Versionierung und Kanäle und Zielgruppenerfassung.
Abschnitt mit dem Titel “Zugehörige Dokumentation”