Versionen und Kanäle

Die Veröffentlichung eines Pakets erzeugt eine Version: eine Momentaufnahme seines Namens, seiner Zusammenfassung und seines Inhalts zu diesem Zeitpunkt, mit Datum, den Plattformen, auf denen sie läuft, und einem optionalen Änderungsprotokoll. Eine veröffentlichte Version ändert sich nie; die Bearbeitung des Pakets bereitet die nächste vor.

Zwei Kanäle

Kanal	Nummer	Beispiel	Für
Stabil	MAJOR.MINOR.PATCH	1.2.0	Alle Plattformen: das Update, das ihnen angeboten wird.
Entwicklung	MAJOR.MINOR.PATCH-dev.N	1.3.0-dev.2	Tests: eine Vorabversion der nächsten stabilen Version.

Entwicklungsversionen sind immer abgesetzt gekennzeichnet: ein orangefarbenes Abzeichen, eine eigene Karte In Entwicklung und eine eigene Schaltfläche Entwicklungsversion herunterladen auf der Paketseite.

Die Nummer wählen

Sie geben nie eine Versionsnummer ein: Sie wählen einen Schritt, und das Fenster zeigt die Nummer, die sich daraus ergibt (Veröffentlicht Version 1.1.0.).

Stabil: Der Schritt gilt für die höchste stabile Version.

Schritt	Wann	Von 1.2.3
Patch	Korrekturen: ein Tippfehler in einer Beschreibung, eine korrigierte Skriptzeile	1.2.4
Minor	Ergänzungen: neue Modelle, ein neues Profil	1.3.0
Major	Inkompatible Änderungen: Elemente entfernt oder neu geordnet	2.0.0

Die allererste stabile Version ist Major 1.0.0 oder Erste Entwicklung 0.1.0, wenn das Paket noch nicht produktionsreif ist.

Entwicklung: Der Schritt bezeichnet die stabile Version, auf die Sie hinarbeiten, und die Nummer ist dieses Ziel, gefolgt von -dev.N, wobei N für dieses Ziel hochzählt.

Beispielabfolge

Aktion	Version
Erste Veröffentlichung, Stabil, Major	1.0.0
Neues Modell hinzugefügt, Entwicklung, Minor	1.1.0-dev.1
Skript korrigiert, Entwicklung, Minor	1.1.0-dev.2
Bereit für alle, Stabil, Minor	1.1.0
Tippfehler korrigiert, Stabil, Patch	1.1.1
Profile neu geordnet, Entwicklung, Major	2.0.0-dev.1

Versionen werden wie bei Semantic Versioning geordnet: Eine Entwicklungsversion kommt vor der stabilen Version, zu der sie führt, 1.0.0 < 1.1.0-dev.1 < 1.1.0-dev.2 < 1.1.0.

Neueste Version und Entwicklungsversion

• Die neueste Version eines Pakets (Abzeichen Neueste) ist seine höchste stabile Version.
• Seine Entwicklungsversion ist seine höchste Entwicklungsversion, sofern sie über der neuesten liegt. Sobald Sie 1.1.0 veröffentlichen, wird 1.1.0-dev.2 nicht mehr als Entwicklungsversion angezeigt.

Der Kopf des Editors zeigt beide, und Unveröffentlichte Änderungen, wenn sich der Inhalt von ihnen unterscheidet.

Wann ein Kanal veröffentlicht werden kann

• Stabil kann veröffentlicht werden, wenn sich Name, Zusammenfassung oder Inhalt seit der höchsten stabilen Version geändert haben (auch wenn eine Entwicklungsversion bereits denselben Inhalt trägt).
• Entwicklung kann veröffentlicht werden, wenn sich seit der letzten Version eines beliebigen Kanals etwas geändert hat.

Ein Kanal ohne etwas zu veröffentlichen kann nicht gewählt werden (Seit der letzten Version dieses Kanals hat sich nichts geändert.). Wenn keiner veröffentlicht werden kann, zeigt die Seite Versionen Seit der letzten Version hat sich nichts geändert.

Was Plattformen mit Versionen tun

• Eine Plattform installiert ein Paket und hält es mit seinen stabilen Versionen aktuell.
• Entwicklungsversionen sind für Testplattformen gedacht: Installieren Sie sie gezielt, indem Sie die Entwicklungsdatei herunterladen oder sie auf einer verbundenen Plattform wählen. Siehe Versionen und der Dev-Kanal im Plattform-Handbuch.
• Jedes Element des Inhalts behält seine Identität von einer Version zur nächsten, sodass ein Update die Elemente ändert, die die Plattform bereits hat, statt sie zu duplizieren, und die Elemente entfernt, die Sie entfernt haben.
• Die Installation einer niedrigeren als der installierten Version ist ein Downgrade: Die Plattform fragt nach, bevor sie zurückgeht.