dotnet tool install

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

Имя.

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

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

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

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

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

dotnet tool install -h|--help

Description

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

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

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

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

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

ОС Путь
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

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

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

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

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

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

Ссылки на локальные инструменты добавляются в файл dotnet-tools.json в каталоге конфигурации в текущем каталоге. Если файл манифеста еще не существует, создайте его с помощью --create-manifest-if-needed параметра или выполнив следующую команду:

dotnet new tool-manifest

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

Аргументы

  • PACKAGE_NAME

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

Параметры

  • --allow-downgrade

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

  • -a|--arch <ARCHITECTURE>

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

  • --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, средство автоматически создает манифест. Он выбирает папку для манифеста следующим образом:

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

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

  • --disable-parallel

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

  • --framework <FRAMEWORK>

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

  • -g|--global

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

  • -?|-h|--help

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

  • --ignore-failed-sources

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

  • --interactive

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

  • --local

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

  • --no-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.0, --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 dotnetsay

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

  • dotnet tool install -g --verbosity minimal

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

См. также