Установщики
Подробная информация о том, как работают установщики и как создать собственный пользовательский установщик/распространения для размещённых установок.
Текущие установщики
По состоянию на Volta 0.7.0 все официальные установщики работают одинаково:
- Распаковывают двоичные файлы Volta
- Вызывают
volta setup
с использованием распакованного двоичного файлаvolta
(для получения дополнительной информации см. volta setup)
Установщик Windows
Установщик Windows распаковывает все двоичные файлы в Program Files\Volta
и добавляет эту папку в системную переменную окружения Path
. Он также создаёт прокладки в этой директории для следующих инструментов:
node
npm
npx
yarn
Установщик Unix
Установщик Unix распаковывает все двоичные файлы в ~/.volta/bin
, поэтому они устанавливаются только для конкретного пользователя.
Пропуск настройки Volta
Если вы хотите запустить установщик, но не хотите, чтобы volta setup
изменил ваши файлы конфигурации скриптов, вы можете передать опцию --skip-setup
установщику:
curl https://get.volta.sh | bash -s -- --skip-setup
WARNING
В настоящее время мы не поддерживаем пропуск volta setup
в Windows.
Github CI
Для удобства мы предоставляем пользовательский Github action, который автоматически загрузит Volta, кэширует его и загрузит инструменты закреплённых версий из package.json
вашего проекта.
Установка старых версий
Скрипт установщика по умолчанию, предоставляемый get.volta.sh, поддерживает установку только Volta 1.1.0 и выше. Если вы хотите установить более старую версию, вы можете установить её в Unix, используя следующий скрипт, заменив 1.0.8
на версию, которую вы хотите установить:
curl https://raw.githubusercontent.com/volta-cli/volta/8f2074f423c65405dfba9858d9bcf393c38ffb45/dev/unix/volta-install.sh | bash -s -- --version 1.0.8
Для Windows вы можете загрузить и установить файл установщика .msi
для конкретной версии.
WARNING
Volta не поддерживает понижение версии, поэтому для понижения версии вам нужно полностью удалить Volta, а затем установить более низкую версию.
Пользовательские установщики
Чтобы создать пользовательский установщик/метод распространения, есть два обязательных шага и один необязательный:
Распространение двоичных файлов
Сами двоичные файлы должны быть доставлены на целевую машину. volta.manifest
в файлах релиза перечислит необходимые двоичные файлы. По состоянию на Volta 0.7.0 необходимые файлы:
volta[.exe]
volta-shim[.exe]
volta-migrate[.exe]
Все эти двоичные файлы должны быть распространены в одной директории, и эта директория должна быть в PATH
, чтобы вызовы команды volta
работали.
Директория прокладок
Директория прокладок Volta также должна быть добавлена в PATH
, чтобы прокладки также работали как ожидается. Директория прокладок находится в $VOLTA_HOME/bin
(%VOLTA_HOME%\bin
в Windows), где VOLTA_HOME
по умолчанию:
~/.volta
в Unix%LOCALAPPDATA%\Volta
в Windows
Обновления PATH могут управляться вручную, если это необходимо, или можно вызвать volta setup
(как это делают официальные установщики, как описано выше).
Пользовательская основная директория Volta (необязательно)
Если вы хотите использовать другую директорию для данных Volta, отличную от стандартного VOLTA_HOME
, перечисленного в предыдущем разделе, вам нужно установить переменную окружения VOLTA_HOME
в эту директорию. Если эта переменная установлена, volta setup
будет по-прежнему работать правильно для пользовательской директории данных.