Condividi tramite

Flusso di lavoro per il consumo dei pacchetti

Tra nuget.org e raccolte di pacchetti privati che l'organizzazione potrebbe stabilire, è possibile trovare decine di migliaia di pacchetti estremamente utili da usare nelle app e nei servizi. Tuttavia, indipendentemente dall'origine, l'utilizzo di un pacchetto segue lo stesso flusso di lavoro generale.

Flusso per passare a una fonte del pacchetto, trovare un pacchetto, installarlo in un progetto, quindi aggiungere un'istruzione 'using' e chiamare l'API del pacchetto

* Visual Studio e dotnet.exe solo. Il nuget install comando non modifica i file di progetto o il packages.config file. Le voci devono essere gestite manualmente.

Per altri dettagli, vedere Ricerca e scelta di pacchetti e Cosa accade quando viene installato un pacchetto?

NuGet memorizza l'identità e il numero di versione di ogni pacchetto installato, registrandolo nel file di progetto (usando PackageReference) o packages.config, a seconda del tipo di progetto e della versione di NuGet. Con NuGet 4.0+, PackageReference è preferibile, anche se questa opzione è configurabile in Visual Studio tramite l'interfaccia utente di Gestione pacchetti. In ogni caso, è possibile esaminare il file appropriato in qualsiasi momento per visualizzare l'elenco completo delle dipendenze per il progetto.

Suggerimento

È prudente controllare sempre la licenza per ogni pacchetto che si intende usare nel software. In nuget.org trovi un collegamento Informazioni sulla licenza sul lato destro della pagina di descrizione di ogni pacchetto. Se un pacchetto non specifica le condizioni di licenza, contattare il proprietario del pacchetto direttamente usando il collegamento Contatta proprietari nella pagina del pacchetto. Microsoft non concede in licenza alcuna proprietà intellettuale ai provider di pacchetti di terze parti e non è responsabile delle informazioni fornite da terze parti.

Durante l'installazione dei pacchetti, NuGet controlla in genere se il pacchetto è già disponibile dalla cache. È possibile cancellare manualmente questa cache dalla riga di comando, come descritto in Gestione dei pacchetti globali e delle cartelle della cache.

NuGet assicura inoltre che i framework di destinazione supportati dal pacchetto siano compatibili con il progetto. Se il pacchetto non contiene assembly compatibili, NuGet visualizza un errore. Vedere Risoluzione degli errori di pacchetto incompatibili.

Quando si aggiunge codice di progetto a un repository di origine, in genere non si includono pacchetti NuGet. Coloro che successivamente clonano il repository o acquisiscono il progetto, inclusi gli agenti di compilazione in sistemi come Visual Studio Team Services, devono ripristinare i pacchetti necessari prima di eseguire una compilazione:

Flusso di ripristino dei pacchetti NuGet mediante la clonazione di un repository e l'utilizzo di un comando di ripristino

Ripristino pacchetti utilizza le informazioni nel file di progetto o packages.config per reinstallare tutte le dipendenze. Si noti che esistono differenze nel processo coinvolto, come descritto in Risoluzione delle dipendenze. Inoltre, il diagramma sopra non mostra un comando di ripristino per la Console di Gestione pacchetti, perché se stai usando la Console sei già nel contesto di Visual Studio. Visual Studio, infatti, ripristina automaticamente i pacchetti e offre il comando a livello di soluzione, come illustrato.

In alcuni casi è necessario reinstallare i pacchetti già inclusi in un progetto, che possono anche reinstallare le dipendenze. Questa operazione è facile da eseguire usando il nuget reinstall comando o la console di Gestione pacchetti NuGet. Per informazioni dettagliate, vedere Reinstallazione e aggiornamento dei pacchetti.

Infine, il comportamento di NuGet è basato sui NuGet.Config file. È possibile usare più file per centralizzare determinate impostazioni a livelli diversi, come illustrato in Configurazione del comportamento di NuGet.

Modi per installare un pacchetto NuGet

I pacchetti NuGet vengono scaricati e installati usando uno dei metodi nella tabella seguente.

Tool Platforms Description
Interfaccia della riga di comando dotnet Tutti Strumento dell'interfaccia della riga di comando per le librerie .NET Core e .NET Standard e per i progetti in stile SDK destinati a .NET Framework (vedere Attributo SDK). Recupera il pacchetto identificato da <package_name> e aggiunge un riferimento al file di progetto. Recupera e installa anche le dipendenze.
Visual Studio Windows e Mac Fornisce un'interfaccia utente tramite cui è possibile esplorare, selezionare e installare pacchetti e le relative dipendenze in un progetto da un'origine del pacchetto specificata. Aggiunge riferimenti ai pacchetti installati nel file di progetto.
Console di Gestione pacchetti (Visual Studio) Solo Windows Recupera e installa il pacchetto identificato da <package_name> da un'origine selezionata in un progetto specificato nella soluzione, quindi aggiunge un riferimento al file di progetto. Recupera le dipendenze e le installa.
interfaccia della riga di comando di nuget.exe Tutti Strumento dell'interfaccia della riga di comando per librerie .NET Framework e progetti non in stile SDK destinati alle librerie .NET Standard. Recupera il pacchetto identificato da <package_name> ed espande il relativo contenuto in una cartella nella directory corrente. Può anche recuperare tutti i pacchetti elencati in un packages.config file. Recupera e installa anche le dipendenze, ma non apporta modifiche ai file di progetto o packages.config.
  • Last updated on