Ins­ta­la­ção do Yarn: como con­fi­gu­rar o gestor de pacotes para Ja­vaS­cript

Para instalar o Yarn, primeiro deve con­fi­gu­rar a versão global e, em seguida, uma versão es­pe­cí­fica para o seu projeto. Depois de fazer isso, pode per­so­na­li­zar o gestor de pacotes como preferir.

Yarn: ins­ta­la­ção passo a passo

O gestor de pacotes Ja­vaS­cript Yarn foi de­sen­vol­vido para Node.js e, desde o seu lan­ça­mento em 2016, tornou-se uma das opções mais populares na sua categoria. Como instalar o Yarn e começar a utilizá-lo pode não ser tão simples, ofe­re­ce­mos um guia detalhado passo a passo. Primeiro, é im­por­tante que tenha o Node.js con­fi­gu­rado.

Re­qui­si­tos para instalar o Yarn

Para instalar o Yarn, basta cumprir alguns re­qui­si­tos. Além de ter o Node.js, é re­co­men­dá­vel usar uma dis­tri­bui­ção Linux, como o Ubuntu, como sistema operativo. Também será ne­ces­sá­rio o gestor de pacotes npm e uma conta com pri­vi­lé­gios sudo. Se não tiver a certeza se o Node.js está instalado no seu sistema, pode verificar digitando o seguinte comando:

$ node -v

Desta forma, poderá saber qual versão está instalada no seu sistema. Após receber a con­fir­ma­ção, poderá começar a instalar o Yarn.

Des­car­re­gar o Yarn e instalá-lo

Para instalar o Yarn, deve con­fi­gu­rar duas versões do gestor de pacotes. Primeiro, des­car­re­gue a versão completa do programa. Desta forma, garante que todos os passos de trabalho e membros da equipa utilizam a mesma versão, o que reduz a pos­si­bi­li­dade de surgirem erros. Para instalar a versão completa, o melhor é utilizar o gestor de pacotes npm. Para isso, utilize o seguinte comando:

$ sudo npm install -g yarn

Em seguida, verifique o número da versão para garantir que obteve os pacotes mais recentes. Este é o comando que deve utilizar:

$ yarn --version

Instalar o Yarn lo­cal­mente

Em seguida, configure o Yarn para um projeto Ja­vaS­cript es­pe­cí­fico. Primeiro, aceda ao diretório do seu projeto. Substitua o marcador de posição «seu-projeto» pelo nome real do seu projeto. Para isso, utilize este comando:

cd ~/tu-proyecto

Se ainda não tiver uma pasta de projeto, pode criá-la com o seguinte comando que inclui mkdir:

mkdir tu-proyecto
cd tu-proyecto

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

$ yarn set version berry

Se dis­po­ní­vel, a versão mais recente do Yarn Berry será des­car­re­gada. Guarde-a numa pasta do projeto com o nome .yarn/releases e crie um ficheiro de con­fi­gu­ra­ção chamado .yarnrc.yml. O resultado do comando será algo se­me­lhante a isto:

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

Verifique novamente a versão desta forma:

$ yarn --version

Se a ins­ta­la­ção do Yarn Berry estiver correta, deverá ver a seguinte saída (o número da versão varia de acordo com a versão que tiver nesse momento):

3.0.0

Comandos es­sen­ci­ais para o gestor de pacotes

Depois de instalar o Yarn, poderá começar a usar o gestor de pacotes. Para tirar o máximo proveito dele no seu fluxo de trabalho, é útil conhecer os comandos básicos. A seguir, mostramos os comandos mais im­por­tan­tes para que possa gerir melhor os seus projetos.

Começar um novo projeto

Para iniciar um novo projeto, utilize o comando init, que criará o novo projeto e todos os ficheiros ne­ces­sá­rios para isso:

yarn init

Criar e guardar de­pen­dên­cias

Se já tem um projeto em andamento e deseja armazenar todas as de­pen­dên­cias nele, pode utilizar o comando yarn install:

yarn install

Para adicionar novas de­pen­dên­cias ao seu projeto, utilize o comando add. Basta subs­ti­tuir o marcador de posição “no­me­do­pa­cote” no código a seguir pelo nome do pacote cor­res­pon­dente:

yarn add nombredelpaquete

A melhor con­fi­gu­ra­ção para .gitignore

No seu projeto, todos os ficheiros são guardados na pasta .yarn. No entanto, alguns deles podem ser excluídos do controlo de versão. Use a seguinte con­fi­gu­ra­ção para o seu ficheiro .gitignore:

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

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

Se precisar de ajuda ou in­for­ma­ções adi­ci­o­nais após instalar o Yarn, a melhor opção é utilizar --help.

$ yarn --help

Se precisar de ajuda para um comando es­pe­cí­fico, basta combiná-lo com --help. Por exemplo, para obter mais in­for­ma­ções sobre o comando yarn install, pode escrever o seguinte:

$ yarn install --help

Quais são as al­ter­na­ti­vas ao Yarn?

O Yarn é uma solução altamente re­co­men­dada quando é ne­ces­sá­rio partilhar ou utilizar código de forma segura. No entanto, existem boas al­ter­na­ti­vas que pode con­si­de­rar em vez de instalar o Yarn.

npm

Não é de admirar que o npm (Node Package Manager) seja uma opção a con­si­de­rar quando se trabalha com o ambiente de execução. O seu uso é muito simples, rápido e seguro, além de estar per­fei­ta­mente integrado com o Node.js. Esta solução conta com um registo de mais de 1,3 milhões de pacotes e uma interface de linha de comandos (CLI). Mesmo neste guia de ins­ta­la­ção do Yarn, uti­li­zá­mos os serviços do npm.

pnpm

O pnpm é outro gestor de pacotes de código aberto ideal para trabalhar com Ja­vaS­cript. A sua estrutura é se­me­lhante à do npm, mas com uma diferença fun­da­men­tal: utiliza ligações sim­bó­li­cas (symlinks) e evita instalar pacotes idênticos várias vezes no sistema local. Esta solução foi concebida para ser uma al­ter­na­tiva mais eficiente ao npm, o que a torna outra boa al­ter­na­tiva ao Yarn.

Bower

A terceira al­ter­na­tiva é o Bower, um gestor de pacotes gratuito projetado es­pe­ci­fi­ca­mente para o de­sen­vol­vi­mento web do lado do cliente, por isso está otimizado para trabalhar no frontend. O Bower oferece uma ampla seleção de pacotes e, além do Ja­vaS­cript, também pode gerir outros com­po­nen­tes como HTML e CSS. O seu uso é muito simples e é feito através da linha de comandos do Node.js. 1fd2992bea1647c3c5d2803bc12663ef