yarn tag

Добавление, удаление или вывод на экран списка меток пакета.

Что такое метки?

Размещение с метками (или dist-tags) - это способ пометки опубликованных версий пакета ярлыками. Пользователи Вашего пакета могут установить его, используя эту метку вместо номера версии.

Например, если у Вас два канала распространения stable и canary, можно использовать эти метки для смены:

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

Разные метки имеют разное значение:

  • latest: Текущая версия пакета
  • stable: Стабильная версия пакета, обычно идентична стабильной, если нет долгосрочной поддержки (LTS)
  • beta: бета-релиз, прежде чем стать последним и/или стабильным, используется для проверки предстоящих изменений, до того, как выпуск будет готов.
  • canary: Это “ночная” или пред-бета релиз, если ваш проект часто обновляется и обладает большим количеством интересующихся им людей, можно поделится кодом заранее.
  • dev: Иногда нужно проверить какие-то нововведения в рабочей сборке через реестр, метка используется для таких случаев.

Некоторые проекты добавляют свои метки, которые соответствуют их технологиям или стандартам. Например next обычно тоже самое, что и beta.

Хотя эти метки приняты за “стандартные”, только одна считается имеющей реальное значение - latest, она используется для определения последней версии и устанавливается если не указано другое значение.

Предостережения

Нельзя использовать метки схожие с номерами версий, они используют одно пространство имён:

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

Любой тег, который также может использоваться в качестве допустимого диапазона в схожих версиях, будет отклонен. Например, нельзя иметь тег с именем v2.3, поскольку в он будет похож на >=2.3.0 <2.4.0.

В общем, избегайте меток, которые выглядят как версии, они только могут сбить с толку других людей.

Команды

yarn tag add <имя пакета>@<версия> <тэг>

Добавляет тег с именем <tag> для указанного <version> пакета <package>.

yarn tag remove <package> <tag>

Удаляет метку с именем <tag> из <package>, которая больше не используется.

Примечание: Вам не нужно удалять тег до того, как переместите его в другую версию в пакете. Лучше так не делать.

yarn tag list [<package>]

Выводит на экран все теги пакета <package>. Если не указать <package>, то по умолчанию выведутся все теги пакета из текущей папки.