Releases erstellen und verwalten

Mit der Funktion Releases von GitHub können Sie stabile Versionen Ihrer Software bündeln und Benutzern bereitstellen. Stellen Sie sie sich als offizielle Ankündigung einer neuen Version vor.

Sie ist besonders wichtig für Projekte, die kompilierte Binärdateien, Dokumentation oder bestimmte Snapshots des Quellcodes verteilen müssen.

Jedes GitHub Release ist direkt mit einem Git-Tag verknüpft. Ein Tag markiert einen bestimmten Punkt in der Historie Ihres Repositorys, normalerweise eine Versionsnummer wie v1.0.0.

• Tags bieten eine dauerhafte, unveränderliche Referenz auf einen Commit.
• Releases ergänzen diesen Tag um umfangreiche Metadaten wie Release Notes und Assets.

Vergewissern Sie sich vor dem Erstellen eines Releases, dass Sie den gewünschten Tag zu GitHub gepusht haben!

Release Notes sind Beschreibungen, die erklären, was in einer bestimmten Version neu ist, verbessert oder behoben wurde. Sie sind entscheidend, um Änderungen an Ihre Benutzer zu kommunizieren.

• Verwenden Sie eine klare, prägnante Sprache.
• Heben Sie wichtige Funktionen und Fehlerbehebungen hervor.
• Für formatierte Texte wird Markdown unterstützt.

Release-Assets sind Dateien, die Sie an ein Release anhängen können, damit sie zum Download bereitstehen. Dazu können gehören:

• Kompilierte Binärdateien (z. B. .exe, .dmg)
• Komprimierter Quellcode (.zip, .tar.gz)
• Dokumentationsdateien oder Installationsprogramme

Sie stellen alle benötigten Dateien für die jeweilige Version an einem Ort bereit.

So erstellen Sie ein Release:

1. Rufen Sie Ihr Repository auf GitHub auf.
2. Klicken Sie auf 'Releases' (dieser Eintrag befindet sich häufig in der rechten Seitenleiste oder unter dem Tab 'Code').
3. Klicken Sie auf die Schaltfläche 'Draft a new release'.

Dadurch wird ein Formular geöffnet, in dem Sie die Details Ihres Releases festlegen.

Auf der Seite zum Erstellen eines Releases können Sie:

• einen vorhandenen Git-Tag auswählen oder einen neuen erstellen.
• einen Release-Titel angeben (z. B. 'Version 1.0.0 - Initial Release').
• ausführliche Release Notes verfassen.

Sie können das Release als 'pre-release' (zum Testen) kennzeichnen oder direkt veröffentlichen.

GitHub kann Sie dabei unterstützen, Release Notes automatisch zu erstellen!

Wenn Sie auf 'Generate release notes' klicken, durchsucht GitHub die Commits und zusammengeführten Pull Requests seit dem letzten Release-Tag und schlägt eine Zusammenfassung vor. Diese können Sie anschließend bearbeiten und verfeinern.

Sobald Ihre Release Notes fertig sind, können Sie Assets hochladen.

Ziehen Sie die Dateien einfach in den vorgesehenen Bereich und legen Sie sie dort ab, oder klicken Sie darauf, um Dateien auszuwählen. GitHub lädt sie hoch, und sie erscheinen auf Ihrer Release-Seite als herunterladbare Dateien.

Fehler passieren! Sie können ein Release jederzeit bearbeiten oder löschen.

• Suchen Sie auf der Seite 'Releases' das Release, das Sie ändern möchten.
• Klicken Sie zum Bearbeiten auf das Bleistiftsymbol oder zum Löschen auf das Papierkorbsymbol.

Beim Bearbeiten können Sie Notes, Titel oder Assets ändern. Beim Löschen wird das Release aus GitHub entfernt, der zugrunde liegende Git-Tag bleibt jedoch bestehen.

Welche der folgenden Elemente oder Eigenschaften sind wesentliche Bestandteile eines GitHub Releases?

Sie haben gelernt, wie Sie GitHub Releases erstellen und verwalten!

• Releases stellen formelle, versionierte Snapshots Ihres Projekts bereit.
• Sie basieren auf Git-Tags und enthalten Release Notes sowie optionale Assets.
• Sie können Releases über die GitHub-Benutzeroberfläche erstellen, bearbeiten und löschen.

So können Benutzer stabile Versionen Ihrer Software einfach finden und herunterladen.