yarn tag

Додавання, видалення або виведення на екран списка міток пакета.

Що таке мітки?

Розподіленні мітки (або dist-tags) - це засіб помічання опублікованних версій вашого пакету ярликом. Користувачі вашого пакету можуть встановити її використовуючи цей ярлик замість номера версії.

Наприклад, якщо у вас був stable канал випуску і канал випуску canary, то ви могли б використовувати мітки, щоб користувач міг виконати команди:

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

Різні міткі мають різне значення:

  • latest: поточна версія пакету
  • stable: стабільний випуск пакету, зазвичай те саме, що і latest, якщо ви не використовуєте довготривалу підтримку (LTS)
  • beta: випуск перед тим як стати latest або stable, використовується для поширення змін до того, як випуск буде готовим.
  • canary: “нічний” або попередній до beta реліз, якщо ваш проект часто оновлюється, і від нього залежать багато людей, то ви можете використовувати “нічний” випуск, щоб поширювати зміни.
  • dev: інколи, вам захочеться перевірити публікацію в реєстр певної версії до того, як вона буде готова до випуску, ця мітка слугує цим випадкам.

Деякі проекти створять свої власні мітки, які відповідають їх процесам або стандартам. Наприклад next, що те саме що і beta.

Хоча ці мітки і прийняті як загальний стандарт, лише одна із них має справжнє значення latest, яка визначає, яку версію встановити, якщо користувач не вказав жодної.

Застереження

Ви не можете використовувати мітки, які підходять до імовірних номерів версій, так як вони ділять один простір імен:

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

Будь-яка мітка, яка може бути визначена як і межі семантичної версії, буде відхилена. Наприклад, вам не можна назвати мітку 2.3, тому в семантичних версіях це означає >=2.3.0 <2.4.0.

Загалом, уникайте міток, які виглядають як версії, вони тільки можуть збити з пантелику інших людей.

Команди

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

Додає мітку з іменем <tag> для вказаної <version> пакету <package>.

yarn tag remove <package> <tag>

Видаляє мітки з іменем <tag> з <package>, що більше не використовується.

Примітка: Вам не треба видаляти мітки до того, як перемістити її в іншу версію в пакеті. Краще так не робити.

yarn tag list [<package>]

Виводить на екран всі мітки пакету <package>. Якщо не вказати <package>, то по замовченню виведуться всі мітки пакету з поточної теки.