Tworzenie i zarządzanie wydaniami

Funkcja Releases w GitHub pomaga pakować i udostępniać użytkownikom stabilne wersje oprogramowania. Można ją traktować jako oficjalne ogłoszenie nowej wersji.

Jest niezbędna w projektach, które muszą dystrybuować skompilowane pliki binarne, dokumentację lub konkretne migawki kodu źródłowego.

Każde wydanie GitHub jest bezpośrednio powiązane z tagiem Git. Tag oznacza konkretny punkt w historii repozytorium, zwykle numer wersji, taki jak v1.0.0.

• Tagi zapewniają trwałe, niezmienne odwołanie do zatwierdzenia.
• Wydania dodają do tego tagu rozbudowane metadane, takie jak informacje o wydaniu i zasoby.

Przed utworzeniem wydania należy upewnić się, że wybrany tag został wypchnięty do GitHub!

Informacje o wydaniu to opisy wyjaśniające, co nowego dodano, ulepszono lub naprawiono w konkretnej wersji. Są niezbędne do komunikowania zmian użytkownikom.

• Używaj jasnego i zwięzłego języka.
• Wyróżniaj najważniejsze funkcje i poprawki błędów.
• Formatowanie Markdown jest obsługiwane i pozwala tworzyć rozbudowany tekst.

Zasoby wydania to pliki, które można dołączyć do wydania, udostępniając je do pobrania. Mogą to być:

• skompilowane pliki binarne (np. .exe, .dmg)
• skompresowany kod źródłowy (.zip, .tar.gz)
• pliki dokumentacji lub instalatory

Zapewniają one w jednym miejscu wszystko, czego użytkownicy potrzebują dla danej wersji.

Aby utworzyć wydanie:

1. Przejdź do repozytorium w GitHub.
2. Kliknij 'Releases' (zwykle znajduje się na prawym pasku bocznym lub na karcie 'Code').
3. Kliknij przycisk 'Draft a new release'.

Otworzy się formularz, w którym określisz szczegóły wydania.

Na stronie tworzenia wydania:

• Wybierzesz istniejący tag Git lub utworzysz nowy.
• Podasz tytuł wydania (np. 'Version 1.0.0 - Initial Release').
• Napiszesz szczegółowe informacje o wydaniu.

Możesz oznaczyć wydanie jako 'pre-release' (do testów) lub od razu je opublikować.

GitHub może pomóc automatycznie wygenerować informacje o wydaniu!

Po kliknięciu 'Generate release notes' GitHub przeanalizuje zatwierdzenia i żądania pull scalone od czasu ostatniego tagu wydania oraz zaproponuje podsumowanie. Następnie możesz je edytować i dopracować.

Po przygotowaniu informacji o wydaniu możesz przesłać zasoby.

Wystarczy przeciągnąć pliki do wyznaczonego obszaru i upuścić je tam albo kliknąć, aby je wyszukać. GitHub prześle pliki, które pojawią się na stronie wydania jako pliki do pobrania.

Pomyłki się zdarzają! Wydanie można zawsze edytować lub usunąć.

• Na stronie 'Releases' znajdź wydanie, które chcesz zmodyfikować.
• Kliknij ikonę ołówka, aby je edytować, albo ikonę kosza, aby je usunąć.

Edycja pozwala zmienić informacje, tytuł lub zasoby. Usunięcie usuwa wydanie z GitHub, ale powiązany tag Git pozostaje.

Które z poniższych elementów są niezbędnymi składnikami lub cechami wydania GitHub?

Dowiedziałeś się, jak tworzyć i zarządzać wydaniami GitHub!

• Wydania zapewniają oficjalne migawki projektu oznaczone numerami wersji.
• Są oparte na tagach Git i zawierają informacje o wydaniu oraz opcjonalne zasoby.
• Wydania można tworzyć, edytować i usuwać za pomocą interfejsu GitHub.

Ułatwia to użytkownikom znajdowanie i pobieranie stabilnych wersji oprogramowania.