Yarn install: Como instalar o ge­ren­ci­a­dor de pacotes Ja­vaS­cript

Para instalar o Yarn, primeiro é preciso instalar a versão completa e, em seguida, uma versão de projeto in­di­vi­dual. Então, você pode con­fi­gu­rar o ge­ren­ci­a­dor de pacotes de acordo com as suas ne­ces­si­da­des.

Instalar Yarn passo a passo

O ge­ren­ci­a­dor de pacotes Yarn para Ja­vaS­cript foi de­sen­vol­vido para o ambiente de execução Node.js e, desde seu lan­ça­mento em 2016, tornou-se uma das opções mais populares nesse segmento. Já que a ins­ta­la­ção e con­fi­gu­ra­ção do programa nem sempre são simples, apre­sen­ta­mos aqui um tutorial passo a passo de como instalar o Yarn. Para isso, você já precisa ter instalado o Node.js.

Pré-re­qui­si­tos para instalar o Yarn

Existem poucos pré-re­qui­si­tos para instalar o Yarn. Além do Node.js, você precisará de uma dis­tri­bui­ção do Linux, por exemplo o Ubuntu, como sistema ope­ra­ci­o­nal. Também é ne­ces­sá­rio ter o ge­ren­ci­a­dor de pacotes npm e uma conta com pri­vi­lé­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 con­fir­ma­ção, você já pode começar a instalar o Yarn.

Baixar e instalar o Yarn

Para realizar o Yarn install, você deve ba­si­ca­mente instalar duas versões do ge­ren­ci­a­dor 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 ge­ren­ci­a­dor 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 lo­cal­mente

Em seguida, você deve instalar o Yarn para um projeto Ja­vaS­cript es­pe­cí­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 dis­po­ní­vel. Salve-a em uma pasta de projeto com o nome .yarn/releases e crie um arquivo de con­fi­gu­ra­çõ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 cor­re­ta­mente, você verá o seguinte resultado (o número varia de acordo com a versão atual):

3.0.0

Comandos mais im­por­tan­tes do Yarn

Ime­di­a­ta­mente após executar o Yarn install, você já poderá começar a usar o ge­ren­ci­a­dor de pacotes. Para trabalhar com o Yarn de forma eficiente, vale a pena conhecer seus comandos básicos. Nas seções a seguir, apre­sen­ta­re­mos re­su­mi­da­mente os mais im­por­tan­tes.

Iniciar novo projeto

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

yarn init

Salvar e criar de­pen­dên­cias

Se você já tem um projeto e deseja armazenar todas as de­pen­dên­cias dentro dele, use o comando yarn install:

yarn install

Para adicionar novas de­pen­dên­cias, 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

Con­fi­gu­ra­çã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 con­fi­gu­ra­ção para o seu arquivo .gitignore:

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

Ajuda e mais in­for­ma­ções

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

$ yarn --help

Caso você queira ajuda para um comando es­pe­cí­fico, pode sim­ples­mente combiná-lo com --help. Por exemplo, se você deseja mais in­for­ma­ções sobre o comando yarn install, digite:

$ yarn install --help

Al­ter­na­ti­vas ao Yarn

O Yarn é uma solução muito re­co­men­dá­vel para quem quer com­par­ti­lhar ou utilizar código com segurança. Mas também existem boas al­ter­na­ti­vas 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 per­fei­ta­mente com­pa­tí­vel com o ambiente de execução. Essa fer­ra­menta 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 uti­li­za­mos o npm.

pnpm

O pnpm é outro ge­ren­ci­a­dor de pacotes open source to­tal­mente adequado para trabalhar com Ja­vaS­cript. Sua estrutura é se­me­lhante à do npm, mas ele utiliza links sim­bó­li­cos (symlinks) e não requer a ins­ta­la­ção local de vários pacotes idênticos. Esse programa foi de­sen­vol­vido para oferecer uma al­ter­na­tiva ainda mais eficiente ao npm, sendo portanto uma opção in­te­res­sante para subs­ti­tuir o Yarn.

Bower

A terceira al­ter­na­tiva é o Bower, um ge­ren­ci­a­dor de pacotes gratuito para de­sen­vol­vi­mento web do lado do cliente. Portanto, ele foi otimizado para o trabalho no front-end. Para isso, também há uma grande di­ver­si­dade de pacotes dis­po­ní­veis. Além do Ja­vaS­cript, esse ge­ren­ci­a­dor também permite trabalhar com outros com­po­nen­tes, como HTML e CSS. Ele é muito fácil de usar e funciona por uma linha de comando do Node.js.