diff --git a/docs/internals-pl/release.md b/docs/internals-pl/release.md new file mode 100644 index 0000000000..7de79098c1 --- /dev/null +++ b/docs/internals-pl/release.md @@ -0,0 +1,92 @@ +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](../../build/controllers/ReleaseController.php), która jest +dostępna w deweloperskim repozytorium frameworka. + +Komenda wydania może być uruchomiona za pomocą aplikacji Yii w folderze `build` frameworka: + +```bash +./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](git-workflow.md#extensions), 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: + +```bash +./build/build dev/ext authclient +``` + +lub szablonu: + +```bash +./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ć + +```bash +./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): + +```bash +./build release framework +./build release app-basic +./build release app-advanced +``` + +Tworzenie wydania rozszerzenia zawiera tylko jedną komendę (np. dla `redis`): + +```bash +./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](versions.md). +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`.