Zum Inhalt springen

Aktualisiere Astro

Diese Anleitung erklärt, wie du deine Astro-Version und zugehörige Abhängigkeiten aktualisieren kannst, wo du von Neuerungen von einer Version zur Nächsten erfährst und wie du Astros Versionierungs­system und zugehörige Aktualisierungen der Dokumentation aufgebaut sind.

Was hat sich geändert?

Abschnitt betitelt „Was hat sich geändert?“

Der neueste Release von Astro ist v5.17.2.

Eine vollständige Liste aller Änderungen findest du in Astros Changelog und wichtige Anweisungen für Aktualisierungen auf jede neue Major-Version in unseren Aktualisierungs­anleitungen.

Aktualisierung auf die neueste Version

Abschnitt betitelt „Aktualisierung auf die neueste Version“

Aktualisiere Astro und alle offiziellen Integrationen in deinem Projekt mit einem Paketmanager-Befehl auf die neuesten Versionen:

Terminal-Fenster
# Aktualisiere Astro und offizielle Integrationen gemeinsam
npx @astrojs/upgrade

Manuelle Aktualisierung

Abschnitt betitelt „Manuelle Aktualisierung“

Nutze den passenden Befehl deines Paketmanagers, um Astro und Integrationen manuell auf ihre neuesten Versionen zu aktualisieren.

Terminal-Fenster
# Beispiel: Aktualisiere Astro mit React- und Partytown-Integrationen
npm install astro@latest @astrojs/react@latest @astrojs/partytown@latest

Installiere eine spezifische Versionsnummer

Abschnitt betitelt „Installiere eine spezifische Versionsnummer“

Nutze den entsprechenden Befehl deines Paketmanagers, um eine spezifische Version von Astro oder Integrationen zu installieren.

Terminal-Fenster
npm install astro@4.5.3 @astrojs/react@3.0.10

Aktualisierungen der Dokumentation

Abschnitt betitelt „Aktualisierungen der Dokumentation“

Diese Dokumentation wird für jeden Minor-Release und Major-Version-Release aktualisiert. Wenn neue Features hinzugefügt werden oder sich die existierende Nutzung ändert, wird die Dokumentation aktualisiert, um das aktuelle Verhalten von Astro zu reflektieren. Wird dein Projekt nicht aktualisiert, kann es vorkommen, dass sich das Framework anders verhält, als in der aktuellen Dokumentation beschrieben.

Neue Features werden der Dokumentation mit der spezifischen Versionsnummer hinzugefügt, in der sie eingeführt wurden. Das bedeutet, dass manche dokumentierten Features möglicherweise nicht verfügbar sind, wenn du nicht auf den aktuellsten Release von Astro aktualisierst. Prüfe stets die Versionsnummer des Features, welches meist mittels „Hinzugefügt in“ angegeben ist, und stelle sicher, dass dein Projekt aktualisiert wurde, bevor du versuchst neue Features zu nutzen!

Wenn du nicht auf die neueste Major-Version von Astro aktualisiert hast, begegnen dir u. U. signifikante Unterschiede zwischen Astros Dokumentation und dem Verhalten deines Projekts. Wir empfehlen dir dringend, so bald wie möglich auf die neueste Major-Version von Astro zu aktualisieren. Sowohl Code als auch Dokumentation für frühere Versionen sind nicht unterstützt.

Aktualisierungs­anleitungen

Abschnitt betitelt „Aktualisierungs­anleitungen“

Nach jedem Major-Versions-Release findest du eine Aktualisierungs­anleitung mit Informationen zu wichtigen Änderungen und Anweisungen für die Aktualisierung des Codes deines Projekts.

Die wichtigsten Astro-Dokumentations­seiten entsprechen immer der aktuellen releasten Version von Astro. Sie beschreiben oder vergleichen weder wie Dinge in früheren Versionen funktioniert haben, noch heben sie aktualisiertes oder verändertes Verhalten hervor.

In den folgenden Aktualisierungs­anleitungen findest du Erläuterungen zu den Änderungen, die die jeweils neue Version mit der alten vergleichen. Die Aktualisierungs­anleitungen enthalten alles, was eine Anpassung deines Codes erfordern könnte: Inkompatible Änderungen, nicht mehr zur Nutzung empfohlene, entfernte oder ersetzte Features sowie aktualisierte Nutzungshinweise. Jede Änderung Astros beinhaltet einen „Was sollte ich tun?“-Abschnitt, um dir bei der erfolgreichen Aktualisierung des Codes deines Projekts zu helfen.

Ältere Dokumentation (nicht gewartet)

Abschnitt betitelt „Ältere Dokumentation (nicht gewartet)“

Dokumentation für ältere Versionen von Astro wird nicht gewartet, ist aber als statischer Snapshot verfügbar. Nutze diese Versionen der Dokumentation, falls du nicht in der Lage bist, dein Projekt zu aktualisieren, aber dennoch Anleitungen und Referenzen konsultieren möchtest:

Semantische Versionierung

Abschnitt betitelt „Semantische Versionierung“

Astro orientiert sich so weit wie möglich an der semantischen Versionierung - einem Regelwerk, nach dem Entwickler Versionsnummern für Releases vergeben. Semantische Versionen folgen einem vorhersagbaren Muster, um Nutzer über die Art der Änderungen zu informieren, die sie von einer Version zur nächsten erwarten können.

Semantische Versionierung setzt ein Muster X.Y.Z für Software-Versionsnummern durch. Diese Werte repräsentieren Major- (X), Minor- (Y) und Patch-Aktualisierungen (Z).

Patch-Änderungen

Abschnitt betitelt „Patch-Änderungen“

Patch-Änderungen sind die am wenigsten disruptiven Änderungen. Sie ändern nichts an der Weise, wie du Astro nutzt, und erfordern keine Änderungen deines eigenen Codes, wenn du ein Update durchführst.

Wenn Astro eine Patch-Version veröffentlicht, erhöht sich die letzte Nummer. (z. B. astro@4.3.14 → astro@4.3.15)

Patches können aus Gründen wie den Folgenden veröffentlicht werden:

  • Interne Änderungen, die die Funktionalität von Astro nicht ändern:
    • Refaktorisierungen
    • Leistungs­verbesserungen
    • Erhöhung oder Änderung der Testabdeckung
    • Anpassung an bestehende Dokumentation und erwartetes Verhalten
  • Verbesserungen von Logging und Fehlermeldungen
  • Erneute Releases nach einem fehlgeschlagenen Release

Patch-Änderungen beinhalten außerdem die meisten Fehlerbehebungen, selbst wenn Nutzer bisher von unbeabsichtigten oder unerwünschten Verhaltensweisen profitiert haben.

Minor-Änderungen

Abschnitt betitelt „Minor-Änderungen“

Minor-Releases enthalten in erster Linie neue Features und Verbesserungen, die du evtl. ausprobieren möchtest, erfordern aber keine Änderungen deines Codes. In einem Minor-Release kann außerdem von der weiteren Nutzung einiger Features abgeraten werden (da sie für Entfernung in einer zukünftigen Version vorgemerkt sind, aber bis dahin weiterhin funktionieren), was dir die Möglichkeit gibt, dich auf ihre spätere Entfernung vorzubereiten.

Minor-Releases können Änderungen wie die Folgenden enthalten:

  • Ankündigung der Entfernung existierender Features/Optionen in einem zukünftigen Major-Release.
  • Einführung neuer Funktionen.
  • Einführung neuer Optionen in den Integrations-Hooks.
  • Einführung neuer Funktionen in astro/app, insbesondere für die Erstellung neuer Adapter.

Ein Minor-Release kann außerdem gleichzeitig kleinere Patch-Änderungen enthalten.

Major-Änderungen

Abschnitt betitelt „Major-Änderungen“

Major-Releases enthalten inkompatible Änderungen für zumindest einen Teil des bestehenden Codes. Diese Änderungen sind in Astro immer in einer „Aktualisiere auf vX“-Anleitung dokumentiert.

In Major-Releases kann Astro nicht nur die interne Logik, sondern auch das beabsichtigte Verhalten und die Verwendung ziemlich stark verändern. Die Dokumentation wird aktualisiert, um ausschließlich die neueste Version zu reflektieren, und statische, nicht gewartete Snapshots älterer Dokumentationen sind als historische Aufzeichnungen für ältere, nicht bereits aktualisierte Projekte verfügbar.

Major-Releases enthalten Änderungen wie die Folgenden:

  • Entfernung zuvor abgekündigter Funktionen.
  • Änderungen bestehender Funktionen.
  • Änderungen bestehender Optionen in den Integrations-Hooks.
  • Änderungen bestehender Optionen und Funktionen in astro/app, insbesondere für die Erstellung neuer Adapter.

Ein Major-Release kann außerdem einige kompatible Änderungen und Verbesserungen enthalten, die normalerweise separiert in einem Minor- oder Patch-Release veröffentlicht werden würden.

Ausnahmen

Abschnitt betitelt „Ausnahmen“

  • Experimentelle Features. Die Veröffentlichung von Astro-Versionen ohne Einhaltung von semantischer Versionierung ermöglicht den Entwicklern von Astro größtmögliche Flexibilität bei der Erkundung und sogar radikalen Kursänderung während der Entwicklung experimenteller Features. Deren Verhalten kann sich deshalb durch Minor- und Patch-Änderungen gravierend ändern.

    Diese Features werden in der Regel von einer laufenden, öffentlichen Request for Consideration (RFC) stage 3 begleitet. Von Beta-Nutzern wird erwartet, dass sie Aktualisierungen verfolgen und frühzeitig Rückmeldung in der Diskussion geben, um bei der Entwicklung dieser Features zu helfen.

    Sind diese Feature einmal aus ihrer experimentellen Phase heraus, folgen sie den normalen Regeln semantischer Versionierung.

  • Verbesserungen der Dokumentation (z. B. Referenzen und Fehlermeldungen). Diese werden aus dem Quellcode für das docs Repository erzeugt. Dadurch kann Astro schnell Korrekturen und Verbesserungen an der Dokumentation vornehmen, wenn sich der Inhalt der Dokumentation im Haupt-Repository astro befindet.

Unterstützung von Node.js und Aktualisierungs­richtlinien

Abschnitt betitelt „Unterstützung von Node.js und Aktualisierungs­richtlinien“

Unterstützung

Abschnitt betitelt „Unterstützung“

Aktualisierung

Abschnitt betitelt „Aktualisierung“

Die folgenden Regeln definieren, wann Astro die Unterstützung für Versionen von Node.js nicht mehr empfiehlt bzw. beenden oder aufnehmen kann:

  • Die Nutzung ungerader Node.js-Versionen wird gegebenenfalls nicht mehr empfohlen oder deren Unterstützung eingestellt, sobald die nächste gerade Version von Node.js erscheint. Diese Änderung kann in einem Minor-Release von Astro nach einer vom Astro-Core-Team beschlossenen, angemessen verlängerten Supportperiode geschehen.
  • Eine Aktualisierung der niedrigsten Maintenance LTS-Version (innerhalb des selben Major-Bereichs, z. B. von v18.14.* auf v18.20.*) von Node.js kann in einem Minor-Release von Astro geschehen.
    • Sicherheitsausnahme: Wird eine Sicherheitslücke in Node.js bekanntgegeben und geschlossen, die Astro betrifft, kann das Core-Team die niedrigste Maintenance LTS-Version in einem Patch-Release anheben.
  • Eine Aktualisierung der Minor- oder Major-Versionen von Node.js (nicht Maintenance LTS) geschieht ausschließlich in Major-Versionen von Astro.
    • Sicherheitsausnahme: Wird eine Sicherheitslücke in Node.js bekanntgegeben und geschlossen, die Astro betrifft, kann das Core-Team die niedrigste Version in einem Minor-Release anheben.

Verlängerte Wartung

Abschnitt betitelt „Verlängerte Wartung“

Das Core-Team stellt verlängerte Wartung für die letzte vorhergehende Major-Version ausschließlich für Sicherheits­aktualisierungen bereit. Das bedeutet, dass für eine aktuelle Major-Version v4.* Sicherheits­aktualisierungen durch das Core-Team zurückportiert und ein neuer Release v3.* veröffentlicht wird.

Wirke mit Community Sponsor