Cómo instalar y usar el Administrador de paquetes Yarn para Node.js

Introducción

Yarn es un gestor de paquetes para Node.js que se centra en la velocidad, la seguridad y la estabilidad. Se creó originalmente para solucionar algunos problemas con el popular gestor de paquetes NPM. Aunque ambos gestores han convergido en funcionalidad y características, Yarn sigue siendo popular, especialmente en el mundo del desarrollo con React.

Algunas de las características únicas de Yarn incluyen:

• Mecanismo de almacenamiento en cada proyecto, que puede acelerar enormemente la instalación y construcción posteriores.
• Instalaciones fijas y definitivas que garantizan que la estructura de las librerías instaladas sea siempre la misma.
• Probar la agregación de todos los paquetes para verificar su integridad
• “Espacios de trabajo” que facilitan el uso de Yarn en un monorepositorio (múltiples proyectos desarrollados en un único repositorio de código fuente).

En este tutorial, instalará Yarn globalmente, agregará Yarn a un proyecto específico y aprenderá algunos comandos básicos de Yarn.

Requisitos previos

Antes de poder instalar y usar el Gestor de Paquetes de Yarn, debe tener instalado Node.js. Para comprobar si ya tiene instalado Node.js, escriba el siguiente comando en su terminal de línea de comandos local:

node -v

Si ve un número de versión impreso como v12.16.3, tiene Node.js instalado. Si se produce un error de comando no encontrado (o similar), instale Node.js antes de continuar.

Paso 1: Instalación de Global YARN

Yarn se instala y ejecuta de forma única en tus proyectos JavaScript. Primero, instalas Yarn globalmente y luego usas el comando global Yarn para instalar una versión local específica de Yarn en el directorio de tu proyecto. Esto es necesario para garantizar que todos los que trabajan en un proyecto (y todas las herramientas automatizadas de pruebas e implementación) usen la misma versión de Yarn, para evitar comportamientos y resultados inconsistentes.

Los mantenedores de Yarn recomiendan instalar Yarn globalmente mediante el gestor de paquetes NPM, incluido por defecto en todas las instalaciones de Node.js. Para ello, utilice el parámetro -g con npm install:

sudo npm install -g yarn

Después de instalar el paquete, el comando hilo Pídele que imprima su número de versión. Esto te permitirá verificar que se instaló correctamente.

yarn --version

Output
1.22.11

Ahora que ha instalado el comando yarn globalmente, puede usarlo para instalar Yarn en un proyecto JavaScript específico.

Paso 2 – Instalación del hilo en su proyecto

Si usa Yarn para trabajar con un proyecto existente basado en Yarn, puede omitir este paso. El proyecto ya debería estar configurado con una versión local de Yarn y todos los archivos de configuración necesarios para su uso.

Si está iniciando un nuevo proyecto para usted, ahora querrá configurar una versión de Yarn específica para el proyecto.

Primero, vaya al directorio de su proyecto:

cd ~/my-project

Si no tiene un directorio de proyecto, puede crear una nueva carpeta con mkdir y luego ingresarla:

mkdir my-project
cd my-project

Ahora desde el comando juego de hilos Para configurar la versión de Berry utilice:

yarn set version berry

Esto descargará la versión actual y desarrollada de Yarn (berry) y la guardará en un directorio .yarn/releases/ en su proyecto, y también configurará un archivo de configuración .yarnrc.yml:

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

Ahora intente nuevamente el comando yarn --version:

yarn --version

Output
3.0.0

Verás que la versión es 3.0.0 o superior. Esta es la última versión de Yarn.

Tu proyecto ya está configurado con una versión específica de Yarn. A continuación, veremos algunos comandos de Yarn de uso común para ayudarte a empezar.

Usando hilo

Yarn tiene muchos subcomandos, pero solo necesitas unos pocos para empezar. Veamos los primeros subcomandos que querrás usar.

Al comenzar a usar cualquier herramienta nueva, es útil aprender a acceder a su ayuda en línea. En Yarn, puedes añadir la opción --help a cualquier comando para obtener más información:

yarn --help

Esto imprime ayuda general para el comando yarn. Para obtener información más detallada sobre un subcomando, añada –help después del subcomando:

yarn install --help

Esto imprimirá detalles sobre cómo utilizar el comando de instalación de hilo.

Iniciando un nuevo proyecto YARN

Si está iniciando un proyecto desde cero, utilice el subcomando init para crear los archivos específicos de Yarn que necesita:

yarn init

Esto agregará un archivo de configuración package.json y un archivo yarn.lock a su directorio. package.json contiene la configuración y la lista de dependencias de su módulo. El archivo yarn.lock bloquea esas dependencias en versiones específicas, lo que garantiza la coherencia del árbol de dependencias.

Instalación de todas las dependencias para un proyecto

Para descargar e instalar todas las dependencias en un proyecto existente basado en Yarn, utilice el subcomando de instalación:

yarn install

Esto descargará e instalará los módulos que necesita para comenzar.

Agregar una nueva dependencia a un proyecto

Utilice el subcomando add para agregar nuevas dependencias al proyecto:

yarn add package-name

Esto descargará e instalará el módulo y actualizará los archivos package.json y yarn.lock.

Actualizando archivo .gitignore Para hilo

Yarn almacena los archivos en una carpeta .yarn en el directorio de tu proyecto. Algunos de estos archivos deben registrarse en el control de versiones y otros deben ignorarse. La configuración básica de .gitignore para Yarn es la siguiente:

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

Esto ignorará todo el directorio yarn. y luego agregará algunas excepciones para carpetas importantes, incluido el directorio de versiones que contiene la versión específica de su proyecto de Yarn.

Para obtener más detalles sobre cómo configurar Git y Yarn, consulte la documentación oficial de Yarn en .gitignore.

Resultado

En este tutorial, instalaste Yarn y conociste algunos subcomandos de Yarn. Para más información sobre el uso de Yarn, consulta la documentación oficial de la CLI de Yarn.