Angular Academy · Aula

Publicando no npm

Versione e publique sua biblioteca.

Publicando no npm é uma aula grátis de Angular Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Angular Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Angular Academy inclui 4 aulas no total.

Compartilhando sua biblioteca com o mundo

Depois de compilada no Angular Package Format, uma biblioteca é publicada em um registro, geralmente o npm, para que qualquer projeto possa instalá-la com npm install. Esta lição aborda o versionamento e o fluxo de publicação.

Publique a saída de dist, não o código-fonte

Você publica o pacote compilado em dist/<lib>, que contém o package.json gerado e os pacotes compilados, nunca o projeto de código-fonte bruto. A etapa de compilação é o que o torna consumível.

ng build ui-kit --configuration production
cd dist/ui-kit

Versionamento semântico

Os pacotes npm usam semver: MAJOR.MINOR.PATCH. Incremente PATCH para correções, MINOR para recursos compatíveis com versões anteriores e MAJOR para alterações incompatíveis. Os consumidores dependem disso para atualizar com segurança.

0.0.1 -> 0.1.0   # new feature, no breaks (minor)
0.1.0 -> 0.1.1   # bug fix (patch)
0.1.1 -> 1.0.0   # breaking change (major)

Definindo a versão

A versão vem do próprio package.json da biblioteca. Atualize-a antes de compilar ou use npm version para incrementá-la de forma consistente.

# inside projects/ui-kit (or use the field directly)
npm version minor   # bumps and tags the version

Entrando no npm

Autentique-se no registro antes de publicar. npm login armazena um token para autorizar o comando de publicação.

npm login
# enter username, password / token, email

Publicando

Na pasta do pacote compilado, execute npm publish. O npm envia o pacote e permite que ele seja instalado pelo nome e pela versão.

cd dist/ui-kit
npm publish

Pacotes com escopo

Os pacotes de organizações usam um escopo, como @myorg/ui-kit. No npm, os pacotes com escopo são privados por padrão; passe --access public para publicá-los publicamente.

npm publish --access public

Instalando a biblioteca publicada

Em seguida, os consumidores a adicionam como qualquer dependência e importam pela API pública. O Angular encontra o pacote FESM e os tipos por meio do package.json gerado.

npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';

Pré-lançamentos e tags

Publique compilações instáveis usando uma tag de distribuição, como next, para que elas não se tornem a versão padrão latest. Os consumidores optam por usá-las explicitamente.

npm publish --tag next
npm install ui-kit@next

Registros privados

Para bibliotecas destinadas apenas ao uso interno, publique em um registro privado (pacotes privados do npm, GitHub Packages ou Verdaccio) configurando .npmrc. O fluxo de publicação é o mesmo; apenas a URL do registro e a autenticação são diferentes.

Automatize na CI

Equipes maduras publicam a partir da CI em uma versão marcada: o fluxo compila a biblioteca, executa os testes e executa npm publish com um token armazenado. Isso evita erros manuais e mantém as versões rastreáveis aos commits.

Verificação rápida

O que você publica no npm?

Recapitulação

Publique a saída compilada de dist/<lib>, versionada com semver. Incremente a versão, execute npm login e depois npm publish (adicione --access public para pacotes com escopo e --tag next para pré-lançamentos). Os consumidores executam npm install e importam pela API pública. Automatize a publicação na CI para garantir confiabilidade.

Perguntas Frequentes

A aula “Publicando no npm” é grátis?

Sim — o texto completo de “Publicando no npm” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Angular Academy, atualize para CoddyKit PRO. O curso de Angular Academy inclui 4 aulas no total.

O que vou aprender em “Publicando no npm”?

Versione e publique sua biblioteca. Você pratica Angular Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Angular Academy?

Nenhuma experiência prévia é necessária. Angular Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Publicando no npm”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Angular Academy?

Sim. Cada aula de Angular Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Angular Academy