33. yarn tag

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

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

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

Например, если у вас есть канал релизов stable и канал релизов canary, вы можете использовать теги, чтобы позволить пользователю ввести:

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

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

• latest: Текущая версия пакета
• stable: Последняя стабильная версия пакета, обычно совпадает с latest, если у вас нет поддержки длительного цикла (LTS)
• beta: Релиз до перехода к latest и/или stable, используется для совместного использования предстоящих изменений до их завершения.
• canary: «Ночной» или предварительный бета-релиз. Если ваш проект часто обновляется и зависит от многих людей, вы можете использовать его для совместного использования ещё более раннего кода.
• dev: Иногда вы хотите протестировать один пересмотр через реестр, пока вы ещё работаете над чем-то; это полезно для этого.

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

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

Ограничения

Вы не можете использовать теги, которые совпадают с потенциальными номерами версий, так как они используют один и тот же пространство имён:

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

Любой тег, который также может использоваться как допустимый диапазон semver, будет отклонен. Например, у вас не может быть тега с именем v2.3 , потому что в semver это означает >=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> будет по умолчанию устанавливаться к пакету, в директории которого вы находитесь.