Начало работы с dotnetup

Note

dotnetup находится в общедоступной предварительной версии. Его функции и поведение могут измениться до общей доступности.

dotnetup — это кроссплатформенный диспетчер наборов инструментов для пользовательских установок .NET. Он устанавливает, обновляет и удаляет пакеты SDK и среды выполнения .NET без использования системного диспетчера пакетов.

Prerequisites

  • Одна из следующих операционных систем и архитектур:

    Операционная система Architectures
    Windows x64, Arm64
    macOS x64, Arm64
    Linux (glibc) x64, Arm64
    Linux (musl), например Alpine Linux x64, Arm64

  • Терминал.

  • Bash в macOS или Linux или PowerShell на Windows, чтобы запустить скрипт скачивания.

  • В macOS или Linux curl или wget для скачивания файлов, а sha512sum или shasum — для их проверки.

dotnetupимеет те же требования к операционной системе, что и среда выполнения .NET. Сведения о требованиях, относящихся к ОС, см. в разделе Установка .NET в Windows, Установка .NET в macOS или Установка .NET в Linux.

Important

В Windows программа установки по умолчанию использует режим доступа everywhere. Этот режим:

  • Требуется повышение прав для обновления системы PATH.
  • Заставляет установку, управляемую dotnetup, иметь приоритет над установками .NET на уровне компьютера, такими как те, которые устанавливает Visual Studio. Проекты и приложения, которым требуется пакет SDK на уровне компьютера или среда выполнения, которые также не устанавливаются с помощью dotnetup, не собираются и не запускаются.
  • Изменения в системе PATH, которые применяются ко всем пользователям. Процессы с повышенными привилегиями, запущенные другими пользователями, могут обнаружить .NET в вашем профиле пользователя.

Чтобы избежать этих эффектов, выберите режим доступа none или shell во время установки. При выборе everywhere перенесите существующие установленные версии, когда программа установки предложит это. Дополнительные сведения см. в особенностях режима Everywhere.

Скачать dotnetup

Скрипты загрузки устанавливают последнюю preview сборку по умолчанию. Они проверяют скачанный исполняемый файл с помощью контрольной суммы SHA-512 и устанавливают его в ~/.dotnetup.

На macOS или Linux выполните:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

В Windows выполните следующую команду:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Чтобы установить последнюю daily сборку на macOS или Linux, выполните следующую команду:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Чтобы установить последнюю daily сборку на Windows, выполните следующую команду:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Important

Ежедневные сборки не прошли валидацию релиза и не подписаны кодом. Используйте ежедневные сборки только для кратковременного тестирования.

Скрипты печатают инструкции для добавления dotnetup в PATH. Откройте новый терминал после применения инструкций.

Запустите первоначальную настройку

Запустите интерактивную настройку:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

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

Рекомендуемый режим доступа — everywhere в Windows. В macOS и Linux это shell, когда dotnetup обнаруживает поддерживаемую оболочку, и none в противном случае.

Выберите Нет, настроить установку, чтобы выбрать канал SDK, режим доступа и параметры миграции.

Выберите канал SDK

Канал SDK указывает dotnetup , какой пакет SDK необходимо установить и как обновить его.

Форма канала Example Result
Последняя стабильная версия latest Последний доступный стабильный пакет SDK
Последняя LTS lts Последняя активная стабильная версия SDK с долгосрочной поддержкой
Последняя предварительная версия preview Последняя предварительная версия SDK
Последнее за день daily Последняя доступная ежедневная SDK
Майор 10 Последняя версия SDK для указанной мажорной версии
Основной и дополнительный 10.0 Последний пакет SDK для указанной мажорной и минорной версии
Панель функций 10.0.1xx Последний пакет SDK в указанном диапазоне компонентов
Точная версия 10.0.103 Только указанная версия пакета SDK
Нет базового пакета SDK none Пропустить установку во время установки

Точные версии не изменяются во время обновлений. Для всех допустимых форм см. каналы и версии dotnetup.

Выберите способ доступа к .NET

Режим доступа определяет, как терминалы и приложения находят установку .NET, управляемую dotnetup.

Режим доступа Behavior
none Не изменяет эти переменные среды. Запустите .NET с помощью dotnetup dotnet.
shell Изменяет профиль оболочки для задания этих переменных среды. Процессы, запущенные из этой оболочки, используют пакеты SDK и среды выполнения .NET, установленные dotnetup.
everywhere Изменяет системную переменную PATH и задает переменную среды уровня пользователя DOTNET_ROOT. Доступно только в Windows.

Дополнительные сведения и рекомендации для режима everywhere см. в конфигурации среды dotnetup.

Перенос существующих установок

Программа установки может предложить перенести существующие общесистемные установки .NET SDK и среды выполнения .NET в установку, управляемую dotnetup. Сведения о том, почему миграция особенно важна в режиме , см. в разделе everywhere.

Проверка установки

Откройте новый терминал после того, как настройка изменит ваше окружение.

Для режима shell или everywhere выполните следующую команду:

dotnet --version
dotnetup list

Для режима none выполните:

dotnetup dotnet -- --version
dotnetup list

Запустите dotnetup init еще раз, чтобы изменить настройки.

  • Последнее обновление: