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 enfoca en velocidad, seguridad y consistencia. Originalmente fue creado para abordar algunos problemas con el popular gestor de paquetes NPM. Aunque los dos gestores de paquetes desde entonces han convergido en términos de rendimiento y características, Yarn sigue siendo popular, especialmente en el mundo del desarrollo de React.

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

• A per-project caching mechanism, that can greatly speed up subsequent installs and builds
• Instalaciones consistentes y deterministas que garantizan que la estructura de las bibliotecas instaladas siempre sea la misma
• Pruebas de suma de verificación de todos los paquetes para verificar su integridad
• “Espacios de trabajo”, que facilitan el uso de Yarn en un monorepo (múltiples proyectos desarrollados en un único repositorio de código fuente)

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

Instalación y Uso del Gestor de Paquetes Yarn para Node.js

1. Instalar Yarn globalmente
2. Instalar Yarn en tu proyecto
3. Usar Yarn

Prerrequisitos

Antes de instalar y usar el gestor de paquetes Yarn, necesitarás tener Node.js instalado. Para verificar si ya tienes Node.js instalado, escribe el siguiente comando en tu terminal local:

node -v

Si ves un número de versión, como v12.16.3 impreso, tienes Node.js instalado. Si obtienes un error de comando no encontrado (o una frase similar), por favor instala Node.js antes de continuar.

Para instalar Node.js, sigue nuestro tutorial para Ubuntu, Debian, CentOS, o macOS.

Una vez que hayas instalado Node.js, procede al Paso 1 para instalar el administrador de paquetes Yarn.

Paso 1 — Instalando Yarn globalmente

Yarn tiene una manera única de instalarse y ejecutarse en tus proyectos de JavaScript. Primero, instalas el comando yarn globalmente, 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 asegurar que todos los que trabajen en un proyecto (y todas las herramientas automatizadas de pruebas y despliegue del proyecto) estén ejecutando la misma versión de yarn, para evitar comportamientos y resultados inconsistentes.Los mantenedores de Yarn recomiendan instalar Yarn globalmente usando el administrador de paquetes NPM, que está incluido por defecto en todas las instalaciones de Node.js. Usa la bandera -g con npm install para hacer esto:

Los mantenedores de Yarn recomiendan instalar Yarn de forma global utilizando el gestor de paquetes NPM, que se incluye por defecto en todas las instalaciones de Node.js. Utilice la bandera -g con npm install para hacerlo:

sudo npm install -g yarn

Después de que se instale el paquete, haga que el comando yarn imprima su propio número de versión. Esto le permitirá verificar que se instaló correctamente:

yarn --version

Output
1.22.11

Ahora que tiene el comando yarn instalado de forma global, puede usarlo para instalar Yarn en un proyecto JavaScript específico.

Paso 2: Instalar Yarn en su proyecto

Puede omitir este paso si está utilizando Yarn para trabajar con un proyecto existente basado en Yarn. El proyecto ya debe estar configurado con una versión local de Yarn y todos los archivos de configuración necesarios para usarlo.

Si está configurando un nuevo proyecto propio, querrá configurar una versión específica del proyecto de Yarn ahora.

Primero, navegue hasta el directorio de su proyecto:

cd ~/my-project

Si no tiene un directorio de proyecto, puede crear uno nuevo con mkdir y luego moverse a él:

mkdir my-project
cd my-project

Ahora use el comando yarn set para establecer la versión en berry:

yarn set version berry

Esto descargará la versión actual, en desarrollo activo de Yarn – berry – guárdela en un directorio .yarn/releases/ en su proyecto y configure un archivo de configuración .yarnrc.yml también:

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 intenta de nuevo 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 ahora está configurado con una versión específica del proyecto de Yarn. A continuación, veremos algunos comandos yarn comúnmente utilizados para comenzar.

Usando Yarn

Yarn tiene muchos subcomandos, pero solo necesitas algunos para comenzar. Veamos los primeros subcomandos que querrás usar.

Obtener Ayuda

Al comenzar con cualquier herramienta nueva, es útil aprender cómo acceder a su ayuda en línea. En Yarn, la bandera --help se puede agregar a cualquier comando para obtener más información:

yarn --help

Esto imprimirá ayuda general para el comando yarn. Para obtener información más específica sobre un subcomando, agregue --help después del subcomando:

yarn install --help

Esto imprimiría detalles sobre cómo usar el comando yarn install.

Empezando un Nuevo Proyecto de Yarn

Si estás comenzando un proyecto desde cero, utiliza el subcomando init para crear los archivos específicos de Yarn que necesitarás:

yarn init

Esto agregará un archivo de configuración package.json y un archivo yarn.lock a tu directorio. El package.json contiene la configuración y tu lista de dependencias de módulos. El archivo yarn.lock fija esas dependencias a versiones específicas, asegurándose de que el árbol de dependencias siempre sea consistente.

Instalando todas las Dependencias de un Proyecto

Para descargar e instalar todas las dependencias en un proyecto basado en Yarn existente, utiliza el subcomando install:

yarn install

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

Agregar una Nueva Dependencia a un Proyecto

Utilice el subcomando add para agregar nuevas dependencias a un proyecto:

yarn add package-name

Esto descargará el módulo, lo instalará y actualizará sus archivos package.json y yarn.lock.

Actualizar su archivo .gitignore para Yarn

Yarn almacena archivos en una carpeta .yarn dentro de su directorio del proyecto. Algunos de estos archivos deben ser revisados en el control de versiones y otros deben ser ignorados. La configuración básica de .gitignore para Yarn sigue:

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

Esto ignora todo el directorio .yarn y luego agrega algunas excepciones para carpetas importantes, incluida la carpeta releases que contiene la versión específica de Yarn para su proyecto.

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

Conclusión

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

Para obtener ayuda más general sobre Node.js y JavaScript, visita nuestras páginas de etiquetas Node.js y JavaScript, donde encontrarás tutoriales relevantes, charlas técnicas y preguntas y respuestas de la comunidad.