Dela via

Arbetsflöde för paketförbrukning

Mellan nuget.org och privata paketgallerier som din organisation kan upprätta kan du hitta tiotusentals mycket användbara paket att använda i dina appar och tjänster. Men oavsett källa följer användning av ett paket samma allmänna arbetsflöde.

Flöde för att gå till en paketkälla, hitta ett paket, installera det i ett projekt och sedan lägga till en using-instruktion och anrop till paket-API:et

* Endast Visual Studio dotnet.exe. Kommandot nuget install ändrar inte projektfilerna eller packages.config-filen; posterna måste hanteras manuellt.

Mer information finns i Hitta och välja paket och Vad händer när ett paket installeras?.

NuGet kommer ihåg identitets- och versionsnumret för varje installerat paket och registrerar det i antingen projektfilen (med PackageReference) eller packages.config, beroende på projekttyp och din version av NuGet. Med NuGet 4.0+ föredras PackageReference, även om detta kan konfigureras i Visual Studio via Package Manager-användargränssnittet. I vilket fall som helst kan du titta i rätt fil när som helst för att se den fullständiga listan över beroenden för projektet.

Tips/Råd

Det är klokt att alltid kontrollera licensen för varje paket som du tänker använda i din programvara. På nuget.org hittar du en licensinformationslänk till höger på varje pakets beskrivningssida. Om ett paket inte anger licensvillkor kontaktar du paketägaren direkt via länken Kontaktägare på paketsidan. Microsoft licensierar inte någon immateriell egendom till dig från tredjepartspaketleverantörer och ansvarar inte för information från tredje part.

När du installerar paket kontrollerar NuGet vanligtvis om paketet redan är tillgängligt från cacheminnet. Du kan rensa cacheminnet manuellt från kommandoraden enligt beskrivningen i Hantera globala paket och cachemappar.

NuGet ser också till att målramverken som stöds av paketet är kompatibla med ditt projekt. Om paketet inte innehåller kompatibla sammansättningar visar NuGet ett fel. Se Lösa inkompatibla paketfel.

När du lägger till projektkod till en källlagringsplats inkluderar du vanligtvis inte NuGet-paket. De som senare klonar lagringsplatsen eller på annat sätt hämtar projektet, inklusive byggagenter i system som Visual Studio Team Services, måste återställa de nödvändiga paketen innan de kör en version:

Flöde för att återställa NuGet-paket genom att klona ett repo och använda ett återställningskommando

Paketåterställning använder informationen i projektfilen eller packages.config för att installera om alla beroenden. Observera att det finns skillnader i processen som beskrivs i Beroendeupplösning. Diagrammet ovan visar inte heller något återställningskommando för Package Manager-konsolen, eftersom om du är med konsolen är du redan i kontexten för Visual Studio, som vanligtvis återställer paket automatiskt och tillhandahåller kommandot på lösningsnivå som det visas.

Ibland är det nödvändigt att installera om paket som redan ingår i ett projekt, vilket också kan installera om beroenden. Det här är enkelt att göra med nuget reinstall kommandot eller NuGet Package Manager-konsolen. Mer information finns i Installera om och uppdatera paket.

Slutligen drivs NuGets beteende av NuGet.Config filer. Flera filer kan användas för att centralisera vissa inställningar på olika nivåer, enligt beskrivningen i Konfigurera NuGet-beteende.

Sätt att installera ett NuGet-paket

NuGet-paket hämtas och installeras med någon av metoderna i följande tabell.

Tool Platforms Description
dotnet CLI Allt CLI-verktyg för .NET Core- och .NET Standard-bibliotek och för SDK-liknande projekt som riktar in sig på .NET Framework (se SDK-attribut). Hämtar paketet som identifieras av <package_name> och lägger till en referens till projektfilen. Hämtar och installerar även beroenden.
Visual Studio Windows och Mac Innehåller ett användargränssnitt där du kan bläddra, välja och installera paket och deras beroenden i ett projekt från en angiven paketkälla. Lägger till referenser till installerade paket i projektfilen.
Package Manager-konsolen (Visual Studio) Endast Windows Hämtar och installerar paketet som identifieras av <package_name> från en vald källa till ett angivet projekt i lösningen och lägger sedan till en referens till projektfilen. Hämtar och installerar även beroenden.
nuget.exe CLI Allt CLI-verktyg för .NET Framework-bibliotek och icke-SDK-liknande projekt som riktar sig till .NET Standard-bibliotek. Hämtar paketet som identifieras av <package_name> och expanderar dess innehåll till en mapp i den aktuella katalogen. Kan också hämta alla paket som anges i en packages.config fil. Hämtar och installerar även beroenden, men gör inga ändringar i projektfiler eller packages.config.
  • Last updated on