Crear builds con ng-packagr

No puede publicar TypeScript ni plantillas sin compilar; los consumidores esperan un resultado compilado y estandarizado. Las bibliotecas de Angular se compilan conforme al Angular Package Format (APF) mediante ng-packagr, la herramienta que la CLI utiliza internamente.

APF es la estructura oficial para las bibliotecas de Angular distribuibles: módulos ES optimizados, definiciones de tipos y metadatos organizados para que cualquier aplicación de Angular pueda consumir la biblioteca y aplicar tree-shaking de forma fiable.

Ejecute ng build indicando como destino el proyecto de la biblioteca. La CLI invoca ng-packagr y escribe el resultado empaquetado en dist/.

La carpeta dist contiene bundles FESM (módulo ES aplanado) compilados, archivos de tipos .d.ts y un package.json generado con los campos de entrada correctos para module y types.

Cada biblioteca tiene un ng-package.json que indica a ng-packagr el destino de salida y el archivo de entrada. La CLI lo lee durante la compilación.

Compile con la configuración de producción para activar la optimización completa. El resultado es lo que publicará, así que empaquete siempre la versión optimizada.

Las bibliotecas se compilan en modo Ivy partial, no completamente. Esto las hace compatibles entre distintas versiones de Angular; la aplicación consumidora finaliza la compilación (el enlazado) durante su propia compilación.

ng-packagr mantiene Angular y otras dependencias peer como externas en lugar de incluirlas en el bundle. El package.json generado las enumera como peerDependencies, de modo que el consumidor proporciona una única copia compartida.

Puede incluir estilos y recursos estáticos en el paquete. Declárelos en ng-package.json para que ng-packagr los copie y procese en el resultado de dist para los consumidores.

Después de compilar, inspeccione dist/ui-kit: confirme el bundle FESM, los archivos .d.ts y un package.json cuyos campos exports/module apunten a los archivos compilados. Esto es exactamente lo que recibirá npm.

Vuelva a compilar automáticamente mientras edita añadiendo --watch. Combinado con una aplicación de demostración, esto proporciona un ciclo de retroalimentación rápido durante el desarrollo de la biblioteca.

¿A qué formato se compilan las bibliotecas de Angular?

Compile las bibliotecas con ng build <lib>, que ejecuta ng-packagr para generar el Angular Package Format (bundles FESM, .d.ts y package.json generado) en dist/. Configure la salida mediante ng-package.json, compile en producción, aproveche la compilación parcial para mantener la compatibilidad entre versiones y mantenga las dependencias peer como externas.