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 .nupkg rozszerzeniem zawierającym 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

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 pozycję Plik, Nowy, a następnie Projekt.

  2. Wybierz szablon Biblioteka klas (.NET Standard), a następnie wybierz pozycję Dalej.

  3. Nadaj projektowi nazwę i rozwiązanie, a następnie wybierz lokalizację do zapisania projektu lokalnie. Po zakończeniu wybierz pozycję 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 pozycję 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 podczas kompilacji .

    Konfigurowanie właściwości pakietu

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

    Generowanie pakietu

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

    Dane wyjściowe pakietu

Generowanie klucza interfejsu API

Teraz, gdy utworzyliśmy nasz nupkg pakiet, 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 pozycję Klucze interfejsu API.

  3. Wybierz pozycję Utwórz , a następnie wprowadź nazwę klucza. Nadaj kluczowi pozycję Wypychanie nowych pakietów i zakresu wersji pakietu, a następnie wprowadź * w polu wzorzec glob, aby wybrać wszystkie pakiety. Po zakończeniu wybierz pozycję 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.

    Kopiowanie klucza interfejsu 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 nupkg pakiet.

  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