3.2 KiB
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
zmaster
, - upewnij się, że composer.json nie zawiera już aliasu dla tej gałęzi,
- scal potrzebne zmiany z
master
do2.1
, - ustaw
master
na wskazywanie ostatniego wprowadzenia zmian w2.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
.