Переменные среды интерфейса командной строки NuGet
Поведение интерфейса командной строки nuget.exe можно настроить с помощью ряда переменных среды, которые влияют на nuget.exe на уровне компьютера, пользователя или процесса. Переменные среды всегда переопределяют любые параметры в NuGet.Config файлах, позволяя серверам сборки изменять соответствующие параметры без изменения файлов.
Как правило, параметры, указанные непосредственно в командной строке или в файлах конфигурации NuGet, имеют приоритет, но есть несколько исключений, таких как FORCE_NUGET_EXE_INTERACTIVE. Если вы обнаружите, что nuget.exe ведет себя по-разному между разными компьютерами, переменная среды может быть причиной. Например, Azure веб-приложения Kudu (используемое во время развертывания) NUGET_XMLDOC_MODE установить, чтобы ускорить восстановление пакета и сэкономить место на диске.
Интерфейс командной строки NuGet использует MSBuild для чтения файлов проекта. Все переменные среды доступны как свойства во время оценки MSBuild. Список свойств, задокументированных в пакете NuGet и восстановлении в качестве целевых объектов MSBuild, также можно задать в качестве переменных среды.
| «Переменная» | Description | Примечания |
|---|---|---|
| http_proxy | Прокси-сервер HTTP, используемый для операций HTTP NuGet. | Это будет указано как http://<username>:<password>@proxy.com. |
| no_proxy | Настраивает домены для обхода с помощью прокси-сервера. | Указано в качестве доменов, разделенных запятыми (,). |
| EnableNuGetPackageRestore | Помечайте, если NuGet неявно должен предоставить согласие, если это требуется пакетом при восстановлении. | Указанный флаг обрабатывается как true или 1, любое другое значение, которое рассматривается как флаг не задан. |
| NUGET_CLI_LANGUAGE | Изменение языка вывода nuget.exe | Доступно в версиях 6.5 и более поздних версий. Поддерживаемые значения поддерживаются имена языков Visual Studio: zh-cn, cs-czfr-frde-dees-esit-itja-jpen-uszh-twpl-plpt-brko-krru-ruи .tr-tr |
| NUGET_EXE_NO_PROMPT | Запрещает exe запрашивать учетные данные. | Любое значение, за исключением null или пустой строки, будет рассматриваться как этот флаг set/true. |
| NUGET_MAX_RETRY_AFTER_DELAY_SECONDS | Максимальная длительность между повторными попытками, если http-ответ содержит заголовок Retry-After | Если NUGET_OBSERVE_RETRY_AFTER включен (как по умолчанию) и HTTP-ответ содержит заголовок Retry-After, эта переменная среды задает максимальную длительность ожидания. Обратите внимание, что повторная попытка может предоставить длительность (разностную) или метку времени (дата). Если сервер возвращает метку времени, а часы компьютера не синхронизированы с сервером, вычисляемая длительность может быть очень длинной (или отрицательной). |
| FORCE_NUGET_EXE_INTERACTIVE | Глобальная переменная среды для принудительного интерактивного режима. | Любое значение, за исключением null или пустой строки, будет рассматриваться как этот флаг set/true. |
| NUGET_PACKAGES | Путь к использованию для папки глобальных пакетов, как описано в разделе "Управление глобальными пакетами и папками кэша". | Указан абсолютный путь. |
| NUGET_FALLBACK_PACKAGES | Глобальные резервные пакеты папок. | Абсолютные пути к папкам, разделенные точкой с запятой (;). |
| NUGET_HTTP_CACHE_PATH | Путь к использованию для папки http-cache , как описано в разделе "Управление глобальными пакетами и папками кэша". | Указан абсолютный путь. |
| NUGET_OBSERVE_RETRY_AFTER | Отказ от использования http-ответа Retry-After delay durations | До NuGet 6.5 NuGet повторит все неудачные запросы с той же стратегией резервного копирования. Начиная с NuGet 6.5, NuGet по умолчанию будет использовать период задержки Retry-After, предоставленный сервером. Установите эту переменную среды, чтобы false игнорировать заголовок ответа Retry-After. См. также NUGET_MAX_RETRY_AFTER_DELAY_SECONDS |
| NUGET_RESTORE_MSBUILD_ARGS | Задает дополнительные аргументы MSBuild. | Передайте аргументы, идентичные способу передачи их в msbuild.exe. Пример задания свойства проекта Foo из командной строки значением "Строка" будет /p:Foo=Bar |
| NUGET_RETRY_HTTP_429 | Изменение поведения повторных попыток в ответах HTTP 429 | До NuGet 6.5 NuGet не будет повторять запросы, которые приводят к HTTP 429 на 408. Значением по умолчанию является true, и эта переменная среды может быть задана, чтобы false выбрать более старое поведение NuGet (не повторяйте запрос) |
| NUGET_RESTORE_MSBUILD_VERBOSITY | Задает детализацию журнала MSBuild. | Значение по умолчанию тихо ("/v:q"). Возможные значения q[uiet], m[inimal], n[ormal], d[etailed], и diag[nostic]. |
| NUGET_SHOW_STACK | Определяет, должно ли отображаться полное исключение (включая трассировку стека) пользователю. | Указано как true или false (по умолчанию). |
| NUGET_UPDATEFILETIME_MAXRETRIES | Задает количество попыток NuGet задать метку времени файла при извлечении пакетов. | В антивирусном программном обеспечении Windows может временно открывать файлы, предотвращая изменение метки времени NuGet. NuGet использует экспоненциальный откат, в котором длительность ожидания между попытками Math.Pow(2, retryNumber)составляет. Максимальное число повторных попыток по умолчанию равно 9, то есть общая длительность ожидания по умолчанию до сбоя будет примерно одна секунда. |
| NUGET_XMLDOC_MODE | Определяет способ обработки извлечения XML-файлов XML-документации сборок. | Поддерживаемые режимы пропускаются (не извлекают XML-файлы документации), сжимают (хранят XML-файлы документов в виде zip-архива) или нет (по умолчанию обрабатывают XML-файлы документации как обычные файлы). |
| NUGET_CERT_REVOCATION_MODE | Определяет, как состояние отзыва проверка сертификата, используемого для подписи пакета, выполняется при установке или восстановлении подписанного пакета. Если параметр не задан, по умолчанию используется onlineзначение . |
Возможные значения в сети (по умолчанию) в автономном режиме. Связанные с NU3028 |
| NUGET_ENABLE_ENHANCED_HTTP_RETRY | Включает или отключает расширенную повторную попытку HTTP в NuGet. | Возможные значения: true (по умолчанию) или false. |
| NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT | Настраивает максимальное количество попыток при включении расширенных повторных попыток при получении HTTP-подключения. | Число, представляющее количество повторных попыток, значение 6по умолчанию . |
| NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS | Настраивает время ожидания в миллисекундах перед повтором HTTP-подключения при включении расширенных повторных попыток. | Число миллсекунд для ожидания, значение по умолчанию равно 1000. |
| NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING | Определяет, используется ли Netwonsoft.Json для синтаксического анализа файла ресурсов во время восстановления. |
Возможные значения: true или false (по умолчанию). |