Versionsierung

Ein Setup-Prompt mit den Installations-Schritten und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

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

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

Schnelle Regeln

Produkt	Hauptversionsnummerierung	Kompatibilitätsnotizen
Capgo Plugins	Folgen Sie der passenden Capacitor Hauptversion	Plugin-Hauptversion `8` Ziele Capacitor 8, `7` Ziele Capacitor 7 und so weiter
Capgo CLI	Unabhängig	Synchronisieren Sie nicht CLI Hauptversion mit Plugins oder Capacitor. Verwenden Sie immer die neueste CLI
Capgo Konsole	Unabhängig	Eigener Release-Rhythmus; kompatibel mit unterstützten Updater-Plugin-Versionszahlen

Plugins folgen Capacitor-Majors

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

@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 Hauptversion veröffentlicht, veröffentlicht Capgo eine entsprechende Plugin-Hauptversion. Das ist der Zeitpunkt, an dem wir möglicherweise Änderungen vornehmen. Standardoptionen Wenn eine neue Standardoption für die langfristige Wahl für die Capacitor-Generation besser ist.

API-Stabilität über Hauptversionen

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

Standardoptionen können sich auf eine neue Hauptversion noch ändern. Überprüfen Sie die Release-Notes und die Migrationsanleitungen (siehe Updater aktualisiert und die Anleitungen unter Migrations im Updater-Sidebar) bei jedem Update.

CLI und Konsole verwenden ihre eigenen Versionen

Die Capgo CLI und Capgo Konsole teilt sich keine Hauptversionen mit Erweiterungen oder Capgo. Sie benötigen keine __CAPGO_KEEP_0__-Hauptversion, da Sie auf __CAPGO_KEEP_0__ 8 oder einem Updater sind. Installieren oder aufrufen Sie immer die neueste Capacitor.

Die neuesten __CAPGO_KEEP_0__ und Konsole bleiben mit jeder unterstützten Version kompatibel. __CAPGO_KEEP_0__ and __CAPGO_KEEP_1__ and __CAPGO_KEEP_2__ You do not need CLI major 8 because you are on Capacitor 8 or updater 8.
Always install or invoke the latest __CAPGO_KEEP_0__. The latest __CAPGO_KEEP_0__ and Console remain compatible with any supported CLI and Console use their own versions
The CLI __CAPGO_KEEP_1__ and __CAPGO_KEEP_2__ Console do @capgo/capacitor-updater und zugehöriger Updater) Hauptversion.

Ein Pinning an einer alten CLI Version wird abgeraten. Vorzuziehen:

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

LTS-Tags für vorherige Plugin-Hauptversionen

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

# 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 auf Anfrage veröffentlicht auf Anfrage.

Updater-Backports gegenüber anderen Plugins

Paket	Zuvor-maßstabsvergrößernde Rückporten
`@capgo/capacitor-updater`	Monatliche gespiegelte Rückporten zu `v7` / `v6` / `v5` (`lts-v7`, `lts-v6`, `lts-v5`). `lts-v4` bleibt für Capacitor 4 verfügbar, wird aber nicht auf diesem monatlichen Rhythmus veröffentlicht
Andere Capgo-Plugins	Auf Anfrage

Selbe Funktionen, gespiegelte Versionsnummern

Die LTS-Linien spiegeln die aktuellen neuesten Linien-Minor- und Patchespiegelung wider, wenn ein Rückport existiert.

Wenn die letzte Veröffentlichung ist 8.3.4, wird die Capacitor 7-LTS-Linie als 7.3.4 mit demselben Funktionsumfang und Bugfixen , angepasst an das __CAPGO_KEEP_0__ Hauptversion.Installieren Sie mit der Etikette, wenn Sie "Neuestes für diese Capacitor Hauptversion" möchten:

Install with the tag when you want “latest for this Capacitor major”:

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

Abschnitt mit dem Titel "LTS ist eine Rückportierung des neuesten"

(oder lts-v7 , …) Release eine lts-v6Rückportierung des neuesten LTS ist eine Rückportierung des neuesten so dass das gleiche Programm auf dem vorherigen Capacitor Hauptversion läuft.

Denn es verfolgt die neuesten, die LTS-Linie veröffentlicht API möglicherweise ändert sich wenn die neuesten Änderungen — selbst wenn die Hauptzahl auf __CAPGO_KEEP_0__ bleibt 7Behandeln Sie LTS als “aktuelles Capgo Verhalten auf einem älteren Capacitor,” und nicht als ein gefrorener Legacy API für immer.”

Was bedeutet dies für Ihre App

Aktualisieren Sie Capgo-Plugins, wenn Sie Capacitor-Majors aktualisieren.
Laufen Sie immer @capgo/cli@latest — CLI-Majorsynchronisierung mit Capacitor/Plugins ist unnötig.
Bleiben Sie bei Capacitor 7 (oder älter)? Verwenden Sie @lts-v7 (oder die entsprechende Tag), nicht eine zufällige alte 7.x Von Monaten her.
Versionieren Sie Ihre eigenen Live-Update-Pakete mit semver derselben Weise, wie Capgo seine Pakete versioniert. Siehe Paketversionierung und Kanäle und Zielgruppennavigation.

Hinzufügen einer App — Installationskommandos und LTS-Tags für den Updater
CLI-Übersicht — wie man Capgo CLI-Befehle ausführt
Nativkompatibilität — wann eine Änderung ein Speicherbinär benötigt vs. ein OTA-Bundle
Von V7 zu V8 — Beispiel für eine Capacitor-ausgerichtete Plugin-Major-Upgrade