Auf npm veröffentlichen
Ihre Bibliothek versionieren und veröffentlichen
Auf npm veröffentlichen ist eine kostenlose Angular Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Angular Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.
Ihre Library mit der Welt teilen
Sobald eine Library in das Angular Package Format gebaut wurde, wird sie in einer Registry, üblicherweise npm, veröffentlicht, sodass jedes Projekt sie mit npm install installieren kann. In dieser Lektion geht es um Versionierung und den Veröffentlichungsprozess.
Die dist-Ausgabe veröffentlichen, nicht den Quellcode
Sie veröffentlichen das gebaute Paket in dist/<lib>. Es enthält die generierte package.json und kompilierte Bundles, niemals das Quellprojekt im Rohformat. Erst der Build macht das Paket nutzbar.
ng build ui-kit --configuration production
cd dist/ui-kitSemantische Versionierung
npm-Pakete verwenden semver: MAJOR.MINOR.PATCH. Erhöhen Sie PATCH für Fehlerbehebungen, MINOR für abwärtskompatible Funktionen und MAJOR für Breaking Changes. Nutzer können sich dadurch beim Aktualisieren auf die Kompatibilität verlassen.
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)Die Version festlegen
Die Version stammt aus der eigenen package.json der Library. Aktualisieren Sie sie vor dem Build oder verwenden Sie npm version, um sie konsistent zu erhöhen.
# inside projects/ui-kit (or use the field directly)
npm version minor # bumps and tags the versionBei npm anmelden
Authentifizieren Sie sich vor der Veröffentlichung bei der Registry. npm login speichert ein Token, damit der Publish-Befehl autorisiert ist.
npm login
# enter username, password / token, emailVeröffentlichen
Führen Sie im Verzeichnis des gebauten Pakets npm publish aus. npm lädt das Paket hoch und macht es unter seinem Namen und seiner Version installierbar.
cd dist/ui-kit
npm publishScoped Packages
Organisationspakete verwenden einen Scope wie @myorg/ui-kit. Scoped Packages sind auf npm standardmäßig privat. Übergeben Sie --access public, um sie öffentlich zu veröffentlichen.
npm publish --access publicDie veröffentlichte Library installieren
Nutzer fügen sie anschließend wie jede andere Abhängigkeit hinzu und importieren aus ihrer öffentlichen API. Angular findet das FESM-Bundle und die Typen über die generierte package.json.
npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';Vorabversionen und Tags
Veröffentlichen Sie instabile Builds unter einem dist-tag wie next, damit sie nicht zur standardmäßigen Version latest werden. Nutzer müssen sie ausdrücklich auswählen.
npm publish --tag next
npm install ui-kit@nextPrivate Registries
Veröffentlichen Sie interne Libraries in einer privaten Registry (private npm-Pakete, GitHub Packages oder Verdaccio), indem Sie .npmrc konfigurieren. Der Veröffentlichungsprozess ist derselbe; nur Registry-URL und Authentifizierung unterscheiden sich.
In CI automatisieren
Erfahrene Teams veröffentlichen bei einem markierten Release aus der CI: Die Pipeline baut die Library, führt Tests aus und führt npm publish mit einem gespeicherten Token aus. So werden manuelle Fehler vermieden und Versionen bleiben auf Commits zurückverfolgbar.
Kurze Überprüfung
Was veröffentlichen Sie auf npm?
Zusammenfassung
Veröffentlichen Sie die gebaute Ausgabe dist/<lib>, versioniert mit semver. Erhöhen Sie die Version, führen Sie npm login und anschließend npm publish aus (verwenden Sie --access public für Scoped Packages und --tag next für Vorabversionen). Nutzer führen npm install aus und importieren aus der öffentlichen API. Automatisieren Sie die Veröffentlichung für zuverlässige Abläufe in der CI.
Häufig gestellte Fragen
Ist die Lektion „Auf npm veröffentlichen“ kostenlos?
Ja — der vollständige Text von „Auf npm veröffentlichen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Angular Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Auf npm veröffentlichen“?
Ihre Bibliothek versionieren und veröffentlichen Du übst Angular Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Angular Academy zu starten?
Keine Vorkenntnisse erforderlich. Angular Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.
Wie lange dauert die Lektion „Auf npm veröffentlichen“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Angular Academy-Lektion Code schreiben und ausführen?
Ja. Jede Angular Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Eine Bibliothek mit ng generate erstellen
- Öffentliche API und Einstiegspunkte
- Mit ng-packagr bauen
- Auf npm veröffentlichen