Sdílet prostřednictvím

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

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

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 příponou .nupkg, 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

  • Všechny verze sady Visual Studio 2019 a úlohy .NET Core.
  • dotnet rozhraní příkazového řádku. Pokud ho ještě nemáte, nainstalujte sadu .NET Core SDK.
  • Pokud ho ještě nemáte, zaregistrujte si bezplatný účet na nuget.org.

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 poté Projekt.

  2. Vyberte šablonu knihovny 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. Vyberte Vytvořit, když budete hotovi.

    Vytvořte projekt knihovny tříd

Knihovna tříd šablon je dostačující k vytvoření balíčku NuGet, takže v tomto kurzu použijeme existující šablonu a není potřeba psát žádný další kód.

Nastavení a vygenerování balíčku

  1. Vyberte svůj projekt v Průzkumníku řešení, klikněte pravým tlačítkem myši a vyberte vlastnosti, poté balíček.

  2. Vyplňte formulář a ujistěte se, že id balíčku je jedinečné, jinak může kolidovat 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 v sestavení.

    Konfigurace vlastností balíčku

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

    Generovat balíček

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

    balíček výstup

Vygenerování klíče rozhraní API

Teď, když jsme vytvořili náš 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 svého uživatelského jména a pak vyberte API klíče.

  3. Vyberte Vytvořit, poté zadejte název klíče. Dejte svému klíči oprávnění pro nový balíček a verze balíčku v rozsahu, a do pole vzoru globu zadejte *, abyste vybrali všechny balíčky. Vyberte Vytvořit, když budete hotovi.

    vytvoření klíče rozhraní API

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

    Kopírovat klíč 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. Na příkazovém řádku se zvýšenými oprávněními přejděte do složky obsahující váš 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

  • Last updated on