Рабочие процессы

Включение функции

Из-за экспериментального статуса Corepack в настоящее время необходимо явно включить его, чтобы он работал. Для этого выполните corepack enable, что настроит символические ссылки в вашей среде рядом с node бинарником (и перезапишет существующие символические ссылки при необходимости).

Отныне любой вызов поддерживаемых бинарников будет работать без дальнейшей настройки. Если у вас возникнут проблемы, выполните corepack disable, чтобы удалить прокси с вашей системы (и подумайте об открытии проблемы в репозитории Corepack, чтобы сообщить нам об этом).

Настройка пакета

Прокси Corepack найдут ближайший файл package.json в вашей текущей иерархии каталогов, чтобы извлечь свойство "packageManager".

Если значение соответствует поддерживаемому менеджеру пакетов, Corepack позаботится о том, чтобы все вызовы соответствующих бинарников выполнялись с запрошенной версией, загружая её по требованию, если необходимо, и прерывая выполнение, если её невозможно успешно получить.

Вы можете использовать corepack use, чтобы попросить Corepack обновить вашу локальную package.json для использования менеджера пакетов по вашему выбору:

corepack use pnpm@7.x # sets the latest 7.x version in the package.json
corepack use yarn@* # sets the latest version in the package.json copy

Обновление глобальных версий

При запуске вне существующего проекта (например, при запуске yarn init), Corepack по умолчанию будет использовать предварительно определённые версии, примерно соответствующие последним стабильным выпускам каждого инструмента. Эти версии могут быть переопределены путём выполнения команды corepack install вместе с желаемой версией менеджера пакетов:

corepack install --global yarn@x.y.z copy

В качестве альтернативы можно использовать тэг или диапазон:

corepack install --global pnpm@*
corepack install --global yarn@stable copy

Рабочий процесс офлайн

Многие производственные среды не имеют доступа к сети. Так как Corepack обычно загружает релизы менеджеров пакетов прямо из их репозиториев, это может конфликтовать с такими средами. Чтобы этого избежать, выполните команду corepack pack, когда у вас всё ещё есть доступ к сети (обычно в то же время, когда вы готовите свой образ развертывания). Это гарантирует, что необходимые менеджеры пакетов будут доступны даже без доступа к сети.

Команда pack имеет различные флаги. Обратитесь к подробной документации Corepack для получения дополнительной информации.

Поддерживаемые менеджеры пакетов

Через Corepack предоставляются следующие бинарники:

Общие вопросы

Как Corepack взаимодействует с npm?

Хотя Corepack мог бы поддерживать npm, как и любой другой менеджер пакетов, его обёртки по умолчанию не включены. Это имеет несколько последствий:

• Всегда возможно запустить команду npm в проекте, настроенном для использования другого менеджера пакетов, так как Corepack не может перехватить её.

• Хотя npm — это допустимый вариант в свойстве "packageManager", отсутствие обёртки приведёт к использованию глобального npm.

Запуск npm install -g yarn не работает

npm предотвращает случайное переопределение бинарников Corepack при выполнении глобальной установки. Чтобы избежать этой проблемы, рассмотрите один из следующих вариантов:

• Не выполняйте эту команду; Corepack всё равно предоставит бинарники менеджера пакетов и гарантирует, что запрошенные версии всегда будут доступны, поэтому явная установка менеджеров пакетов не нужна.

• Добавьте флаг --force к npm install; это сообщит npm, что переопределение бинарников допустимо, но вы при этом уничтожите бинарники Corepack. (Чтобы вернуть их, выполните corepack enable.)