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.

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.

Richtlinien für den schnellen Start

Schnelle Richtlinien
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ängigÜbertrage 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

mit deiner Plugin-Hauptversion oder Capacitor Hauptversion übereinstimmen. Die neueste __CAPGO_KEEP_1__ funktioniert mit jeder unterstützten Updater-Plugin-Version.

Plugins folgen Capacitor Hauptversionen

Jeder Capgo-Plugin verfolgt die Capacitor-Version, für die es gebaut wurde.

  • @capgo/capacitor-updater@8 → Capacitor 8
  • @capgo/capacitor-updater@7 → Capacitor 7
  • and the same pattern for other Capgo plugins

When Capacitor ships a new major, Capgo ships a matching plugin major. That is when we may change Standardmäßige Optionen Wenn eine neue Standardversion für die Zukunft besser geeignet ist, für diese Capacitor Generation.

API Stabilität zwischen Hauptversionen

Section titled “API stability across majors”

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

Defaults können sich aufgrund einer neuen Hauptversion noch ändern. Überprüfen Sie die Release-Notes und die Migration-Anleitungen (siehe Der Updater aktualisiert und die Anleitungen unter Migrations im Updater-Sidebar) wenn Sie einen Punkt erreichen.

CLI und Console verwenden ihre eigenen Versionen.

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

Die Capgo CLI und Capgo Console teilen keine Hauptversionen mit Plugins oder __CAPGO_KEEP_0__. Sie müssen keine Capacitor Hauptversionen benötigen.

  • weil Sie auf __CAPGO_KEEP_0__ 8 oder Updater sind. Installieren oder aufrufen Sie immer die need CLI major 8 because you are on Capacitor 8 or updater 8.
  • Always install or invoke the latest CLI.
  • Die neuesten CLI und Console bleiben mit jeder unterstützten Version kompatibel. @capgo/capacitor-updater Major-(und zugehöriger Updater) Version.

Eine alte CLI-Version festlegen wird abgeraten. Stattdessen bevorzugen Sie:

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

LTS-Tags für vorherige Plugin-Majors

Abschnitt mit dem Titel „LTS-Tags für vorherige Plugin-Majors“

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

Terminal-Fenster
# 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

Sektion: "Updater-Rückporten vs. andere Plugins"
PaketZurückporten der Vorgänger-Maßstäbe
@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. Rolle: Website-Text. Gesehen in: Seite enterprise.astro. Capgo-Produkt/Marke und Entwicklerbegriffe werden genau beibehalten. Nachrichtenschlüssel `enterprise_130_plugins` (Enterprise 130 Plugins).

On Demand

Selbe Funktionen, gespiegelte Versionsnummern

Sektion: "Selbe Funktionen, gespiegelte Versionsnummern"

Wenn die neueste Version ist 8.3.4, wird die Capacitor 7 LTS-Linie als 7.3.4 mit demselben Funktionsumfang und Fehlerbehebungen , angepasst an die __CAPGO_KEEP_0__-Majortaste.Installieren Sie mit der Tag, wenn Sie "Neueste für diese Capacitor-Majortaste" möchten:

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

Zur Zwischenablage kopieren
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 der neuesten"

Nachdem eine neue Plugin-Majortaste abgeschickt wurde, wird ein

(oder lts-v7 LTS ist eine Rückportierung der neuesten lts-v6…) Release ist ein Rückport der neuesten so dass das gleiche Arbeiten auf dem vorherigen Capacitor Major läuft.

Da es die neuesten verfolgt, kann die öffentliche API des LTS-Zweigs sich ändern wenn sich die neuesten ändern – 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"

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__-Major-Synchronisierung mit __CAPGO_KEEP_1__/Plugins ist unnötig. @capgo/cli@latest Upgrade CLI-Plugins, wenn Sie Capacitor-Majors aktualisieren.
  3. Verbleiben Sie bei Capacitor 7 (oder älter)? Verwenden Sie @lts-v7 (oder dem entsprechenden Tag), nicht einen zufälligen alten 7.x von Monaten her.
  4. Versionieren Sie Ihre eigenen Live-Update-Bundles mit semver den gleichen Weg, wie Capgo seine Pakete versioniert. Siehe Bundle-Versionierung und Kanäle und Zielgruppenspezifische Versionierung.
Abschnitt mit dem Titel “Zugehörige Dokumentation”