dotnet tool install - установка инструмента dotnet

Эта статья относится к: ✔️ пакету SDK для .NET 6 и более поздних версий

Имя.

dotnet tool install устанавливает указанное средство .NET на компьютер.

Краткие сведения

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Описание

Команда dotnet tool install предоставляет способ установки средств .NET на компьютере. Чтобы использовать команду, укажите один из следующих параметров установки:

• Чтобы установить глобальный инструмент в расположение по умолчанию, используйте параметр --global.
• Чтобы установить глобальный инструмент в расположение, указанное пользователем, используйте параметр --tool-path.
• Чтобы установить локальный инструмент, пропустите параметры --global и --tool-path.

Предупреждение

Убедитесь, что указанный каталог с параметром --tool-path является безопасным. Средства, установленные в этом расположении, можно выполнять напрямую, поэтому использование ненадежного или общего пути может привести к рискам безопасности.

Расположения установки

Глобальные средства

Глобальные средства устанавливаются в следующие каталоги по умолчанию при выборе параметра -g или --global:

ОС	Путь
Linux или macOS	$HOME/.dotnet/tools
Виндоус	%USERPROFILE%\.dotnet\tools

Исполняемые файлы создаются в этих папках для каждого глобально установленного средства, хотя фактические двоичные файлы инструментов вложены глубоко в общий .store каталог.

Примечание.

В Linux после установки средства командной строки с dotnet toolпомощью средства средство можно выполнить только из $HOME/.dotnet/tools пути. Чтобы сделать исполняемый файл средства из любого каталога, обновите PATH переменную среды. Чтобы сделать обновленную PATH переменную среды постоянной в оболочке, обновите параметры оболочки. Для Bashэтого файла $HOME/.bashrc .

Инструменты --tool-path

Средства с явными путями инструментов хранятся везде, где вы указали --tool-path параметр для указания. Они хранятся так же, как глобальные инструменты: исполняемый двоичный файл с фактическими двоичными файлами в одноуровневом .store каталоге.

Локальные средства

Локальные средства хранятся в глобальном каталоге NuGet, независимо от того, что вы задали. В каждом локальном инструменте есть файлы $HOME/.dotnet/toolResolverCache схима, указывающие на то, где находятся инструменты в этом расположении.

Ссылки на локальные инструменты добавляются в файл dotnet-tools.json в каталоге конфигурации в текущем каталоге. Начиная с .NET 10, если файл манифеста еще не существует, он создается автоматически. Вы также можете создать его вручную, выполнив следующую команду:

dotnet new tool-manifest

Дополнительные сведения см. в разделе Установка глобального средства.

Аргументы

• PACKAGE_NAME

  Имя или идентификатор пакета NuGet, который содержит устанавливаемое средство .NET.

  Начиная с пакета SDK для .NET 10.0.100, используйте имя и идентификатор и версию, разделенную @ для установки средства .NET.

Параметры

• --allow-downgrade

  Разрешить понижение уровня пакета при установке или обновлении пакета средств .NET. Подавляет предупреждение", "Запрошенная версия x.x.x ниже существующей версии x.x.x".

• --allow-roll-forward

  Доступно начиная с пакета SDK для .NET 9.0. Разрешить инструменту использовать более новую версию среды выполнения .NET, если она не установлена.

• -a|--arch <ARCHITECTURE>

  Указывает целевую архитектуру. Это сокращенный синтаксис для настройки идентификатора среды выполнения (RID), где указанное значение объединяется с RID по умолчанию. Например, если на компьютере win-x64 указать --arch x86, идентификатору RID присваивается значение win-x86. При использовании этого параметра не используйте параметр -r|--runtime. Этот параметр доступен с выпуска .NET 6, предварительная версия 7.

• --add-source <SOURCE>

  Добавляет дополнительный источник пакета NuGet для использования во время установки. Доступ к каналам осуществляется параллельно, а не последовательно в некотором порядке приоритета. Если один и тот же пакет и версия находятся в нескольких каналах, используется самый быстрый канал. Дополнительные сведения см. в разделе Процесс установки пакета NuGet.

• --configfile <FILE>

  Файл конфигурации NuGet (nuget.config), который будет использоваться. Если этот параметр указан, будут использоваться только параметры из этого файла. Если не указано, будет использоваться иерархия файлов конфигурации из текущего каталога. Дополнительные сведения см. в статье Распространенные конфигурации NuGet.

• --create-manifest-if-needed

  Доступно начиная с пакета SDK для .NET 8.

  Применяется к локальным средствам. Чтобы найти манифест, алгоритм поиска выполняет поиск по дереву dotnet-tools.json каталога или .config папке, содержащей dotnet-tools.json файл.

  Если не удается найти манифест средства, а --create-manifest-if-needed параметр задан false, CannotFindAManifestFile возникает ошибка.

  Если не удается найти манифест средства, а --create-manifest-if-needed параметр установлен true (или, в .NET 10 и более поздних версиях, если он не указан), средство автоматически создает манифест. Он выбирает папку для манифеста следующим образом:

  • Найдите дерево каталогов, найдите каталог с вложенной папкой .git . Если он найден, создайте манифест в этом каталоге.
  • Если предыдущий шаг не находит каталог, перейдите к дереву каталогов, найдите каталог с файлом или .sln файлом.git. Если он найден, создайте манифест в этом каталоге.
  • Если ни из двух предыдущих шагов не найдено каталог, создайте манифест в текущем рабочем каталоге.

  Дополнительные сведения о расположении манифестов см. в разделе "Установка локального средства".

  Начиная с .NET 10 манифест создается автоматически, если манифест средств не найден. Это изменение может быть критическим изменением. Вы можете отказаться, передав.--create-manifest-if-needed=false

  Предупреждение

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

• --disable-parallel

  Блокирует параллельное восстановление нескольких проектов.

• --framework <FRAMEWORK>

  Указывает требуемую версию .NET Framework для установки средства. По умолчанию пакет SDK для .NET пытается выбрать наиболее подходящую версию .NET Framework.

• -g|--global

  Указывает, что установка происходит на уровне пользователя. Не может использоваться вместе с параметром --tool-path. Пропуск параметров --global и --tool-path задает установку локального средства.

• --source <SOURCE>

  Указывает источник для пакетов NuGet.

• -?|-h|--help

  Выводит описание использования команды.

• --ignore-failed-sources

  Обрабатывать сбои источников пакетов как предупреждения.

• --interactive

  Позволяет команде остановиться и дождаться, пока пользователь выполнит действие или введет данные. Например, чтобы завершить проверку подлинности.

• --local

  Обновляет средство и манифест локального средства. Не может использоваться вместе с параметром --global или --tool-path.

• --no-cache или --no-http-cache

  Запрещает кэширование пакетов и HTTP-запросов.

• --prerelease

  Включите пакеты предварительной версии.

• --tool-manifest <PATH>

  Путь к файлу манифеста.

• --tool-path <PATH>

  Указывает расположение для установки глобального инструмента. Путь может быть абсолютным или относительным. Если путь не существует, команда пытается создать его. Пропуск параметров --global и --tool-path задает установку локального средства.

• -v|--verbosity <LEVEL>

  Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic]. Дополнительные сведения см. в разделе LoggerVerbosity.

• --version <VERSION_NUMBER>

  Версия средства для установки. По умолчанию устанавливается последняя стабильная версия пакета. Используйте этот параметр для установки предварительной версии или предыдущей версии средства.

  Начиная с .NET 8, --version Major.Minor.Patch относится к определенной основной или дополнительной версии или исправлению, включая незаписанные версии. Чтобы получить последнюю версию определенной основной или дополнительной версии, используйте --version Major.Minor.*.

Примеры

• dotnet tool install -g dotnetsay

  Устанавливает глобальное средство dotnetsay в расположении по умолчанию.

• dotnet tool install dotnetsay --tool-path c:\global-tools

  Устанавливает dotnetsay в качестве глобального инструмента в определенном каталоге Windows.

• dotnet tool install dotnetsay --tool-path ~/bin

  Устанавливает dotnetsay в качестве глобального инструмента в определенном каталоге Linux/macOS.

• dotnet tool install -g dotnetsay --version 2.0.0

  Устанавливает версию 2.0.0 в качестве глобального средства dotnetsay:

• dotnet tool install -g dotnetsay@2.1.7

  Устанавливает версию 2.1.7 dotnetsay как глобальное средство.

• dotnet tool install dotnetsay

  Устанавливает dotnetsay в качестве локального средства для текущего каталога.

• dotnet tool install dotnetsay@2.1.7

  Устанавливает версию 2.1.7 dotnetsay в качестве локального средства для текущего каталога.

• dotnet tool install -g dotnetsay --verbosity minimal

  Устанавливает dotnetsay как глобальное средство с детализацией минимального уровня. Детализация по умолчанию для глобального инструмента является тихой.

• dotnet tool install -g dotnetsay --allow-roll-forward

  Устанавливает dotnetsay как глобальное средство и позволяет запускать его на более новых версиях .NET, если целевая среда выполнения недоступна.

См. также

• Средства .NET
• Руководство. Установка и использование глобального средства .NET с помощью .NET CLI
• Руководство. Установка и использование локального средства .NET с помощью .NET CLI