Kanały wydań

Text.js jest publikowany pod trzema tagami dystrybucyjnymi npm. Wszystkie pakiety (@textjs/app, @textjs/react, @textjs/core, @textjs/font, @textjs/opencode, create-text-app i eslint-plugin-textjs) są wersjonowane wspólnie, więc jeden numer wersji opisuje cały framework.

#Kanały

Na produkcji używaj kanału stabilnego. Używaj kanału canary, aby wypróbować poprawki i funkcje w dniu, w którym trafią do dev. Gdy powstanie linia LTS, używaj jej, jeśli aktualizujesz raz w roku.

bun create text-app@canary my-console

#Kanał stabilny

Wydania stabilne stosują wersjonowanie semantyczne: wydania patch naprawiają błędy, wydania minor dodają funkcje zgodne wstecz, a wydania major mogą naruszać zgodność API po okresie wycofywania. Wydanie stabilne powstaje przez promowanie wydania canary, które przeszło pełny zestaw testów, i jest publikowane z poświadczeniem pochodzenia npm.

#Canary

Po każdym wypchnięciu zmian do dev w oficjalnym repozytorium kod przechodzi sprawdzanie typów i testy, a następnie jest publikowany jako kolejna wersja patch z przyrostkiem -canary.N:

N kontynuuje numerację od najwyższej wersji canary dostępnej już w npm, więc numery nigdy się nie powtarzają. Wersje canary nie są zapisywane w commitach w repozytorium. Dodaj [skip canary] do komunikatu commita, aby pominąć wydanie.

Wydania canary to kompilacje gałęzi dev, do której scalane są wszystkie pull requesty. Mogą zmieniać lub usuwać niewydane API bez uprzedzenia. Przypnij dokładną wersję canary, jeśli od niej zależysz.

#Poświadczenie pochodzenia

Wydania są publikowane z GitHub Actions poleceniem npm publish --provenance, które wiąże każde archiwum tar z dokładnym commitem i przepływem pracy, który je zbudował. Zweryfikuj pakiet poleceniem:

npm audit signatures

#Przygotowanie wydania

Opiekunowie projektu podnoszą wspólnie wersje wszystkich pakietów obszaru roboczego za pomocą skryptów wydawniczych:

bun run release:version minor   # 1.0.0 → 1.1.0 (also: patch, major, canary, stable, x.y.z)bun run release:publish --tag latest --provenance

release:version nadpisuje każdy plik package.json i odzwierciedlające go stałe wersji (VERSION, rendererVersion reconc ilera), odmawia uruchomienia, gdy wersje pakietów się rozeszły, a --dry-run wypisuje plan. release:publish buduje, pakuje (rozwiązując workspace:*), stosuje publishConfig, odmawia opublikowania wersji wstępnej pod tagiem latest lub wersji stabilnej pod tagiem canary i pomija wersje, które już istnieją w npm.

Sprawdź w polityce wsparcia, jak długo utrzymywana jest każda linia wydań.