Créer une bibliothèque avec ng generate

Lorsque plusieurs applications ont besoin des mêmes composants, services ou utilitaires, vous les regroupez dans une bibliothèque Angular. Une bibliothèque est réutilisable, versionnée et publiable, au lieu de copier-coller le code entre les projets.

Les bibliothèques résident dans un espace de travail Angular : un dossier géré par un seul angular.json, qui peut contenir plusieurs applications et bibliothèques. Vous pouvez ajouter une bibliothèque à un espace de travail existant ou en créer un dédié.

Le schéma ng generate library (alias ng g lib) crée la structure d’un nouveau projet de bibliothèque sous projects/.

La bibliothèque est fournie avec son propre dossier src/lib, un fichier d’agrégation public-api.ts, un fichier ng-package.json (pour la compilation) et une entrée dans angular.json. Il s’agit d’un projet autonome qui peut être compilé.

Générez du code dans la bibliothèque en la ciblant avec --project. La CLI place les fichiers dans le bon dossier.

Les bibliothèques modernes privilégient les composants autonomes, que les utilisateurs importent directement sans NgModule. Marquez le composant avec standalone: true afin que les applications puissent l’utiliser avec un simple import.

Chaque bibliothèque possède son propre package.json, qui définit son nom, sa version et ses dépendances entre pairs, comme @angular/core. Les dépendances entre pairs signifient que l’application utilisatrice fournit Angular, ce qui évite les copies en double.

Conservez une application de démonstration dans le même espace de travail afin de tester la bibliothèque pendant sa construction. L’import par le nom de la bibliothèque est résolu vers le code source local grâce aux correspondances de chemins TypeScript dans tsconfig.

Une application est destinée à être déployée ; une bibliothèque est destinée à être utilisée. Les bibliothèques ne peuvent pas être servies directement : elles sont compilées dans un paquet distribuable, puis publiées ou importées par les applications de l’espace de travail.

Une bonne bibliothèque a un objectif clair (une bibliothèque d’interface utilisateur, une couche d’accès aux données). Évitez de regrouper du code sans rapport : les bibliothèques cohérentes sont plus faciles à versionner, documenter et réutiliser.

Une fois la structure de la bibliothèque créée, il reste à définir son API publique, à la compiler au format Angular Package Format et à la publier. Les prochaines leçons abordent chacun de ces points.

Comment créez-vous une bibliothèque ?

Les bibliothèques regroupent du code réutilisable pour plusieurs applications. Créez-en une avec ng generate library dans un espace de travail : cette commande crée src/lib, public-api.ts, ng-package.json et un package.json contenant les dépendances entre pairs. Ajoutez du code via --project, privilégiez les composants autonomes et gardez chaque bibliothèque ciblée.