Versionsierung

Für die Kopie vorbereitet

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.

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	Großversionierung	Kompatibilitätsanmerkungen
Capgo-Erweiterungen	Folge der Übereinstimmung Capacitor-Großversion	Plugin-Großversion `8` Ziele Capacitor 8, `7` Ziele Capacitor 7 und so weiter
Capgo CLI	Unabhängig	Synchonisiere CLI-Großversion nicht mit Erweiterungen oder Capacitor. Verwende immer die neueste CLI
Capgo Konsole	Unabhängig	Eigener Release-Zyklus; kompatibel mit unterstützten Updater-Plugin-Versionen

Plugins folgen Capacitor Hauptversionen

Jedes Capgo-Plugin verfolgt die Capacitor-Majorität, für die 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 veröffentlicht, veröffentlicht Capgo eine entsprechende Plugin-Major. Das ist der Zeitpunkt, an dem wir möglicherweise ändern Standardoptionen Wenn ein neuer Standard die bessere langfristige Wahl für eine Capacitor-Generation ist.

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 noch ändern. Überprüfen Sie die Release-Notes und die Migrationshinweise (siehe Updater-Upgrade und die Leitfäden unter Migrations in der Aktualisierungsleiste) wenn Sie einen Punkt erreichen.

CLI und die Konsole verwenden ihre eigenen Versionen.

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

Sie müssen keine große CLI-Version 8 weil Sie auf Capacitor 8 oder der Aktualisierungsleiste sind. 8.
Installieren oder laden Sie immer die neueste CLI.
Die neuesten CLI und Console bleiben mit jeder unterstützten Version kompatibel. @capgo/capacitor-updater Die (und die zugehörige Updater) Hauptversion bleibt kompatibel.

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

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

LTS-Tags für vorherige Plugin-Majors

Wenn Sie sich an einer älteren Capacitor-Hauptversion aufhalten, 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 der vorherigen Plugin-Majors veröffentlicht On Demand.

Updater-Rückporten gegenüber anderen Plugins

Paket	Zurückporten der Vormajorversionen
`@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, ist aber nicht auf diesem monatlichen Rhythmus
Sonstige Capgo-Plugins	Seite: Produkt/Preisliste. Rolle: Website-Text. Gesehen in: Seite enterprise.astro. Erhaltung von Capgo-Produkt/Marke und Entwicklertermen genau. Nachrichtenschlüssel `enterprise_130_plugins` (Enterprise 130 Plugins).

On Demand

Sektion: Selbe 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-Majoreneuheit.

Installieren Sie mit der Etikettenzeichenung, wenn Sie "neueste für diese Capacitor-Majoreneuheit" möchten:

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

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

Da es die neueste Version verfolgt, kann die öffentliche API der LTS-Linie sich ändern wenn sich die neueste Version ändert – auch wenn die Hauptzahl auf __CAPGO_KEEP_0__ bleibt . Behandeln Sie LTS als "aktuelles __CAPGO_KEEP_0__ Verhalten auf einem älteren __CAPGO_KEEP_1__", 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.

Abschnitt mit dem Titel "Worauf dies für Ihre App bedeutet"

Upgrade Capgo plugins when you upgrade Capacitor majors.
– __CAPGO_KEEP_0__-Hauptversionssynchronisierung mit __CAPGO_KEEP_1__/Plugins ist unnötig. @capgo/cli@latest Upgrade CLI-Plugins, wenn Sie Capacitor-Hauptversionen aktualisieren.
Bleiben Sie auf Capacitor 7 (oder älter)? Verwenden Sie @lts-v7 (oder die entsprechende Etikette), nicht eine zufällige alte 7.x Von Monaten her.
Versionieren Sie Ihre eigenen Live-Update-Bundles mit semver in der gleichen Weise, wie Capgo seine Pakete versioniert. Siehe Bundles-Versionierung und Kanäle und Versionierung zum Ziel.

Eine App hinzufügen – Installationskommandos und LTS-Tags für den Updater
CLI Übersicht – Wie man Capgo CLI Kommandos ausführt
Native Kompatibilität context: Seite/ Bereich: Produktseite für Live-Updates. Rolle: Kurzer Benutzeroberflächentext oder Navigationspunkt. Gesehen in: Seite live-update.astro. Nachrichtenschlüssel `live_update_v2_comp_compat_l` (Live-Update-V2-Comp-Compat-L)
– Wenn ein Änderungsbedarf eine Store-Binary gegenüber einer OTA-Bundle erfordert — example of a Capacitor-aligned plugin major upgrade