Установите пакет SDK для репозитория с помощью dotnetup

Note

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

Если канал SDK не указан, dotnetup sdk install выполняет поиск от текущего каталога к корню файловой системы. Он использует последний существующий global.json файл. Если этот файл имеет неверный формат, команда завершается ошибкой вместо поиска родительского каталога. Если файл не существует, используется latest.

Установите требование репозитория

В каталоге репозитория выполните следующую команду:

dotnetup sdk install

Для этого global.json файла dotnetup отслеживает полосу компонентов 10.0.1xx:

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

global.json путь является источником хранимого требования. Вы можете просмотреть исходную и установленную версию с помощью:

dotnetup list

Понимание сопоставления переноса вперёд

Для версии SDK, такой как 10.0.103, dotnetup сопоставляет rollForward следующим образом:

Значение rollForward Сохранённый канал dotnetup
Опущен или latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor или major Точная версия 10.0.103

Точное требование точно определено и не изменяется dotnetup update. Свойство allowPrerelease не влияет на канал, который определяет dotnetup.

Использование sdk.paths

Если global.json содержит sdk.paths, dotnetup использует первый путь, если параметр --install-path отсутствует. Он определяет относительное значение из каталога, содержащего global.json.

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

  1. --install-path
  2. Первая sdk.paths запись
  3. Корневой каталог установки .NET по умолчанию, управляемой dotnetup

Ограничения предварительной версии

Текущая общедоступная предварительная версия сборки обрабатывает первую sdk.paths запись как путь. Он не интерпретирует $host$ как сторожевой маркер и не пропускает пустые записи. Чтобы использовать корневой каталог установки dotnetup, управляемый по умолчанию, опустите sdk.paths или задайте --install-path явным образом.

Обновить global.json

После изменения sdk.version или rollForward запустите dotnetup sdk install из каталога репозитория, чтобы применить новое требование. Прежде чем сборщик мусора обновляет изменившиеся global.json исходники, dotnetup sdk update обрабатывает сохранённые требования зависимостей, поэтому его первый проход по-прежнему может использовать предыдущее требование.

Чтобы установить последнюю версию в производном канале и записать эту версию обратно в global.json, выполните следующую команду:

dotnetup sdk install --update-global-json

Позже обновите все отслеживаемые требования к репозиторию и их файлы следующим образом:

dotnetup sdk update --update-global-json

Обновление изменяет только sdk.version. Он сохраняет существующее форматирование, другие свойства и обнаруженную кодировку текста.

Удалить соответствующие требования к репозиторию

Команда uninstall удаляет каждую соответствующую globaljson спецификацию в выбранном корневом каталоге установки. Он не ориентирован на один репозиторий. Чтобы удалить соответствующие требования из корня по умолчанию, выполните следующую команду:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Чтобы выбрать пользовательский корневой каталог установки, добавьте --install-path:

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

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

См. также

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