Werkstroom voor het maken van pakketten

Het maken van een pakket begint met de gecompileerde code (meestal .NET-assembly's) die u wilt inpakken en met anderen wilt delen, via de openbare nuget.org-galerie of een privégalerie binnen uw organisatie. Het pakket kan ook aanvullende bestanden bevatten, zoals een readme-bestand die wordt weergegeven wanneer het pakket is geïnstalleerd en transformaties aan bepaalde projectbestanden kan bevatten.

Een pakket kan ook dienen om alleen een willekeurig aantal andere afhankelijkheden op te halen, zonder dat er code vanzelf wordt gebruikt. Een dergelijk pakket is een handige manier om een SDK te leveren die bestaat uit meerdere onafhankelijke pakketten. In andere gevallen kan een pakket alleen symboolbestanden (.pdb) bevatten om foutopsporing te helpen.

Opmerking

Wanneer u een pakket maakt voor gebruik door andere ontwikkelaars, is het belangrijk om te begrijpen dat ze afhankelijk zijn van uw werk. Als zodanig betekent het maken en publiceren van een pakket ook een toezegging om bugs op te lossen en andere updates te maken, of het pakket ten minste beschikbaar te maken als open source, zodat anderen kunnen helpen het te onderhouden.

Hoe dan ook, het maken van een pakket begint met het bepalen van de id, het versienummer, de licentie, copyrightinformatie en alle andere benodigde inhoud. Als u klaar bent, kunt u de opdracht 'pack' gebruiken om alles samen te voegen in een .nupkg bestand. Dit bestand kan worden gepubliceerd naar een NuGet-feed, zoals nuget.org.

Aanbeveling

Een NuGet-pakket met de .nupkg extensie is gewoon een ZIP-bestand. Als u de inhoud van een pakket eenvoudig wilt bekijken, wijzigt u de extensie in .zip en vouwt u de inhoud ervan zoals gewoonlijk uit. Zorg ervoor dat u de extensie weer .nupkg wijzigt voordat u de extensie probeert te uploaden naar een host.

Als u het proces voor het maken wilt leren begrijpen, begint u met het maken van een pakket dat u begeleidt bij de kernprocessen die voor alle pakketten worden gebruikt.

Van daaruit kunt u een aantal andere opties voor uw pakket overwegen:

• Het ondersteunen van meerdere doelframeworks beschrijft hoe u een pakket maakt met meerdere varianten voor verschillende .NET Frameworks.
• Bij het maken van gelokaliseerde pakketten wordt beschreven hoe u een pakket kunt structuren met meerdere taalbronnen en hoe u afzonderlijke gelokaliseerde satellietpakketten gebruikt.
• Voorlopige pakketten laten zien hoe u alfa-, bèta- en rc-pakketten kunt vrijgeven aan klanten die geïnteresseerd zijn.
• In bron- en configuratiebestandstransformaties wordt beschreven hoe u zowel eenrichtingstokenvervangingen kunt uitvoeren in bestanden die aan een project worden toegevoegd en instellingen kunt wijzigen web.config en app.config met instellingen waarvan ook een back-up wordt gemaakt wanneer het pakket wordt verwijderd.
• Symbol Packages biedt richtlijnen voor het leveren van symbolen voor uw bibliotheek, zodat consumenten uw code kunnen doorlopen tijdens het debuggen.
• Met pakketversiebeheer wordt beschreven hoe u de exacte versies kunt identificeren die u toestaat voor uw afhankelijkheden (andere pakketten die u uit uw pakket gebruikt).
• Systeemeigen pakketten beschrijven het proces voor het maken van een pakket voor C++-gebruikers.
• Ondertekeningspakketten beschrijven het proces voor het toevoegen van een digitale handtekening aan een pakket.

Wanneer u klaar bent om een pakket te publiceren naar nuget.org, volgt u het eenvoudige proces in Een pakket publiceren.

Als u een privéfeed wilt gebruiken in plaats van nuget.org, raadpleegt u het overzicht van hostingpakketten