Pubblicare su npm

Una volta compilata nel formato Angular Package Format, una libreria viene pubblicata in un registry, solitamente npm, così qualsiasi progetto può installarla con npm install. Questa lezione tratta il versioning e il flusso di pubblicazione.

Deve pubblicare il pacchetto compilato in dist/<lib>, che contiene il package.json generato e i bundle compilati, mai il progetto con il sorgente grezzo. È il passaggio di build a renderlo utilizzabile.

I pacchetti npm usano semver: MAJOR.MINOR.PATCH. Incrementi PATCH per le correzioni, MINOR per le funzionalità compatibili con le versioni precedenti e MAJOR per le breaking change. I consumer si affidano a questo schema per aggiornare in sicurezza.

La versione proviene dal package.json della libreria. Lo aggiorni prima del build oppure utilizzi npm version per incrementarla in modo coerente.

Si autentichi presso il registry prima della pubblicazione. npm login memorizza un token, così il comando di pubblicazione viene autorizzato.

Dalla cartella del pacchetto compilato, esegua npm publish. npm carica il pacchetto e lo rende installabile tramite nome e versione.

I pacchetti delle organizzazioni usano uno scope come @myorg/ui-kit. Su npm i pacchetti con scope sono privati per impostazione predefinita; passi --access public per pubblicarli come pubblici.

I consumer la aggiungono quindi come una qualsiasi dipendenza e importano dalla sua API pubblica. Angular individua il bundle FESM e i tipi tramite il package.json generato.

Pubblichi le build instabili con un dist-tag come next, così non diventano la versione predefinita latest. I consumer scelgono esplicitamente di utilizzarle.

Per le librerie esclusivamente interne, pubblichi in un registry privato, come i pacchetti privati npm, GitHub Packages o Verdaccio, configurando .npmrc. Il flusso di pubblicazione è lo stesso: cambiano solo l'URL del registry e l'autenticazione.

I team maturi pubblicano dalla CI in occasione di una release contrassegnata: la pipeline compila la libreria, esegue i test ed esegue npm publish con un token memorizzato. Questo evita gli errori manuali e mantiene le versioni riconducibili ai commit.

Che cosa si pubblica su npm?

Pubblichi l'output compilato dist/<lib>, versionato con semver. Incrementi la versione, esegua npm login e poi npm publish (aggiunga --access public per i pacchetti con scope e --tag next per le pre-release). I consumer eseguono npm install e importano dalla public API. Automatizzi la pubblicazione nella CI per garantire l'affidabilità.