Publicera paket till NuGet.org

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

NuGet.org är en pakethanterare som gör det möjligt för utvecklare att dela återanvändbar kod. Ett NuGet-paket är en komprimerad fil med .nupkg tillägg som innehåller kompilerad kod som kan användas i andra projekt. Paket som finns i NuGet.org är tillgängliga för alla utvecklare runt om i världen.

Förutsättningar

  • Alla versioner av Visual Studio 2019 och .NET Core-arbetsbelastningen.
  • dotnet CLI. Om du inte redan har det installerar du .NET Core SDK.
  • Registrera dig för ett kostnadsfritt konto på nuget.org om du inte redan har ett.

Skapa ett projekt

Du kan använda ditt eget .NET-projekt för att skapa och generera ett NuGet-paket eller skapa ett nytt grundläggande .NET-klassbibliotek på följande sätt:

  1. I Visual Studio väljer du Arkiv, Nytt och sedan Projekt.

  2. Välj mallen Klassbibliotek (.NET Standard) och välj Nästa.

  3. Namnge projektet och din lösning och välj sedan en plats för att spara projektet lokalt. Välj Skapa när du är klar.

    Skapa ett klassbiblioteksprojekt

Mallklassbiblioteket räcker för att skapa ett NuGet-paket, så för den här självstudien använder vi den befintliga mallen och vi kommer inte att skriva någon ytterligare kod.

Konfigurera och generera ett paket

  1. Välj ditt projekt från Solution Explorer, högerklicka och välj egenskaper och sedan Paket.

  2. Fyll i formuläret och kontrollera att ditt paket-ID är unikt, annars kan det vara i konflikt med befintliga paket på NuGet.org. En vanlig namngivningskonvention liknar: Company.Product.Feature. Om du vill generera paketet varje gång du skapar projektet markerar du kryssrutan Generera NuGet-paket i bygget .

    Konfigurera paketegenskaper

  3. Välj ditt projekt från Solution Explorer, högerklicka och välj sedan Paket för att generera paketet .nupkg .

    Generera paket

  4. Kontrollera statusen för packkommandot i utdatafönstret.

    Packutdata

Generera en API-nyckel

Nu när vi har skapat vårt nupkg paket är vi nästan redo att publicera det, men först måste vi generera en API-nyckel för att ansluta till NuGet.org-API:et.

  1. Logga in på ditt NuGet.org konto eller skapa ett om du inte har gjort det.

  2. Välj användarnamnsikonen och välj sedan API-nycklar.

  3. Välj Skapa och ange sedan ett namn för nyckeln. Ge din nyckel ett Push-nytt paket och paketversionsomfång och ange * i fältet globmönster för att välja alla paket. Välj Skapa när du är klar.

    Skapa API-nyckel

  4. Välj Kopiera och spara DIN API-nyckel på en säker plats. Vi behöver den här nyckeln för att publicera vårt NuGet-paket.

    Kopiera API-nyckeln

Publicera ett paket till NuGet.org

Du kan publicera paketet med hjälp av webbgränssnittet, dotnet CLI eller nuget.exe CLI. Vi kommer att fokusera på att publicera paket med hjälp av kommandoraden i det här avsnittet. Du behöver namnet på paketet, en API-nyckel och käll-URL:en för att göra det.

  1. I en upphöjd kommandotolk navigerar du till mappen som innehåller ditt nupkg paket.

  2. Kör följande kommando för att publicera paketet till NuGet.org. Ersätt platshållarna med paketnamnet och API-nyckeln.

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. Utdata från föregående kommando bör se ut ungefär så här.

    Publicera paketutdata