Wydawanie nowej wersji

Lista kroków koniecznych do wykonania podczas wydawania frameworka urosła znacznie w ciągu ostatnich lat i stała się uciążliwa do utrzymywania ręcznego, zatem stworzyliśmy narzędzie dostępne z linii komend, aby upewnić się, że żaden z kroków nie zostanie pominięty.

Omówienie kroków wydania

• ...

Komenda wydania

Poniższe kroki są zautomatyzowane za pomocą konsolowej komendy wydania, która jest dostępna w deweloperskim repozytorium frameworka.

Komenda wydania może być uruchomiona za pomocą aplikacji Yii w folderze build frameworka:

./build/build help release  # uruchom w fodlerze głównym frameworka

Info: Możesz uruchomić komendę z opcją --dryRun, aby zobaczyć co może zrobić. Używając tej opcji, nie zostanie wykonana żadna zmiana, a modyfikacje plików i tagi nie będą tworzone i wysyłane.

Wymagania

Działanie komenda wydania uzależnione jest od środowiska deweloperskiego opisanego w Cyklu produkcyjnym Git, przykładowo szablony aplikacji muszą znajdować się w folderze /apps/ a rozszerzenia w /extensions/. Struktury te najlepiej utworzyć za pomocą komend dev/app i dev/ext.

Przykładowa instalacja rozszerzenia:

./build/build dev/ext authclient

lub szablonu:

./build/build dev/app basic

Taka instalacja zapewni użycie tego samego kodu repozytorium dla rozszerzenia, jaki znajduje się w aktualnej wersji repozytorium.

Informacje o wersji

Aby sprawdzić informacje dotyczące wersji frameworka i rozszerzeń, możesz uruchomić

./build/build release/info

Możesz uruchomić powyższą komendę z --update, aby pobrać listę tagów dla wszystkich repozytoriów w celu uzyskania najnowszych informacji.

Tworzenie wydania

Tworzenie wydania frameworka zawiera poniższe komendy (szablony aplikacji są zawsze wydawane razem z frameworkiem):

./build release framework
./build release app-basic
./build release app-advanced

Tworzenie wydania rozszerzenia zawiera tylko jedną komendę (np. dla redis):

./build release redis

Domyślnie komenda wydania wydaje nową pomniejszą wersję w aktualnej gałęzi. Aby wydać inną wersję niż domyślna, należy określić ją bezpośrednio używając opcji --version, np. --version=2.1.0 lub --version=2.1.0-beta.

Wydanie nowej głównej wersji np. 2.1.0

Wydawanie nowej głownej wersji obejmuje zmianę gałęzi, jak to opisano w polityce wersjonowania. Poniższy przykład opisuje wydanie wersji 2.1.0, stworzonej w gałęzi 2.1 pochodzącej z master. master zawiera już wcześniej wersje 2.0.x.

• stwórz nową gałąź 2.0 z master,
• upewnij się, że composer.json nie zawiera już aliasu dla tej gałęzi,
• scal potrzebne zmiany z master do 2.1,
• ustaw master na wskazywanie ostatniego wprowadzenia zmian w 2.1,
• ustaw alias gałęzi w composer.json dla master na 2.1.x-dev,
• skasuj gałąź 2.1.

Teraz pobierz master i uruchom komendę wydania z opcją --version=2.1.0.