Criando uma biblioteca com ng generate

Quando vários aplicativos precisam dos mesmos componentes, serviços ou utilitários, empacote-os como uma biblioteca Angular. Uma biblioteca é reutilizável, versionada e publicável, em vez de exigir que você copie e cole código entre projetos.

As bibliotecas ficam dentro de um espaço de trabalho Angular: uma pasta gerenciada por um único angular.json que pode conter vários aplicativos e bibliotecas. Você pode adicionar uma biblioteca a um espaço de trabalho existente ou criar um espaço dedicado.

O esquema ng generate library (com o alias ng g lib) cria a estrutura inicial de um novo projeto de biblioteca em projects/.

A biblioteca vem com sua própria pasta src/lib, um arquivo agregador public-api.ts, um ng-package.json (para a compilação) e uma entrada em angular.json. Ela é um projeto independente que pode ser compilado.

Gere código na biblioteca direcionando o comando para ela com --project. A CLI coloca os arquivos na pasta correta.

As bibliotecas modernas priorizam componentes independentes, que os consumidores importam diretamente sem um NgModule. Marque o componente com standalone: true para que os aplicativos possam usá-lo com uma simples importação.

Cada biblioteca tem seu próprio package.json, que define seu nome, sua versão e suas dependências de pares, como @angular/core. As dependências de pares significam que o aplicativo consumidor fornece o Angular, evitando cópias duplicadas.

Mantenha um aplicativo de demonstração no mesmo espaço de trabalho para exercitar a biblioteca enquanto você a desenvolve. Importar pelo nome da biblioteca resolve o caminho para o código-fonte local por meio dos mapeamentos de caminhos do TypeScript em tsconfig.

Um aplicativo é feito para ser implantado; uma biblioteca é feita para ser consumida. Bibliotecas não podem ser disponibilizadas diretamente: elas são compiladas em um pacote distribuível e publicadas ou importadas pelos aplicativos do espaço de trabalho.

Uma boa biblioteca tem um propósito claro (um kit de interface do usuário, uma camada de acesso a dados). Evite reunir código sem relação; bibliotecas coesas são mais fáceis de versionar, documentar e reutilizar.

Com a estrutura inicial da biblioteca pronta, resta definir sua API pública, compilá-la no Angular Package Format e publicá-la. As próximas lições abordam cada uma dessas etapas.

Como você cria uma biblioteca?

As bibliotecas empacotam código reutilizável para vários aplicativos. Crie uma com ng generate library dentro de um espaço de trabalho; o comando cria a estrutura inicial de src/lib, public-api.ts, ng-package.json e um package.json com dependências de pares. Adicione código usando --project, prefira componentes independentes e mantenha cada biblioteca focada.