Publikování balíčků do NuGet.org

  • Článek

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

NuGet.org je správce balíčků, který vývojářům umožňuje sdílet opakovaně použitelný kód. Balíček NuGet je komprimovaný soubor s .nupkg příponou, která obsahuje zkompilovaný kód, který lze využívat v jiných projektech. Balíčky hostované v NuGet.org jsou dostupné všem vývojářům po celém světě.

Požadavky

Vytvoření projektu

Pomocí vlastního projektu .NET můžete sestavit a vygenerovat balíček NuGet nebo vytvořit novou základní knihovnu tříd .NET následujícím způsobem:

  1. V sadě Visual Studio vyberte Soubor, Nový a pak Project.

  2. Vyberte šablonu Knihovna tříd (.NET Standard) a vyberte Další.

  3. Pojmenujte projekt a řešení a pak vyberte umístění pro místní uložení projektu. Po dokončení vyberte Vytvořit .

    Vytvoření projektu knihovny tříd

Knihovna tříd šablony stačí k vytvoření balíčku NuGet, takže pro účely tohoto kurzu použijeme existující šablonu a nebudeme psát žádný další kód.

Nastavení a vygenerování balíčku

  1. V Průzkumníku řešení vyberte projekt, klikněte pravým tlačítkem myši a vyberte vlastnosti a pak balíček.

  2. Vyplňte formulář a ujistěte se, že id balíčku je jedinečné, jinak může být v konfliktu s existujícími balíčky na NuGet.org. Běžná konvence vytváření názvů je něco jako: Company.Product.Feature. Pokud chcete balíček vygenerovat při každém sestavení projektu, zaškrtněte políčko Generovat balíček NuGet při sestavení .

    Konfigurace vlastností balíčku

  3. V Průzkumníku řešení vyberte projekt, klikněte pravým tlačítkem myši a pak vyberte Balíček a vygenerujte balíček .nupkg .

    Generování balíčku

  4. Zkontrolujte stav příkazu balíčku v okně výstupu.

    Výstup balíčku

Vygenerování klíče rozhraní API

Teď, když jsme vytvořili balíček nupkg , jsme téměř připraveni ho publikovat, ale nejprve potřebujeme vygenerovat klíč rozhraní API pro připojení k rozhraní NUGET.ORG API.

  1. Pokud jste to neudělali, přihlaste se ke svému NuGet.org účtu nebo si ho vytvořte.

  2. Vyberte ikonu uživatelského jména a pak vyberte Klíče rozhraní API.

  3. Vyberte Vytvořit a zadejte název klíče. Dejte svému klíči nový rozsah nabízených balíčků a verzí balíčku a zadejte * do pole vzoru globu, abyste vybrali všechny balíčky. Po dokončení vyberte Vytvořit .

    Vytvoření klíče rozhraní API

  4. Vyberte Kopírovat a uložit klíč rozhraní API do zabezpečeného umístění. Tento klíč budeme potřebovat k publikování balíčku NuGet.

    Zkopírování klíče rozhraní API

Publikování balíčku do NuGet.org

Balíček můžete publikovat pomocí webového uživatelského rozhraní, rozhraní příkazového řádku dotnet nebo rozhraní příkazového řádku nuget.exe. Zaměříme se na publikování balíčků pomocí příkazového řádku v této části. K tomu budete potřebovat název balíčku, klíč rozhraní API a zdrojovou adresu URL.

  1. V příkazovém řádku se zvýšenými oprávněními přejděte do složky obsahující balíček nupkg .

  2. Spuštěním následujícího příkazu publikujte balíček do NuGet.org. Zástupné symboly nahraďte názvem balíčku a klíčem rozhraní API.

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

  3. Výstup předchozího příkazu by měl vypadat přibližně takto.

    Publikování výstupu balíčku