O Node Package Manager, popularmente conhecido como npm, é um repositório online para publicação de pacotes e bibliotecas NodeJS.
É também uma ferramenta de linha de comando que permite interagir com pacotes registrados. Ele pode ajudar na instalação de pacotes, gerenciamento de versões e gerenciamento de dependências.
Os desenvolvedores publicam suas bibliotecas JavaScript no npm todos os dias. O processo é bastante simples, então você também pode publicar um pacote no npm.
Etapa 1: Instalando o NodeJS
Para interagir com o npm, você deve tê-lo instalado globalmente em seu sistema.
Começar por instalando NodeJS e npm no Ubuntu, no Windows, ou seguindo as instruções do NodeJS local na rede Internet.
Etapa 2: criando uma conta npm
Para publicar seus pacotes no npm, você deve criar uma conta npm no site oficial do npm.
Siga os passos abaixo para criar uma conta npm:
- Vou ao inscrição npm página.
- Preencha seus dados, concorde com a licença e política de privacidade e clique em “criar conta”.
- Verifique seu e-mail com o link que você receberá do npm em sua caixa de correio.
Se você não verificar seu endereço de e-mail, o npm gerará um erro quando você tentar publicar seus pacotes.
Etapa 3: inicializando um repositório Git
Em seguida, você precisa inicializar um repositório Git para rastrear todas as alterações que fará em seu projeto.
No seu terminal, navegue até o diretório raiz do seu projeto e execute o seguinte comando para inicializar um repositório Git vazio.
git init
Crie um .gitignore Arquivo e adicione quaisquer arquivos que você não deseja que o Git rastreie. Em seguida, execute o seguinte comando para rastrear os arquivos restantes:
git add -A
Em seguida, execute o comando a seguir para obter seu primeiro instantâneo confirmando o código no Git.
git comprometer-se -m inicial-comprometer-se
Você pode optar por hospede seu repositório Git no GitHub ou um serviço semelhante como o Gitlab para uma colaboração perfeita.
Etapa 4: inicializando o npm em seu projeto
Em seguida, inicialize o npm em seu projeto para adicionar detalhes sobre seu projeto a um arquivo package.json. Esses detalhes serão públicos no npm.
No seu terminal, navegue até o diretório raiz do seu projeto e execute o seguinte comando para inicializar o npm em seu projeto.
npm init
O comando acima acionará um conjunto de prompts em sua linha de comando:
- nome do pacote: Este é o nome do seu pacote npm; deve ser único se você quiser publicar o pacote no npm; caso contrário, o npm lançará um erro.
- versão: Esta propriedade denota a versão atual do seu pacote. Você deve incrementá-lo toda vez que atualizar seu pacote ou o npm lançará um erro. O valor padrão é 1.0.0.
- Descrição: Esta propriedade é a descrição do seu pacote. Será público quando você publicar seu pacote.
- ponto de entrada: esta propriedade denota o nome do arquivo onde a execução do seu código começa.
- comando de teste: Esta propriedade indica o comando que será executado quando você executar teste de execução npm.
- repositório git: esta propriedade é a URL do seu repositório Git remoto.
- palavras-chave: esta propriedade denota as palavras-chave relevantes ao seu projeto que ajudarão o mecanismo de busca a encontrá-lo.
- autor: esta propriedade deve ser seu nome ou alias.
- licença: esta é a licença sob a qual você deseja publicar o pacote. A licença padrão é a licença do Internet Systems Consortium (ISC).
Depois de configurar isso, você pode criar seu pacote.
Etapa 5: testando seu pacote
Depois de terminar de criar seu pacote, você deve testá-lo localmente para ver como ele se comportaria depois de implantá-lo no npm.
Para testar seu pacote localmente, primeiro execute o seguinte comando no diretório do seu projeto:
link npm
O comando acima permite que você faça referência ao seu pacote localmente como faria com um pacote hospedado no npm.
Em seguida, crie outra pasta no diretório raiz do seu projeto e faça cd nela.
mkdir teste
cdteste
Na pasta de teste, execute o seguinte comando para vincular seu pacote à pasta:
npm link nome-do-seu-pacote
Por fim, crie um arquivo fictício para testar a funcionalidade do seu pacote.
Depois de concluir seus testes, você pode excluir com segurança sua pasta de teste.
Etapa 6: Fazendo login no npm em seu sistema
Em seguida, você precisa fazer login na sua conta npm em seu sistema.
Execute o seguinte comando para fazer login na sua conta npm:
npm login
Isso solicitará que você preencha seu nome de usuário, senha e um código de autenticação de dois fatores (se você o ativou em sua conta).
Etapa 7: publicando seu pacote
Depois de concluir todas as etapas acima, execute o seguinte comando para publicar seu pacote no npm.
npm publicar
Este comando requer uma senha de uso único que será para o seu e-mail. Em seguida, ele publicará seu pacote no npm.
Você pode visualizar os pacotes que publicou no npm. Faça login na sua conta npm em npmjs. com e navegue até a seção de pacotes no painel do seu perfil.
Para instalar seu pacote e usá-lo como dependência em qualquer um de seus projetos, execute:
npm instalarnome-do-sua-pacote
Excluindo seu pacote do npm
Você ainda tem controle total sobre seus pacotes no npm, o que significa que você pode modificar e até excluir seu pacote permanentemente do npm. Você pode excluir seus pacotes acessando a seção de configurações do seu pacote e selecionando a opção excluir pacote.