Publikowanie w npm
Wersjonować i publikować bibliotekę
Publikowanie w npm to bezpłatna lekcja Angular Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Angular Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Angular Academy zawiera 4 lekcji w sumie.
Udostępnianie biblioteki światu
Po zbudowaniu w formacie Angular Package Format bibliotekę publikuje się w rejestrze, zwykle npm, aby dowolny projekt mógł zainstalować ją za pomocą npm install. Ta lekcja omawia wersjonowanie i proces publikacji.
Publikuj wynik dist, nie kod źródłowy
Publikowany jest zbudowany pakiet z folderu dist/<lib>, zawierający wygenerowany package.json i skompilowane pakiety, a nie surowy projekt źródłowy. To etap budowania sprawia, że pakiet nadaje się do użycia.
ng build ui-kit --configuration production
cd dist/ui-kitWersjonowanie semantyczne
Pakiety npm korzystają z semver: MAJOR.MINOR.PATCH. Zwiększ PATCH dla poprawek, MINOR dla funkcji zachowujących zgodność wsteczną, a MAJOR dla zmian łamiących zgodność. Dzięki temu odbiorcy mogą bezpiecznie przeprowadzać aktualizacje.
0.0.1 -> 0.1.0 # new feature, no breaks (minor)
0.1.0 -> 0.1.1 # bug fix (patch)
0.1.1 -> 1.0.0 # breaking change (major)Ustawianie wersji
Wersja pochodzi z własnego pliku package.json biblioteki. Zaktualizuj ją przed budowaniem albo użyj npm version, aby zwiększyć ją w spójny sposób.
# inside projects/ui-kit (or use the field directly)
npm version minor # bumps and tags the versionLogowanie do npm
Przed publikacją uwierzytelnij się w rejestrze. Polecenie npm login zapisuje token, dzięki czemu polecenie publikacji jest autoryzowane.
npm login
# enter username, password / token, emailPublikowanie
W katalogu zbudowanego pakietu uruchom npm publish. npm prześle pakiet i umożliwi instalowanie go na podstawie nazwy i wersji.
cd dist/ui-kit
npm publishPakiety o określonym zakresie
Pakiety organizacji używają zakresu, na przykład @myorg/ui-kit. Pakiety o określonym zakresie są domyślnie prywatne w npm; aby opublikować je publicznie, przekaż opcję --access public.
npm publish --access publicInstalowanie opublikowanej biblioteki
Odbiorcy dodają ją następnie jak każdą zależność i importują elementy z jej publicznego API. Angular odnajduje pakiet FESM i typy za pomocą wygenerowanego pliku package.json.
npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';Wersje przedpremierowe i tagi
Niestabilne kompilacje publikuj pod tagiem dystrybucyjnym, takim jak next, aby nie stały się domyślną wersją latest. Odbiorcy włączają je jawnie.
npm publish --tag next
npm install ui-kit@nextPrywatne rejestry
W przypadku bibliotek przeznaczonych wyłącznie do użytku wewnętrznego publikuj je w prywatnym rejestrze (prywatne pakiety npm, GitHub Packages lub Verdaccio), konfigurując plik .npmrc. Proces publikacji pozostaje taki sam; różnią się tylko adres rejestru i uwierzytelnianie.
Automatyzacja w CI
Doświadczone zespoły publikują z CI przy wydaniu oznaczonym tagiem: potok buduje bibliotekę, uruchamia testy i wykonuje npm publish z użyciem zapisanego tokenu. Eliminuje to błędy ręczne i zapewnia możliwość powiązania wersji z konkretnymi commitami.
Szybkie sprawdzenie
Co publikujesz w npm?
Podsumowanie
Publikuj zbudowany wynik dist/<lib>, wersjonowany za pomocą semver. Zwiększ wersję, wykonaj npm login, a następnie npm publish (dodaj --access public dla pakietów o określonym zakresie i --tag next dla wersji przedpremierowych). Odbiorcy wykonują npm install i importują elementy z publicznego API. Dla niezawodności automatyzuj publikowanie w CI.
Często zadawane pytania
Czy lekcja „Publikowanie w npm” jest bezpłatna?
Tak — pełny tekst „Publikowanie w npm” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Angular Academy, przejdź na CoddyKit PRO. Kurs Angular Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Publikowanie w npm”?
Wersjonować i publikować bibliotekę Ćwiczysz Angular Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Angular Academy?
Nie wymagamy żadnego doświadczenia. Angular Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Publikowanie w npm”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Angular Academy?
Tak. Każda lekcja Angular Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Tworzenie biblioteki za pomocą ng generate
- Publiczne API i punkty wejścia
- Budowanie za pomocą ng-packagr
- Publikowanie w npm