Delen via

Werkstroom voor pakketverbruik

Tussen nuget.org en privépakketgalerieën die uw organisatie mogelijk tot stand brengt, kunt u tienduizenden zeer nuttige pakketten vinden die u kunt gebruiken in uw apps en services. Maar ongeacht de bron, het gebruik van een pakket volgt dezelfde algemene werkstroom.

Stroom van naar een pakketrepository gaan, een pakket vinden, dit installeren in een project, vervolgens een using-statement en API-aanroepen toevoegen aan het pakket

* Visual Studio en dotnet.exe alleen. De nuget install opdracht wijzigt geen projectbestanden of het packages.config bestand. Vermeldingen moeten handmatig worden beheerd.

Zie Pakketten zoeken en kiezen voor meer informatie en wat gebeurt er wanneer een pakket wordt geïnstalleerd?

NuGet onthoudt de identiteit en het versienummer van elk geïnstalleerd pakket, waarbij het wordt opgenomen in het projectbestand (met behulp van PackageReference) of packages.config, afhankelijk van het projecttype en uw versie van NuGet. Met NuGet 4.0+ heeft PackageReference de voorkeur, hoewel dit in Visual Studio kan worden geconfigureerd via de gebruikersinterface van Package Manager. In elk geval kunt u op elk gewenst moment in het juiste bestand kijken om de volledige lijst met afhankelijkheden voor uw project weer te geven.

Aanbeveling

Het is verstandig om altijd de licentie te controleren voor elk pakket dat u in uw software wilt gebruiken. Op nuget.org vindt u een koppeling voor licentiegegevens aan de rechterkant van de beschrijvingspagina van elk pakket. Als een pakket geen licentievoorwaarden opgeeft, neemt u rechtstreeks contact op met de eigenaar van het pakket via de koppeling Eigenaren van contactpersonen op de pakketpagina. Microsoft geeft geen licentie voor intellectueel eigendom aan u van externe pakketproviders en is niet verantwoordelijk voor informatie die door derden wordt verstrekt.

Bij het installeren van pakketten controleert NuGet meestal of het pakket al beschikbaar is vanuit de cache. U kunt deze cache handmatig wissen vanaf de opdrachtregel, zoals beschreven in het beheren van de globale pakketten en cachemappen.

NuGet zorgt er ook voor dat de doelframeworks die door het pakket worden ondersteund, compatibel zijn met uw project. Als het pakket geen compatibele assembly's bevat, wordt in NuGet een fout weergegeven. Zie Incompatibele pakketten fouten oplossen.

Wanneer u projectcode toevoegt aan een bronopslagplaats, neemt u doorgaans geen NuGet-pakketten op. Degenen die de opslagplaats later klonen of anderszins het project verkrijgen, inclusief buildagents op systemen zoals Visual Studio Team Services, moeten de benodigde pakketten herstellen voordat een build wordt uitgevoerd:

Proces van het herstellen van NuGet-pakketten door een opslagplaats te klonen en vervolgens de opdracht 'herstellen' te gebruiken

Package Restore gebruikt de informatie in het projectbestand of packages.config om alle afhankelijkheden opnieuw te installeren. Houd er rekening mee dat er verschillen zijn in het proces, zoals beschreven in Afhankelijkheidsoplossing. In het bovenstaande diagram wordt ook geen herstelopdracht weergegeven voor de Package Manager-console, omdat wanneer u de console gebruikt, u zich al in de context van Visual Studio bevindt. Visual Studio herstelt pakketten doorgaans automatisch en biedt de opdracht op oplossingsniveau, zoals weergegeven.

Soms is het nodig om pakketten die al zijn opgenomen in een project opnieuw te installeren, waardoor ook afhankelijkheden opnieuw kunnen worden geïnstalleerd. Dit is eenvoudig te doen met behulp van de nuget reinstall opdracht of de NuGet Package Manager-console. Zie Pakketten opnieuw installeren en bijwerken voor meer informatie.

Ten slotte wordt het gedrag van NuGet aangestuurd door NuGet.Config bestanden. Meerdere bestanden kunnen worden gebruikt om bepaalde instellingen op verschillende niveaus te centraliseren, zoals wordt uitgelegd in Het configureren van NuGet-gedrag.

Manieren om een NuGet-pakket te installeren

NuGet-pakketten worden gedownload en geïnstalleerd met behulp van een van de methoden in de volgende tabel.

Tool Platforms Description
dotnet CLI All CLI-hulpprogramma voor .NET Core- en .NET Standard-bibliotheken en voor SDK-projecten die gericht zijn op .NET Framework (zie HET SDK-kenmerk). Haalt het pakket op dat is geïdentificeerd door <package_name> en voegt een verwijzing toe aan het projectbestand. Het haalt ook afhankelijkheden op en installeert deze.
Visual Studio Windows en Mac Biedt een gebruikersinterface waarmee u vanuit een opgegeven pakketbron pakketten en hun afhankelijkheden kunt bladeren, selecteren en in een project installeren. Voegt verwijzingen toe aan geïnstalleerde pakketten aan het projectbestand.
Package Manager Console (Visual Studio) Alleen op Windows Haalt het pakket op dat is geïdentificeerd door <package_name> van een geselecteerde bron in een opgegeven project in de oplossing en voegt vervolgens een verwijzing toe aan het projectbestand. Het haalt ook afhankelijkheden op en installeert ze.
nuget.exe CLI All CLI-hulpprogramma voor .NET Framework-bibliotheken en niet-SDK-projecten die gericht zijn op .NET Standard-bibliotheken. Haalt het pakket op dat is geïdentificeerd door <package_name> en breidt de inhoud uit naar een map in de huidige map; kan ook alle pakketten in een packages.config bestand ophalen. Hiermee worden ook afhankelijkheden opgehaald en geïnstalleerd, maar worden er geen wijzigingen aangebracht in projectbestanden of packages.config.