Crear una biblioteca con ng generate

Cuando varias aplicaciones necesitan los mismos componentes, servicios o utilidades, puede empaquetarlos como una biblioteca de Angular. Una biblioteca es reutilizable, versionada y publicable, en lugar de tener que copiar y pegar código entre proyectos.

Las bibliotecas viven dentro de un workspace de Angular: una carpeta administrada por un único angular.json que puede contener varias aplicaciones y bibliotecas. Puede añadir una biblioteca a un workspace existente o crear uno dedicado.

El schematic ng generate library (alias ng g lib) crea la estructura inicial de un nuevo proyecto de biblioteca dentro de projects/.

La biblioteca incluye su propia carpeta src/lib, un barrel public-api.ts, un archivo ng-package.json (para la compilación) y una entrada en angular.json. Es un proyecto independiente que se puede compilar.

Genere código en la biblioteca indicando el proyecto con --project. La CLI coloca los archivos en la carpeta correcta.

Las bibliotecas modernas prefieren componentes standalone, que los consumidores importan directamente sin un NgModule. Marque el componente con standalone: true para que las aplicaciones puedan usarlo con una simple importación.

Cada biblioteca tiene su propio package.json, donde se definen su nombre, versión y dependencias peer, como @angular/core. Las dependencias peer indican que la aplicación consumidora proporciona Angular, lo que evita copias duplicadas.

Mantenga una aplicación de demostración en el mismo workspace para probar la biblioteca mientras la desarrolla. Importar mediante el nombre de la biblioteca se resuelve en el código fuente local gracias a las asignaciones de rutas de TypeScript en tsconfig.

Una aplicación está destinada a desplegarse; una biblioteca, a ser consumida. Las bibliotecas no se pueden servir directamente: se compilan en un paquete distribuible que se publica o que importan las aplicaciones del workspace.

Una buena biblioteca tiene un propósito claro (por ejemplo, un kit de interfaz de usuario o una capa de acceso a datos). Evite juntar código sin relación; las bibliotecas cohesionadas son más fáciles de versionar, documentar y reutilizar.

Una vez creada la estructura de la biblioteca, queda definir su API pública, compilarla conforme al Angular Package Format y publicarla. Las próximas lecciones cubren cada uno de estos pasos.

¿Cómo se crea una biblioteca?

Las bibliotecas empaquetan código reutilizable para varias aplicaciones. Cree una con ng generate library dentro de un workspace; este comando crea la estructura de src/lib, public-api.ts, ng-package.json y un package.json con dependencias peer. Añada código mediante --project, prefiera componentes standalone y mantenga cada biblioteca enfocada.