Quickstart: Een NuGet-pakket maken en publiceren met behulp van Visual Studio (alleen Windows)

In deze quickstart gebruikt u Microsoft Visual Studio om een NuGet-pakket te maken op basis van een .NET-klassebibliotheek. Vervolgens publiceert u het pakket naar nuget.org met behulp van een opdrachtregelinterfaceprogramma (CLI).

Deze quickstart is alleen bedoeld voor Windows gebruikers. Als u een ander platform gebruikt, gebruikt u de .NET CLI.

Vereiste voorwaarden

• Visual Studio 2026 met een .NET-gerelateerde workload.

  U kunt de communityversie 2026 gratis installeren vanuit visualstudio.microsoft.com of u kunt de Professional- of Enterprise-editie gebruiken.

  Visual Studio 2017 en hoger bevatten automatisch NuGet-mogelijkheden wanneer u een .NET-gerelateerde workload installeert.

• De .NET CLI.

  Voor Visual Studio 2017 en hoger wordt de .NET CLI automatisch geïnstalleerd met elke .NET-gerelateerde workload. U kunt ook de .NET SDK installeren om de .NET CLI op te halen. De .NET CLI is vereist voor .NET projecten die gebruikmaken van de indeling SDK-stijl (en een SDK-kenmerk). De standaardsjabloon .NET klassebibliotheek in Visual Studio 2017 en hoger maakt gebruik van het SDK-kenmerk.

  Belangrijk

  Als u met een niet-SDK-project werkt, volgt u de procedures in Maak en publiceer een pakket met behulp van Visual Studio (.NET Framework, Windows) om het pakket te maken en te publiceren. Voor dit artikel wordt de .NET CLI aanbevolen. Hoewel u elk NuGet-pakket kunt publiceren met behulp van de NuGet CLI, zijn sommige van de stappen in dit artikel specifiek voor SDK-projecten en de .NET CLI. De NuGet CLI wordt gebruikt voor non-SDK-projecten (meestal .NET Framework-projecten).

• Een gratis account op nuget.org. U moet het account registreren en bevestigen voordat u een NuGet-pakket kunt uploaden.

• De NuGet CLI. U kunt het installeren door het te downloaden van nuget.org. Voeg het bestandnuget.exe toe aan een geschikte map en voeg die map toe aan uw PATH omgevingsvariabele.

Een klassebibliotheekproject maken

U kunt een bestaand .NET klassebibliotheekproject gebruiken voor de code die u wilt verpakken, of u kunt er een maken door de volgende stappen uit te voeren:

1. Selecteer in Visual Studio Bestand>Nieuw>Project/Solution.

2. Ga in het venster Een nieuw project maken naar het zoekvak en voer class library in.

3. Selecteer in de resulterende lijst met projectsjablonen de klassebibliotheeksjabloon die voldoet aan de volgende criteria:

   • Bevat de beschrijving A-project voor het maken van een klassebibliotheek die is gericht op .NET of .NET Standard
   • Heeft een C# -tag

   Kies Volgende.

4. Voer in het venster Configure your new projectProject nameAppLogger in en selecteer Next.

5. Selecteer in het venster Aanvullende informatie een geschikte waarde voor Framework en selecteer vervolgens Maken.

   Als u niet zeker weet welk framework u moet selecteren, is de nieuwste optie een goede keuze en kan het later eenvoudig worden gewijzigd. Zie Wanneer u netx.0 moet targeten versus netstandard voor meer informatie over welk framework u moet gebruiken.

6. (Optioneel) Voor deze quickstart hoeft u geen extra code te schrijven voor het NuGet-pakket, omdat de sjabloonklassebibliotheek voldoende is om een pakket te maken. Als u echter functionele code aan het pakket wilt toevoegen, moet u de volgende code opnemen:

   namespace AppLogger
   {
       public class Logger
       {
           public void Log(string text)
           {
               Console.WriteLine(text);
           }
       }
   }
   

Pakketeigenschappen configureren

Nadat u uw project hebt gemaakt, kunt u de Eigenschappen van het NuGet-pakket configureren door de volgende stappen uit te voeren:

1. In Solution Explorer, selecteer uw project en selecteer vervolgens Project><project-name> Properties, waarbij <project-name> de naam van uw project is.

2. Vouw het Package-knooppunt uit en selecteer Algemeen.

   Het knooppunt Package wordt alleen weergegeven voor SDK-projecten in Visual Studio. Als u zich richt op een project met een niet-SDK-stijl (meestal .NET Framework-projecten), kunt u het project migreren of bekijk Een pakket maken en publiceren met behulp van Visual Studio (.NET Framework, Windows) voor stapsgewijze instructies.

   

3. Geef voor pakket-id een unieke id op voor uw pakket.

   Belangrijk

   U moet het pakket een id geven die uniek is voor de host die u gebruikt, zoals nuget.org. Anders treedt er een fout op. Voor deze quickstart raden we u aan voorbeeld of test op te nemen in de id, omdat de publicatiestap het pakket openbaar zichtbaar maakt. Zie voor meer informatie over het selecteren van een ID Aanbevolen procedures voor de pakket-id.

4. Vul eventuele andere gewenste eigenschappen in. Voor pakketten die zijn gebouwd voor openbaar gebruik, moet u speciale aandacht besteden aan de eigenschap Tags , omdat tags anderen helpen uw pakket te vinden en te begrijpen wat het doet.

   Alle eigenschappen gaan naar het manifest .nuspec dat Visual Studio voor het project maakt. Zie pack target voor een tabel die laat zien hoe eigenschappen van Microsoft Build (MSBuild) in SDK-stijl projecten worden toegewezen aan .nuspec. Zie .nuspec-verwijzing voor een beschrijving van de .nuspec-bestandseigenschappen.

5. (Optioneel) Als u de eigenschappen rechtstreeks in het bestand AppLogger.csproj project wilt bekijken, selecteert u Project>Bewerken Project Bestand.

   Het bestand AppLogger.csproj wordt geopend op een nieuw tabblad.

   Deze optie is beschikbaar voor projecten die gebruikmaken van het kenmerk SDK-stijl.

Voer de opdracht Pack uit

Voer de volgende stappen uit om een NuGet-pakket te maken op basis van uw project:

1. Selecteer Build>Configuration Manager en stel vervolgens de waarde Active solution configuration in op Release.

2. Klik in Solution Explorer met de rechtermuisknop op het project AppLogger en selecteer vervolgens Pack.

   Visual Studio bouwt het project en maakt het bestand .nupkg.

3. Bekijk het uitvoervenster voor gedetailleerde informatie, inclusief het pad naar het pakketbestand. In dit voorbeeld bevindt de ingebouwde assembly zich in de map bin\Release\net8.0 die geschikt is voor een .NET 8.0-doel:

   1>------ Build started: Project: AppLogger, Configuration: Release Any CPU ------
   1>  AppLogger -> d:\proj\AppLogger\AppLogger\bin\Release\net8.0\AppLogger.dll
   1>  Successfully created package 'd:\proj\AppLogger\AppLogger\bin\Release\Contoso.App.Logger.Test.1.0.0.nupkg'.
   ========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
   

Als de opdracht Pack ontbreekt in het menu, is uw project waarschijnlijk geen SDK-project. Voer een van de volgende stappen uit:

• Upgrade het project zodat u de .NET CLI kunt gebruiken.
• Volg de instructies in Een pakket maken en publiceren met behulp van Visual Studio (.NET Framework, Windows) om de NuGet CLI te gebruiken om een NuGet-pakket te maken en te publiceren vanuit uw project.

(Optioneel) Pakket genereren op build

U kunt Visual Studio zo configureren dat het NuGet-pakket automatisch wordt gegenereerd wanneer u het project bouwt:

1. Selecteer uw project in Solution Explorer, en selecteer vervolgens Project><project-name> Properties, waarbij <project-name> de naam van uw project (AppLogger in dit geval).

2. Vouw het pakketknooppunt uit, selecteer Algemeen en selecteer Vervolgens NuGet-pakket genereren bij build.

   

(Optioneel) Pack met MSBuild

Als alternatief voor het gebruik van de menuopdracht Pack kunt u de msbuild -t:pack opdracht gebruiken om een NuGet-pakket te bouwen vanuit uw project. NuGet 4.x+ en MSBuild 15.1+ ondersteunen een pack doel wanneer uw project de benodigde pakketgegevens bevat.

1. Open het project in Solution Explorer en open een opdrachtpromptvenster door Tools>Opdrachtregel>Ontwikkelingsopdrachtprompt te selecteren.

   Het opdrachtpromptvenster wordt geopend in de projectmap.

2. Voer de volgende opdracht uit: msbuild -t:pack.

Zie Een NuGet-pakket maken met MSBuild voor meer informatie.

Het pakket publiceren

Nadat u een bestand .nupkg hebt gemaakt, voert u de stappen uit in de volgende secties om het te publiceren naar nuget.org. U kunt de .NET CLI of de NuGet CLI gebruiken voor publicatie. U gebruikt ook een API-sleutel die u verkrijgt van nuget.org.

Uw API-sleutel verkrijgen

Voordat u uw NuGet-pakket publiceert, maakt u een API-sleutel:

1. Meld u aan bij uw nuget.org-account of maak een account als u er nog geen hebt.

2. Selecteer uw gebruikersnaam in de rechterbovenhoek en selecteer vervolgens API-sleutels.

3. Selecteer Maken en voer een naam in voor uw sleutel.

4. Selecteer onder Bereiken selecteren, Push.

5. Voer onder Pakketten selecteren voor Glob-patroon een sterretje (*) in.

6. Klik op Creëren.

7. Selecteer Kopiëren om de nieuwe sleutel te kopiëren.

   

Scoping biedt een manier om afzonderlijke API-sleutels te maken voor verschillende doeleinden. Elke sleutel heeft een verloopperiode, en u kunt de sleutel beperken tot specifieke pakketten of glob-patronen. U kunt ook elke sleutel opgeven voor specifieke bewerkingen: nieuwe pakketten en pakketversies pushen, alleen nieuwe pakketversies pushen of de lijst opheffen.

Door middel van scoping kunt u API-sleutels maken voor verschillende personen die pakketten voor uw organisatie beheren, zodat ze alleen de machtigingen hebben die ze nodig hebben.

Zie voor meer informatie Gescope API-sleutels.

Publiceren met behulp van de .NET CLI of NuGet CLI

U kunt de .NET CLI of de NuGet CLI gebruiken om een pakket naar de server te pushen en te publiceren. Ga naar het tabblad voor het hulpprogramma dat u wilt gebruiken.

dotnet nuget push <package-file> --api-key <API-key> --source https://api.nuget.org/v3/index.json

Pushing <package-file> to 'https://www.nuget.org/api/v2/package'...
  PUT https://www.nuget.org/api/v2/package/
  Created https://www.nuget.org/api/v2/package/ 2891ms
Your package was pushed.

Fouten tijdens het publiceren

Wanneer u de push opdracht uitvoert, treedt er soms een fout op. Er kan bijvoorbeeld een fout optreden in de volgende situaties:

• Uw API-sleutel is ongeldig of verlopen.
• U probeert een pakket te publiceren met een id die al bestaat op de host.
• U kunt wijzigingen aanbrengen in een gepubliceerd pakket, maar vergeet het versienummer bij te werken voordat u het opnieuw probeert te publiceren.

Het foutbericht geeft doorgaans de bron van het probleem aan.

Stel dat de id Contoso.App.Logger.Test bestaat op nuget.org. Als u probeert een pakket met die id te publiceren, krijgt u de volgende fout:

Response status code does not indicate success: 403 (The specified API key is invalid, has expired, or does not have permission to access the specified package.).

Als u deze situatie wilt oplossen, controleert u het bereik, de vervaldatum en de waarde van uw API-sleutel. Als de sleutel geldig is, geeft de fout aan dat de pakket-id al bestaat op de host. U kunt het probleem oplossen door de pakket-id te wijzigen in uniek, het project opnieuw te bouwen, het .nupkg-bestand opnieuw te maken en de opdracht opnieuw uit te push voeren.

Het gepubliceerde pakket beheren

Wanneer uw pakket is gepubliceerd, ontvangt u een bevestigingsmail. Als u het gepubliceerde pakket wilt zien, gaat u naar nuget.org, selecteert u uw gebruikersnaam in de rechterbovenhoek en selecteert u Vervolgens Pakketten beheren.

Nu uw NuGet-pakket is gepubliceerd op nuget.org, kunnen andere ontwikkelaars het in hun projecten gebruiken.

Als u een pakket maakt dat niet nuttig is (zoals dit voorbeeldpakket uit een lege klassebibliotheek), of als u niet wilt dat het pakket zichtbaar is, kunt u het pakket opheffen om het te verbergen in zoekresultaten:

1. Nadat het pakket wordt weergegeven onder Gepubliceerde pakketten op de pagina Pakketten beheren , selecteert u het potloodpictogram naast de pakketvermelding.

   

2. Op de volgende pagina selecteert u Vermelding, schakelt u het selectievakje Lijst in zoekresultaten uit en selecteert u Opslaan.

   

Het pakket wordt nu weergegeven onder Niet-vermelde pakketten in Pakketten beheren en wordt niet meer weergegeven in zoekresultaten.

Een README-bestand of een ander bestand toevoegen

U kunt een readme-bestand of andere bestanden in uw pakket opnemen.

Een readme-bestand toevoegen

Volg deze stappen om een read-me-bestand aan het pakket op te nemen:

1. Open het bestand project door Project>Bewerken Project bestand te selecteren.

2. Ga in het projectbestand naar het PropertyGroup element en voeg vervolgens een PackageReadmeFile onderliggend element toe:

   <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
           ...
           <PackageReadmeFile>readme.md</PackageReadmeFile>
           ...
       </PropertyGroup>
   </Project>
   

3. Ga naar het ItemGroup element en voeg vervolgens een None onderliggend element toe:

   <Project Sdk="Microsoft.NET.Sdk">
       <PropertyGroup>
           ...
           <PackageReadmeFile>readme.md</PackageReadmeFile>
           ...
       </PropertyGroup>
   
       <ItemGroup>
           ...
           <None Include="readme.md" Pack="true" PackagePath="\" />
           ...
       </ItemGroup>
   </Project>
   

In het voorgaande voorbeeld geeft de eigenschap een bestand met de naam readme.md op in de hoofdmap van het project. Nadat u uw pakket hebt gebouwd, verpakt en gepubliceerd, geeft nuget.org de inhoud van het read-me bestand weer op de pakketpagina. Visual Studio geeft ook de inhoud van dat bestand weer in de gebruikersinterface van Package Manager.

In de volgende schermopname ziet u bijvoorbeeld het bestand read-me voor het HtmlAgilityPack pakket:

Andere bestanden toevoegen

Als u andere bestanden aan een pakket wilt toevoegen, opent u het bestand project door Project>Bewerken Project Bestand te selecteren. Voeg vervolgens een Content onderliggend element toe aan het ItemGroup element:

<ItemGroup>
  <Content Include="other-content.md">
    <Pack>true</Pack>
    <PackagePath>\</PackagePath>
  </Content>
</ItemGroup>

Zie Inclusief inhoud in een pakket voor meer informatie.

Gerelateerde video's

Zie voor video's over het gebruik van NuGet voor pakketbeheer .NET Package Management met NuGet voor beginners en NuGet voor beginners.

Verwante inhoud

Zie Maak een pakket met behulp van de nuget.exe CLI voor meer informatie over het maken van een NuGet-pakket met het Visual Studio .NET Framework.

Zie de volgende artikelen voor meer informatie over NuGet:

• Een NuGet-pakket maken met de dotnet CLI
• NuGet-pakketten publiceren
• Pre-releasepakketten bouwen
• Ondersteun meerdere .NET frameworks in uw projectbestand
• Pakketversiebeheer
• Gelokaliseerde NuGet-pakketten maken
• Overview van het upgraden van .NET-apps