Udostępnij za pośrednictwem

Publikowanie pakietów w NuGet.org

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

NuGet.org to menedżer pakietów, który umożliwia deweloperom udostępnianie kodu wielokrotnego użytku. Pakiet NuGet to skompresowany plik z rozszerzeniem .nupkg zawierający skompilowany kod, który może być używany w innych projektach. Pakiety hostowane w NuGet.org są dostępne dla wszystkich deweloperów na całym świecie.

Wymagania wstępne

  • Dowolna wersja programu Visual Studio 2019 i obciążenie platformy .NET Core.
  • dotnet interfejs wiersza poleceń. Jeśli jeszcze go nie masz, zainstaluj zestaw SDK platformy .NET Core.
  • Zarejestruj się w celu uzyskania bezpłatnego konta na nuget.org, jeśli jeszcze go nie masz.

Tworzenie projektu

Możesz użyć własnego projektu platformy .NET do skompilowania i wygenerowania pakietu NuGet lub utworzyć nową podstawową bibliotekę klas platformy .NET w następujący sposób:

  1. W programie Visual Studio wybierz Plik , Nowy, a następnie Projekt.

  2. Wybierz szablon biblioteki klas (.NET Standard) i wybierz pozycję Dalej.

  3. Nadaj projektowi nazwę i rozwiązanie, a następnie wybierz lokalizację do zapisania projektu lokalnie. Po zakończeniu wybierz Utwórz.

    Tworzenie projektu biblioteki klas

Biblioteka klas szablonów jest wystarczająca do utworzenia pakietu NuGet, więc na potrzeby tego samouczka użyjemy istniejącego szablonu i nie będziemy pisać żadnego dodatkowego kodu.

Konfigurowanie i generowanie pakietu

  1. Wybierz projekt w Eksploratorze rozwiązań, kliknij prawym przyciskiem myszy i wybierz właściwości a następnie pakiet.

  2. Wypełnij formularz i upewnij się, że identyfikator pakietu jest unikatowy w przeciwnym razie może powodować konflikt z istniejącymi pakietami w NuGet.org. Typowa konwencja nazewnictwa jest podobna do: Company.Product.Feature. Jeśli chcesz wygenerować pakiet za każdym razem, gdy kompilujesz projekt, zaznacz pole wyboru Generuj pakiet NuGet na kompilacji.

    Konfigurowanie właściwości pakietu

  3. Wybierz projekt z Eksploratora rozwiązań, kliknij prawym przyciskiem myszy, a następnie wybierz pozycję Pack, aby wygenerować pakiet .nupkg.

    Generowanie pakietu

  4. Sprawdź stan polecenia pakietu w oknie danych wyjściowych.

    pakiet wyjściowy

Generowanie klucza interfejsu API

Teraz, gdy utworzyliśmy nasz pakiet nupkg, jesteśmy prawie gotowi do jego opublikowania, ale najpierw musimy wygenerować klucz interfejsu API w celu nawiązania połączenia z interfejsem API NuGet.org.

  1. Zaloguj się do swojego konta NuGet.org lub utwórz je, jeśli tego nie zrobiłeś.

  2. Wybierz ikonę nazwy użytkownika, a następnie wybierz opcję Klucze interfejsu API.

  3. Wybierz pozycję Utwórz następnie wprowadź nazwę klucza. Nadaj swojemu kluczowi uprawnienie do wypychania nowych pakietów w zakresie wersji pakietu, a następnie wpisz * w polu wzorca glob, aby wybrać wszystkie pakiety. Po zakończeniu wybierz Utwórz.

    Tworzenie klucza interfejsu API

  4. Wybierz pozycję Kopiuj i zapisz klucz interfejsu API w bezpiecznej lokalizacji. Ten klucz będzie potrzebny do opublikowania naszego pakietu NuGet.

    skopiuj klucz API

Publikowanie pakietu w NuGet.org

Pakiet można opublikować przy użyciu internetowego interfejsu użytkownika, interfejsu wiersza polecenia dotnet lub interfejsu wiersza polecenia nuget.exe. Skupimy się na publikowaniu pakietów przy użyciu wiersza polecenia w tej sekcji. Do tego celu będzie potrzebna nazwa pakietu, klucz interfejsu API i źródłowy adres URL.

  1. W wierszu polecenia z podwyższonym poziomem uprawnień przejdź do folderu zawierającego pakiet nupkg.

  2. Uruchom następujące polecenie, aby opublikować pakiet w NuGet.org. Zastąp symbole zastępcze nazwą pakietu i kluczem interfejsu API.

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

  3. Dane wyjściowe poprzedniego polecenia powinny wyglądać mniej więcej tak.

    publikowanie danych wyjściowych pakietu