Creare una libreria con ng generate

Quando più app hanno bisogno degli stessi componenti, servizi o strumenti, può racchiuderli in una libreria Angular. Una libreria è riutilizzabile, versionata e pubblicabile, invece di copiare e incollare il codice tra i progetti.

Le librerie risiedono all'interno di un workspace Angular: una cartella gestita da un unico angular.json che può contenere più app e librerie. Può aggiungere una libreria a un workspace esistente oppure crearne uno dedicato.

Lo schematic ng generate library (alias ng g lib) crea lo scheletro di un nuovo progetto di libreria all'interno di projects/.

La libreria include una propria cartella src/lib, un barrel public-api.ts, un ng-package.json (per il build) e una voce in angular.json. È un progetto autonomo e compilabile.

Generi il codice nella libreria indicandola con --project. La CLI inserisce i file nella cartella corretta.

Le librerie moderne preferiscono i componenti standalone, che i consumer importano direttamente senza un NgModule. Imposti standalone: true sul componente, così le app possono usarlo con un semplice import.

Ogni libreria ha il proprio package.json, che definisce nome, versione e peer dependencies come @angular/core. Le peer dependencies indicano che è l'app consumer a fornire Angular, evitando copie duplicate.

Mantenga un'app dimostrativa nello stesso workspace per provare la libreria mentre la sviluppa. L'import tramite il nome della libreria viene risolto nel codice sorgente locale attraverso i mapping dei percorsi TypeScript in tsconfig.

Un'applicazione è destinata al deployment; una libreria è destinata a essere utilizzata. Le librerie non possono essere servite direttamente: vengono trasformate in un pacchetto distribuibile e poi pubblicate oppure importate dalle app del workspace.

Una buona libreria ha uno scopo chiaro, come un kit UI o un livello di accesso ai dati. Eviti di inserire insieme codice non correlato: le librerie coerenti sono più facili da versionare, documentare e riutilizzare.

Una volta creato lo scheletro della libreria, resta da definire la sua API pubblica, compilarla nel formato Angular Package Format e pubblicarla. Le prossime lezioni trattano ciascuno di questi aspetti.

Come si crea una libreria?

Le librerie racchiudono codice riutilizzabile per molte app. Ne crei una con ng generate library all'interno di un workspace: il comando crea lo scheletro di src/lib, public-api.ts, ng-package.json e un package.json con le peer dependencies. Aggiunga il codice tramite --project, preferisca i componenti standalone e mantenga ogni libreria focalizzata.