Variabili di ambiente dell'interfaccia della riga di comando nuGet

  • Articolo

Il comportamento dell'interfaccia della riga di comando di nuget.exe può essere configurato tramite una serie di variabili di ambiente, che influiscono nuget.exe a livello di computer, utente o processo. Le variabili di ambiente eseguono sempre l'override di tutte le impostazioni nei NuGet.Config file, consentendo ai server di compilazione di modificare le impostazioni appropriate senza modificare alcun file.

In generale, le opzioni specificate direttamente nella riga di comando o nei file di configurazione NuGet hanno la precedenza, ma esistono alcune eccezioni, ad esempio FORCE_NUGET_EXE_INTERACTIVE. Se si rileva che nuget.exe si comporta in modo diverso tra computer diversi, una variabile di ambiente potrebbe essere la causa. Ad esempio, Azure App Web Kudu (usato durante la distribuzione) ha NUGET_XMLDOC_MODE impostato per ignorare le prestazioni di ripristino dei pacchetti e risparmiare spazio su disco.

L'interfaccia della riga di comando di NuGet usa MSBuild per leggere i file di progetto. Tutte le variabili di ambiente sono disponibili come proprietà durante la valutazione di MSBuild. L'elenco delle proprietà documentate nel pacchetto NuGet e il ripristino come destinazioni MSBuild possono essere impostate anche come variabili di ambiente.

Variabile Descrizione Note
http_proxy Proxy HTTP usato per le operazioni HTTP NuGet. Questo valore viene specificato come http://<username>:<password>@proxy.com.
no_proxy Configura i domini per ignorare l'uso del proxy. Specificato come domini separati da virgola (,).
EnableNuGetPackageRestore Flag per se NuGet deve concedere in modo implicito il consenso se richiesto dal pacchetto al ripristino. Il flag specificato viene considerato true o 1, qualsiasi altro valore considerato come flag non impostato.
NUGET_CLI_LANGUAGE Modifiche nuget.exe lingua di output Disponibile nelle versioni 6.5 e successive. I valori supportati sono i nomi delle impostazioni locali delle lingue di Visual Studio: zh-cn, es-escs-czzh-twen-us, it-itja-jpde-defr-frpl-plpt-brko-krru-rue .tr-tr
NUGET_EXE_NO_PROMPT Impedisce all'exe di richiedere le credenziali. Qualsiasi valore tranne null o una stringa vuota verrà considerato come questo flag impostato/true.
NUGET_MAX_RETRY_AFTER_DELAY_edizione Standard CONDS Durata massima tra i tentativi quando la risposta HTTP contiene l'intestazione Retry-After Quando NUGET_OB edizione Standard RVE_RETRY_AFTER è abilitato (come per impostazione predefinita) e una risposta HTTP contiene un'intestazione Retry-After, questa variabile di ambiente imposta la durata massima che verrà attesa. Si noti che Retry-After può fornire una durata (delta) o un timestamp (data). Se il server restituisce un timestamp e l'orologio del computer non è sincronizzato con il server, la durata calcolata potrebbe essere molto lunga (o negativa).
FORCE_NUGET_EXE_INTERACTIVE Variabile di ambiente globale per forzare la modalità interattiva. Qualsiasi valore tranne null o una stringa vuota verrà considerato come questo flag impostato/true.
NUGET_PACKAGES Percorso da usare per la cartella global-packages , come descritto in Gestione dei pacchetti globali e delle cartelle della cache. Specificato come percorso assoluto.
NUGET_FALLBACK_PACKAGES Cartelle di pacchetti di fallback globali. Percorsi di cartelle assoluti separati da punto e virgola (;).
NUGET_HTTP_CACHE_PATH Percorso da usare per la cartella http-cache , come descritto in Gestione dei pacchetti globali e delle cartelle della cache. Specificato come percorso assoluto.
NUGET_OB edizione Standard RVE_RETRY_AFTER Rifiutare esplicitamente l'uso del messaggio di risposta HTTP Retry-After delay durations Prima di NuGet 6.5, NuGet ritentava tutte le richieste non riuscite con la stessa strategia di back-off. A partire da NuGet 6.5, NuGet userà per impostazione predefinita il periodo di ritardo Retry-After fornito dal server. Impostare questa variabile di ambiente su false per ignorare l'intestazione della risposta Retry-After. Vedere anche NUGET_MAX_RETRY_AFTER_DELAY_edizione Standard CONDS
NUGET_RESTORE_MSBUILD_ARGS Imposta argomenti MSBuild aggiuntivi. Passare argomenti identici a come passarli a msbuild.exe. Un esempio di impostazione di una proprietà del progetto Foo dalla riga di comando al valore Bar sarà /p:Foo=Bar
NUGET_RETRY_HTTP_429 Modificare il comportamento dei tentativi nelle risposte HTTP 429 Prima di NuGet 6.5, NuGet non ritentava le richieste che generano HTTP 429 su 408. Il valore predefinito è truee questa variabile di ambiente può essere impostata su false per acconsentire esplicitamente al comportamento NuGet precedente (non ripetere la richiesta)
NUGET_RESTORE_MSBUILD_VERBOSITY Imposta il livello di dettaglio del log di MSBuild. Il valore predefinito è silenzioso ("/v:q"). Valori possibili q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic].
NUGET_SHOW_STACK Determina se l'eccezione completa (inclusa l'analisi dello stack) deve essere visualizzata all'utente. Specificato come true o false (impostazione predefinita).
NUGET_UPDATEFILETIME_MAXRETRIES Imposta il numero di tentativi che NuGet tenterà di impostare il timestamp del file durante l'estrazione dei pacchetti. Nel software antivirus Windows potrebbe aprire temporaneamente i file, impedendo a NuGet di modificare il timestamp. NuGet usa un back-off esponenziale in cui la durata di attesa tra i tentativi è Math.Pow(2, retryNumber). Il numero massimo di tentativi predefinito è 9, ovvero la durata totale di attesa predefinita prima dell'errore sarà di circa un secondo.
NUGET_XMLDOC_MODE Determina la modalità di gestione dell'estrazione dei file di documentazione XML degli assembly. Le modalità supportate sono skip (non estrarre file di documentazione XML), comprimere (archiviare file di documenti XML come archivio ZIP) o nessuno (impostazione predefinita, trattare i file di documentazione XML come file normali).
NUGET_CERT_REVOCATION_MODE Determina il modo in cui il controllo dello stato di revoca del certificato usato per firmare un pacchetto viene eseguito quando viene installato o ripristinato un pacchetto firmato. Se non è impostato, il valore predefinito è online. Valori possibili online (impostazione predefinita), offline. Correlato a NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY Abilita o disabilita i tentativi HTTP avanzati in NuGet. I valori possibili sono true (impostazione predefinita) o false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Configura il numero massimo di tentativi di una connessione HTTP quando sono abilitati nuovi tentativi avanzati. Numero che rappresenta il numero di tentativi da eseguire, il valore predefinito è 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLI edizione Standard CONDS Configura la quantità di tempo di attesa in millisecondi prima di ritentare una connessione HTTP quando sono abilitati nuovi tentativi avanzati. Numero di millsecondi da attendere, il valore predefinito è 1000.
NUGET_EXPERIMENTAL_U edizione Standard_NJ_FOR_FILE_PARSING Determina se viene usato o meno Netwonsoft.Json per l'analisi del file di asset durante il ripristino I valori possibili sono true o false (impostazione predefinita).