Instalación de Yarn: cómo configurar el gestor de paquetes para JavaScript

Para instalar Yarn, primero debes configurar la versión global y luego una versión específica para tu proyecto. Una vez hecho esto, puedes personalizar el gestor de paquetes como prefieras.

Yarn: instalación paso a paso

El gestor de paquetes JavaScript Yarn se desarrolló para Node.js y, desde su lanzamiento en 2016, se ha convertido en una de las opciones más populares en su categoría. Dado que instalar Yarn y comenzar a utilizarlo puede no ser tan sencillo, te ofrecemos una guía detallada paso a paso. De primeras, es importante que tengas Node.js configurado.

Requisitos para instalar Yarn

Para instalar Yarn, solo necesitas cumplir algunos requisitos. Además de contar con Node.js, es recomendable utilizar una distribución Linux, por ejemplo Ubuntu, como sistema operativo. También necesitarás el gestor de paquetes npm y una cuenta con privilegios sudo. Si no estás seguro de si Node.js está instalado en tu sistema, puedes comprobarlo escribiendo el siguiente comando:

$ node -v

De este modo, podrás saber qué versión está instalada en tu sistema. Después de recibir la confirmación, podrás comenzar a instalar Yarn.

Descargar Yarn e instalarlo

Para instalar Yarn, debes configurar dos versiones del gestor de paquetes. En primer lugar, descarga la versión completa del programa. De esta forma, te aseguras de que todos los pasos de trabajo y miembros del equipo utilicen la misma versión, lo que reduce la posibilidad de que surjan errores. Para instalar la versión completa, lo mejor es utilizar el gestor de paquetes npm. Para ello, utiliza el siguiente comando:

$ sudo npm install -g yarn

Después, comprueba el número de versión para asegurarte de que has obtenido los paquetes más recientes. Este es el comando que debes utilizar:

$ yarn --version

Instalar Yarn localmente

A continuación, configura Yarn para un proyecto específico de JavaScript. Primero, llama al directorio de tu proyecto. Reemplaza el marcador de posición “tu-proyecto” con el nombre real de tu proyecto. Utiliza para ello este comando:

cd ~/tu-proyecto

Si aún no tienes una carpeta de proyecto, puedes crearla con el siguiente comando que incluye mkdir:

mkdir tu-proyecto
cd tu-proyecto

Utiliza ahora el comando yarn set para obtener la versión Yarn Berry:

$ yarn set version berry

Si está disponible, se descargará la última versión de Yarn Berry. Guárdala en una carpeta del proyecto con el nombre .yarn/releases y crea un archivo de configuración llamado .yarnrc.yml. La salida del comando será algo así:

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!

Vuelve a comprobar la versión de esta manera:

$ yarn --version

Si la instalación de Yarn Berry es correcta, deberías ver la siguiente salida (el número de versión varía en función de la versión que tengas en ese momento):

3.0.0

Comandos imprescindibles para el gestor de paquetes

Después de instalar Yarn, podrás empezar a usar el gestor de paquetes. Para sacarle el máximo provecho en tu flujo de trabajo, es útil conocer los comandos básicos. A continuación, te mostramos los comandos más importantes para que gestiones mejor tus proyectos.

Comenzar un nuevo proyecto

Para comenzar un nuevo proyecto, utiliza el comando init, el cual creará el nuevo proyecto y todos los archivos que necesitas para ello:

yarn init

Crear y guardar dependencias

Si ya tienes un proyecto en marcha y deseas almacenar en él todas las dependencias, puedes utilizar el comando yarn install:

yarn install

Para añadir nuevas dependencias a tu proyecto, utiliza el comando add. Simplemente reemplaza el marcador de posición “nombredelpaquete” en el siguiente código con el nombre del paquete correspondiente:

yarn add nombredelpaquete

La mejor configuración para .gitignore

En tu proyecto, todos los archivos se guardan en la carpeta .yarn. Sin embargo, algunos de ellos pueden quedar excluidos del control de versiones. Usa la siguiente configuración para tu archivo .gitignore:

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

Ayuda y más información

Si necesitas ayuda o información adicional después de instalar Yarn, la mejor opción es utilizar --help.

$ yarn --help

Si necesitas ayuda para un comando específico, simplemente combínalo con --help. Por ejemplo, para obtener más información sobre el comando yarn install, puedes escribir lo siguiente:

$ yarn install --help

¿Qué alternativas hay a Yarn?

Yarn es una solución muy recomendada cuando hay que compartir o utilizar código de manera segura. Sin embargo, existen buenas alternativas que puedes considerar en lugar de instalar Yarn.

npm

No es de extrañar que npm (Node Package Manager) sea una opción a considerar cuando trabajas con el entorno de ejecución. Su uso es muy sencillo, rápido y seguro, además de estar perfectamente integrado con Node.js. Esta solución cuenta con un registro de más de 1,3 millones de paquetes y una interfaz de línea de comandos (CLI). Incluso en esta guía de instalación de Yarn hemos utilizado los servicios de npm.

pnpm

pnpm es otro gestor de paquetes de código abierto ideal para trabajar con JavaScript. Su estructura es similar a la de npm, pero con una diferencia clave: utiliza enlaces simbólicos (symlinks) y evita instalar paquetes idénticos varias veces en el sistema local. Esta solución fue diseñada para ser una alternativa más eficiente a npm, lo que la convierte en otra buena alternativa a Yarn.

Bower

La tercera alternativa es Bower, un gestor de paquetes gratuito diseñado específicamente para el desarrollo web del lado del cliente, por lo que está optimizado para trabajar en el frontend. Bower ofrece una amplia selección de paquetes y, además de JavaScript, también puede gestionar otros componentes como HTML y CSS. Su uso es muy sencillo y se maneja a través de la línea de comandos de Node.js.