Versionsierung

Eine Setup-Anleitung mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren

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.

Kurze Regeln

Produkt	Hauptversionierung	Kompatibilitätsanmerkungen
Erkunden Sie Capgo-Plugins	Folgen Sie der Übereinstimmung 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-Zyklus; kompatibel mit unterstützten Updater-Plugin-Versionen

erforderlich, um mit Ihrer Plugin-Major oder Capacitor-Major übereinzustimmen. Die neueste __CAPGO_KEEP_1__ funktioniert mit jeder unterstützten Updater-Plugin-Version.

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 dieselbe Musterung 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 normalerweise 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 Migration-Hilfe (siehe Updater-Upgrade und die Anleitungen unter Migrations in der Aktualisierungsleiste) wenn Sie einen Schritt machen.

CLI und die Konsole verwenden ihre eigenen Versionen.

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

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

Eine alte CLI Version veralteten ist nicht empfohlen. Stattdessen:

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

LTS-Tags für vorherige Plugin-Majors

Wenn Sie sich an einer älteren Capacitor-Version aufhalten, installieren Sie die entsprechende Capgo-Plugin-Major 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-Majors veröffentlicht On Demand.

Updater-Rückporten vs. andere 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. Produkt/Markenname und Entwicklertrems bleiben genau. Nachrichtsschlüssel `enterprise_130_plugins` (Enterprise 130 Plugins).

On Demand

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-Mehrheit.

Installieren Sie mit dem Tag, wenn Sie "aktuell 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

LTS ist eine Rückport der neuesten Version

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

Da es die neuesten Versionen verfolgt, kann die öffentliche API der LTS-Linie sich ändern Kann sich ändern wenn sich die neuesten Versionen ändern – auch wenn die Hauptzahl auf __CAPGO_KEEP_0__ bleibt 7. Behandeln Sie LTS als "aktuelles Capgo Verhalten auf einem älteren Capacitor", nicht als eine gefrorene Legacy- API für immer.

Worauf das für Ihre App bedeutet

Stellen Sie sicher, dass Sie Capgo-Plugins aktualisieren, wenn Sie Capacitor-Majors aktualisieren.
Laufen Sie immer @capgo/cli@latest – CLI Hauptversion synchron mit Capacitor/Plugins ist unnötig.
Bleiben Sie bei Capacitor 7 (oder älter)? Verwenden Sie @lts-v7 (oder die entsprechende Tag), nicht einen zufälligen alten 7.x von Monaten her.
Versionieren Sie Ihre eigenen Live-Update-Bundles mit semver derselben Weise, wie Capgo seine Pakete versioniert. Siehe Bundles-Versionierung und Kanäle und Versionierung zum Ziel.

Eine App hinzufügen --- Install-Befehle und LTS-Tags für den Updater
CLI Übersicht --- Wie man Capgo CLI-Befehle ausführt
Native-Kompatibilität context: Seite/ Bereich: Produktseite für Live-Updates. Rolle: Kurzer UI-Label 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 Speicherdatei vs. eine OTA-Bundle erfordert — example of a Capacitor-aligned plugin major upgrade