Versionsverwaltung

Kopieren Sie einen Setup-Vorschlag mit den Installationsanweisungen und der vollständigen Markdown-Anleitung für diesen Plugin.

Capgo verwendet semantische Versionsnummerierung (semver) zur Versionsnummerierung von Plugins, dem CLI, und den von uns gelieferten Produkten – 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-Majore mit LTS-Tags gesichert werden können.

Schnelle Regeln

Produkt	Mehrere Versionierung	Kompatibilitätsnotizen
Capgo-Erweiterungen	Folge der Übereinstimmung Capacitor Hauptversion	Erweiterungshauptversion `8` Ziele Capacitor 8, `7` Ziele Capacitor 7 und so weiter
Capgo CLI	Unabhängig	Stelle die CLI-Hauptversion nicht mit Erweiterungen oder Capacitor in Sync. Verwende immer die neueste CLI
Capgo-Konsole	Eigene	Eigener Releasezyklus; kompatibel mit unterstützten Updater-Plugin-Versionen

Plugins folgen Capacitor großen Versionen

Jeder Capgo-Plugin verfolgt die Capacitor-Major, 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

When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change Standardoptionen Wenn eine neue Standardoption für eine Capacitor-Generation die bessere langfristige Wahl ist, können wir sie ändern

API-Stabilität zwischen Hauptversionen

Plugin-APIs bleiben zwischen Hauptversionen 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-Hauptversionen zu wechseln, während Sie Capacitor aktualisieren, ohne Ihre Integration neu zu schreiben

Defaults können sich trotzdem bei einer neuen Hauptversion ändern. Überprüfen Sie die Release-Notes und die Migration-Hilfe (siehe Updater-Upgrade und die unter Migrations im Updater-Sidebar befindlichen Anleitungen, wenn Sie einen Schritt machen

CLI und Konsole verwenden ihre eigenen Versionen

Die Capgo CLI und Capgo Konsole verwendet nicht keine Hauptversionen mit Plugins oder Capacitor

Sie machen nicht benötigen Sie einen CLI-Major 8 Installieren oder aufrufen Sie immer die neueste Capacitor 8.
__CAPGO_KEEP_0__ und Konsole verwenden ihre eigenen Versionen latest 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:

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. Terminal window.

Updater-Rückporten vs andere Plugins

Paket	Zurückporten der Vorgängerversionen
`@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	Kundenanforderung

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…, die Capacitor 7 LTS-Linie wird veröffentlicht als 7.3.4 mit dem selben Funktionsumfang und Fehlerbehebungen, angepasst an die Capacitor-Mehrheit.

Installieren Sie mit der Etikettenmarke, wenn Sie "Neueste für diese Capacitor-Mehrheit" möchten:

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

KTS ist eine Rückportierung der neuesten

After a new plugin major ships, an lts-v7 (oder lts-v6, …) Release eine Rückwärtskompatibilität der neuesten so dass das gleiche Arbeiten auf dem vorherigen Capacitor Hauptversion läuft.

Da es die neuesten verfolgt, ändert sich die öffentliche API der LTS-Linie möglicherweise als neueste sich ändert — auch wenn die Hauptzahl auf __CAPGO_KEEP_0__ bleibt. 7. Behandeln Sie LTS als “aktuelles Capgo Verhalten auf einem älteren Capacitor,” und nicht als eine gefrorene legale API für immer.

Was bedeutet dies für Ihre App

Stellen Sie Capgo-Plugins hoch, wenn Sie Capacitor-Majors aktualisieren.
Laufen Sie immer @capgo/cli@latest — CLI-Hauptversionssynchronisierung mit Capacitor/Plugins ist unnötig.
Stay on Capacitor 7 (or older)? Use @lts-v7 (oder die entsprechende Tag), nicht ein zufälliger alter 7.x Von Monaten her.
Verwalten Sie Ihre eigenen Live-Update-Pakete mit semver gleichartig wie Capgo seine Pakete versioniert. Siehe Paketversionierung und Kanäle und Zielgruppenspezifische Versionierung.

Add an app — Install-Befehle und LTS-Tags für den Updater
CLI Übersicht — Capgo CLI-Befehle ausführen
Native-Kompatibilität — wenn eine Änderung ein Laden- vs. ein OTA-Paket erfordert
Von V7 zu V8 — Beispiel für eine Capacitor-kompatible Plugin-Major-Upgrade