yarn tag

Agrega, elimina o lista etiquetas en un paquete.

¿Qué son las etiquetas?

Etiquetas de distribución (o dist-tags) son una manera de marcar las versiones publicadas de tu paquete con un nombre. Usuarios de tu paquete pueden instalarlo usando esta etiqueta en lugar del número de versión.

Por ejemplo, si tuvieras un canal de lanzamiento stable y un canal de lanzamiento canary, puedes usar las etiquetas para que el usuario pueda escribir:

yarn add your-package-name@stable
yarn add your-package-name@canary

Distintas etiquetas tienen distintos significados:

  • latest: La versión actual del paquete
  • stable: La última versión estable del paquete, normalmente la misma que latest, a menos de que tengas Soporte a Largo Plazo (LTS - Long Term Support)
  • beta: Un lanzamiento antes de convertirse en latest y/o stable, solían compartir cambios antes de ser finalizadas.
  • canary: Un lanzamiento pre-beta o “nightly”, si tu proyecto es actualizado frecuentemente y mucha gente depende en él, puedes usar esto para compartir tu código incluso antes.
  • dev: A veces deseas ser capaz de probar una sola revisión em el registro mientras aún estás trabajando en detalles; esto es útil para eso.

Algunos proyectos crearán sus propias etiquetas como lo vean apropiado o en lugar de alguno de los más estandarizados. Como por ejemplo next, el cual es usado de igual manera que beta.

Aunque estas son considerados etiquetas estándares en gran medida, la única que tiene significado real es latest, la cual es usada para determinar que versión instalar cuando ninguna versión es especificada.

Advertencias

No puedes utilizar etiquetas que coincidan con números de versiones potenciales ya que comparten un espacio de nombres:

yarn add your-package-name@<version>
yarn add your-package-name@<tag>

Cualquier etiqueta que también pueda ser usada como un rango versionamiento semántico válido será rechazada. Por ejemplo, no puedes tener una etiqueta llamada v2.3 porque en versionamiento semántico significa >=2.3.0 <2.4.0.

En general, evita usar etiquetas que parezcan versiones, comúnmente confunden a la gente de todas formas.

Comandos

yarn tag add <package>@<version> <tag>

Añade una etiqueta llamada <tag> para una versión específica <version> de un paquete <package>.

yarn tag remove <package> <tag>

Elimina una etiqueta llamada <tag> de un paquete <package> que ya no está en uso.

Nota: No necesitas eliminar una etiqueta antes de moverla a otra versión del paquete. Es mejor no hacerlo.

yarn tag list [<package>]

Lista todas las etiquetas de un paquete <package>. Si no está especificado <package> será por defecto el paquete que está en el directorio en el que te encuentras.