команда update (Интерфейс командной строки NuGet)
Область применения: потребление пакетов • Поддерживаемые версии: все
При этом все пакеты в проекте, использующем файл packages.config
, обновляются до последней доступной версии. Перед выполнением инструкции рекомендуется выполнить "восстановление".update
(Чтобы обновить отдельный пакет, используйте nuget install
без указания номера версии, в этом случае NuGet устанавливает последнюю версию.)
Примечание. update
Не работает с интерфейсом командной строки под управлением Mono (Mac OSX или Linux) или при использовании формата PackageReference.
Команда update
также обновляет ссылки на сборки в файле проекта, если эти ссылки уже существуют. Если обновленный пакет содержит добавленную сборку, новая ссылка не добавляется. Новые зависимости пакетов также не добавляют ссылки на сборки. Чтобы включить эти операции в состав обновления, обновите пакет в Visual Studio с помощью пользовательского интерфейса диспетчер пакетов или консоли диспетчер пакетов.
Эта команда также может использоваться для обновления nuget.exe себя с помощью флага -self .
Использование
nuget update <configPath> [options]
где <configPath>
определяет packages.config
файл или файл решения, в котором перечислены зависимости проекта.
Параметры
-ConfigFile
Файл конфигурации NuGet для применения. Если не указано,
%AppData%\NuGet\NuGet.Config
используется (Windows) или~/.nuget/NuGet/NuGet.Config
~/.config/NuGet/NuGet.Config
(Mac/Linux).-DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]
Указывает версию используемых пакетов зависимостей, которая может быть одной из следующих:
- Самый низкий (по умолчанию): самая низкая версия
- HighestPatch: версия с наименьшим основным, наименьшим дополнительным, самым высоким исправлением
- Самый высокий Минор: версия с самым низким основным, самым высоким дополнительным, самым высоким исправлением
- Самый высокий: самая высокая версия
- Игнорировать: пакеты зависимостей не будут использоваться
-FileConflictAction [PromptUser, Overwrite, Ignore]
Указывает действие по умолчанию, когда файл из пакета уже существует в целевом проекте. Установите значение
Overwrite
"Всегда перезаписывать файлы". Установите дляIgnore
пропуска файлов.Действие
PromptUser
, используемое по умолчанию, будет запрашивать каждый конфликтующий файл, еслиOverwriteAll
он не указан илиIgnoreAll
не указан, что будет применяться ко всем оставшимся файлам.-ForceEnglishOutput
(3.5+) Заставляет nuget.exe работать с использованием инвариантной и английской культуры.
-?|-help
Отображает сведения о справке для команды.
-Id
Задает список идентификаторов пакетов для обновления.
-MSBuildPath
(4.0+) Указывает путь MSBuild для использования с командой, принимая приоритет над
-MSBuildVersion
.-MSBuildVersion
(3.2+) Указывает версию MSBuild для использования с этой командой. Поддерживаемые значения: 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. По умолчанию выбирается MSBuild в пути, в противном случае она по умолчанию используется для самой высокой установленной версии MSBuild.
-NonInteractive
Подавляет запросы на ввод или подтверждение пользователя.
-PreRelease
Разрешает обновление до предварительной версии. Этот флаг не требуется при обновлении пакетов предварительной версии, которые уже установлены.
-RepositoryPath
Указывает локальную папку, в которой установлены пакеты.
-Safe
Указывает, что установлены только обновления с самой высокой версией, доступной в той же основной и дополнительной версии, что и установленный пакет.
-Self
nuget.exe
Обновления до последней версии.-Source
можно использовать, однако все остальные аргументы игнорируются. Если источник не указан, проверкаnuget.org
обновления независимо отNuGet.Config
параметров.-Source
Указывает список источников пакетов (в качестве URL-адресов), используемых для обновлений. Если не указано, команда использует источники, предоставляемые в файлах конфигурации, см . общие конфигурации NuGet.
-Verbosity [normal|quiet|detailed]
Указывает объем сведений, отображаемых в выходных данных:
normal
(по умолчанию)quiet
илиdetailed
.-Version
При использовании с одним идентификатором пакета указывает версию пакета для обновления.
Примеры
nuget update
# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14
nuget update -safe
nuget update -self