Yarn install: Como instalar o gerenciador de pacotes JavaScript

Para instalar o Yarn, primeiro é preciso instalar a versão completa e, em seguida, uma versão de projeto individual. Então, você pode configurar o gerenciador de pacotes de acordo com as suas necessidades.

Instalar Yarn passo a passo

O gerenciador de pacotes Yarn para JavaScript foi desenvolvido para o ambiente de execução Node.js e, desde seu lançamento em 2016, tornou-se uma das opções mais populares nesse segmento. Já que a instalação e configuração do programa nem sempre são simples, apresentamos aqui um tutorial passo a passo de como instalar o Yarn. Para isso, você já precisa ter instalado o Node.js.

Pré-requisitos para instalar o Yarn

Existem poucos pré-requisitos para instalar o Yarn. Além do Node.js, você precisará de uma distribuição do Linux, por exemplo o Ubuntu, como sistema operacional. Também é necessário ter o gerenciador de pacotes npm e uma conta com privilégios sudo. Caso você não saiba se possui o Node.js no seu sistema, pode verificar isso com este comando:

$ node -v

Assim, você verá qual versão está instalada no sistema. Após a confirmação, você já pode começar a instalar o Yarn.

Baixar e instalar o Yarn

Para realizar o Yarn install, você deve basicamente instalar duas versões do gerenciador de pacotes. O primeiro passo é baixar a versão completa do programa. Desse modo, você garantirá que a mesma versão será usada para todas as etapas de trabalho e todos os membros da equipe. Isso minimiza o risco de erros. Para instalar a versão completa, o melhor é utilizar o gerenciador de pacotes npm. O comando para isso é o seguinte:

$ sudo npm install -g yarn

Então, consulte o número da versão, para ter certeza de que recebeu os pacotes mais recentes:

$ yarn --version

Instalar o Yarn localmente

Em seguida, você deve instalar o Yarn para um projeto JavaScript específico. Para isso, primeiro acesse o diretório do seu projeto. No comando abaixo, substitua a expressão “seu-projeto” pelo nome real do projeto:

cd ~/seu-projeto

Caso você ainda não tenha uma pasta de projeto, basta criá-la com o comando mkdir:

mkdir seu-projeto
cd seu-projeto

Agora, use o comando yarn set para obter a versão Berry do Yarn:

$ yarn set version berry

A versão mais recente do Yarn Berry será baixada, se disponível. Salve-a em uma pasta de projeto com o nome .yarn/releases e crie um arquivo de configurações chamado .yarnrc.yml. A mensagem exibida será algo como:

Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/user/seu-projeto/.yarn/releases/yarn-berry.cjs...
Updating /home/user/seu-projeto/.yarnrc.yml...
Done!

Então, verifique novamente a versão:

$ yarn --version

Se o Yarn Berry foi instalado corretamente, você verá o seguinte resultado (o número varia de acordo com a versão atual):

3.0.0

Comandos mais importantes do Yarn

Imediatamente após executar o Yarn install, você já poderá começar a usar o gerenciador de pacotes. Para trabalhar com o Yarn de forma eficiente, vale a pena conhecer seus comandos básicos. Nas seções a seguir, apresentaremos resumidamente os mais importantes.

Iniciar novo projeto

Para iniciar um novo projeto, utilize o comando init. Ele cria o novo projeto e todos os arquivos necessários:

yarn init

Salvar e criar dependências

Se você já tem um projeto e deseja armazenar todas as dependências dentro dele, use o comando yarn install:

yarn install

Para adicionar novas dependências, basta usar o comando add. No código abaixo, substitua a expressão “nome-do-pacote” pelo nome do pacote desejado:

yarn add nome-do-pacote

Configuração ideal para .gitignore

Todos os arquivos são salvos na pasta .yarn dentro do seu projeto. Porém, alguns desses arquivos podem ficar de fora. Para isso, use a seguinte configuração para o seu arquivo .gitignore:

.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

Ajuda e mais informações

Se você precisar de ajuda ou de mais informações após instalar o Yarn, o melhor é usar o comando --help.

$ yarn --help

Caso você queira ajuda para um comando específico, pode simplesmente combiná-lo com --help. Por exemplo, se você deseja mais informações sobre o comando yarn install, digite:

$ yarn install --help

Alternativas ao Yarn

O Yarn é uma solução muito recomendável para quem quer compartilhar ou utilizar código com segurança. Mas também existem boas alternativas ao Yarn, que podem cumprir as mesmas funções.

npm

O npm (Node Package Manager) é uma das opções mais comuns para trabalhar com o Node.js. Ele é muito simples, rápido e seguro de usar, além de ser perfeitamente compatível com o ambiente de execução. Essa ferramenta oferece um registro com mais de 1,3 milhão de pacotes, bem como a interface CLI. Neste tutorial para o Yarn install, por exemplo, também utilizamos o npm.

pnpm

O pnpm é outro gerenciador de pacotes open source totalmente adequado para trabalhar com JavaScript. Sua estrutura é semelhante à do npm, mas ele utiliza links simbólicos (symlinks) e não requer a instalação local de vários pacotes idênticos. Esse programa foi desenvolvido para oferecer uma alternativa ainda mais eficiente ao npm, sendo portanto uma opção interessante para substituir o Yarn.

Bower

A terceira alternativa é o Bower, um gerenciador de pacotes gratuito para desenvolvimento web do lado do cliente. Portanto, ele foi otimizado para o trabalho no front-end. Para isso, também há uma grande diversidade de pacotes disponíveis. Além do JavaScript, esse gerenciador também permite trabalhar com outros componentes, como HTML e CSS. Ele é muito fácil de usar e funciona por uma linha de comando do Node.js.