Dela via

Publicera paket till NuGet.org

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

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 se till att paket-ID:t ä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.

    Packa utdata

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 en behörighet för att driva nya paket och paketversioner och ange * i mönsterfältet 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-nyckel

Publicera ett paket till NuGet.org

Du kan publicera ditt paket 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 kommandotolk med förhöjda rättigheter navigerar du till katalogen 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 paketresultat