Informationen zur Releaseverwaltung
Du kannst neue Releases mit Versionshinweisen, @mentions von Mitwirkenden und Links zu Binärdateien erstellen sowie vorhandene Releases bearbeiten oder löschen. Mit der API für Releases kannst du außerdem Releases erstellen, ändern und löschen. Weitere Informationen findest du unter Releases in der Dokumentation zur REST-API.
Du kannst eine Aktion aus einem bestimmten Release in GitHub Marketplace veröffentlichen. Weitere Informationen findest du unter Veröffentlichen einer Aktion im GitHub Marketplace.
Du kannst auswählen, ob Git Large File Storage (Git LFS)-Objekte in den ZIP-Dateien und Tarballs enthalten sein sollen, die GitHub für jedes Release erstellt. Weitere Informationen findest du unter Verwalten von Git LFS-Objekten in Archiven in deinem Repository.
Einen Release erstellen
-
Navigiere auf GitHub.com zur Hauptseite des Repositorys. 1. Klicke rechts neben der Liste der Dateien auf Releases.
-
Klicke auf Neues Release erstellen.
-
Klicke auf Tag auswählen, gib eine Versionsnummer für deine Veröffentlichung ein, und drücke die EINGABETASTE. Alternativ kannst du ein vorhandenes Tag auswählen.
-
Wenn du ein neues Tag erstellst, klicke auf Neues Tag erstellen.
-
Wenn du ein neues Tag erstellt hast, verwende das Dropdownmenü, um den Branch auszuwählen, der das zu veröffentlichende Projekt enthält.
-
Optional kannst du rechts oben im Feld mit dem Beschreibungstext das Dropdownmenü Vorheriges Tag auswählen und auf das Tag klicken, das das vorherige Release kennzeichnet.
-
Gib einen Titel und eine Beschreibung für deinen Release ein. Wenn du über @mention jemanden in der Beschreibung erwähnst, enthält die veröffentlichte Version einen Abschnitt Mitwirkende mit einer Avatarliste aller erwähnten Benutzer. Alternativ kannst du deine Versionshinweise automatisch generieren, indem du auf Versionshinweise generieren klickst.
-
Um optional binäre Dateien wie kompilierte Programme in deinen Release einzubinden, ziehe die Dateien mit Drag-and-Drop herüber oder wähle die Dateien manuell im Feld für Binärdateien.
-
Um Benutzer*innen darüber zu informieren, dass das Release nicht produktionsbereit und möglicherweise instabil ist, wähle Dies ist eine Vorabversion aus.
-
Optional kannst du Als neueste Version festlegen auswählen. Wenn du diese Option nicht auswählst, wird die neueste Versionsbezeichnung automatisch auf Basis der semantischen Versionierung zugewiesen.
-
Wenn GitHub Discussions in deinem Repository aktiviert sind, kannst du alternativ Erstellen einer Diskussion für dieses Release und dann das Dropdownmenü Kategorie auswählen und auf eine Kategorie für die Releasediskussion klicken.
-
Wenn du dein Release veröffentlichen möchtest, klicke auf Release veröffentlichen. Wenn du später an dem Release arbeiten möchtest, klicke auf Entwurf speichern.
Du kannst die veröffentlichten Releases oder die Entwürfe anschließend im Releasefeed deines Repositorys anzeigen. Weitere Informationen findest du unter Screenshot der Versionen und Tags deines Repositorys.
Weitere Informationen zu GitHub CLI findest du unter Informationen zu GitHub CLI.
-
Verwende den Unterbefehl
gh release create
, um ein Release zu erstellen. Ersetzetag
durch das gewünschte Tag für das Release.gh release create TAG
-
Befolge die interaktiven Eingabeaufforderungen. Du kannst Argumente angeben, um diese Eingabeaufforderungen zu überspringen. Weitere Informationen zu möglichen Argumenten findest du im GitHub CLI-Handbuch. Mit diesem Befehl wird beispielsweise ein Vorabrelease mit dem angegebenen Titel und den entsprechenden Hinweisen erstellt.
gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease
Wenn du @mentionGitHub-Benutzer in den Hinweisen erwähnst, enthält das veröffentlichte Release auf GitHub.com den Abschnitt Mitwirkende, in dem eine Avatarliste aller erwähnten Benutzer enthalten ist.
Einen Release bearbeiten
- Navigiere auf GitHub.com zur Hauptseite des Repositorys. 1. Klicke rechts neben der Liste der Dateien auf Releases.
- Klicke im rechten Abschnitt der Seite neben dem Release, das du bearbeiten möchtest, auf .
- Bearbeite die Details des Releases im Formular, und klicke dann auf Release aktualisieren. Wenn du eine der Erwähnungen (@mentions) der GitHub-Benutzer in der Beschreibung entfernst bzw. hinzufügst, werden diese Benutzer aus der Avatarliste im Abschnitt Mitwirkende des Releases entfernt oder ihr hinzugefügt.
Releases können derzeit nicht mit GitHub CLI bearbeitet werden.
Einen Release löschen
- Navigiere auf GitHub.com zur Hauptseite des Repositorys. 1. Klicke rechts neben der Liste der Dateien auf Releases.
- Klicke im rechten Abschnitt der Seite neben dem Release, das du löschen möchtest, auf .
- Klicke auf Dieses Release löschen.
-
Verwende den Unterbefehl
gh release delete
, um ein Release zu löschen. Ersetzetag
durch das Tag des Releases, das gelöscht werden soll. Verwende das Flag-y
, um das Bestätigen zu überspringen.gh release delete TAG -y