Veröffentlichen von Paketen in NuGet.org
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
NuGet.org ist ein Paket-Manager, mit dem Entwickler wiederverwendbaren Code freigeben können. Ein NuGet-Paket ist eine komprimierte Datei mit .nupkg Der Erweiterung, die kompilierten Code enthält, der in anderen Projekten genutzt werden kann. Pakete, die in NuGet.org gehostet werden, stehen allen Entwicklern auf der ganzen Welt zur Verfügung.
Voraussetzungen
- Jede Version von Visual Studio 2019 und der .NET Core-Workload.
dotnetCLI. Wenn sie noch nicht vorhanden ist, installieren Sie das .NET Core SDK.- Registrieren Sie sich für ein kostenloses Konto auf nuget.org , wenn Sie noch kein Konto haben.
Erstellen eines Projekts
Sie können Ihr eigenes .NET-Projekt verwenden, um ein NuGet-Paket zu erstellen und zu generieren, oder sie können eine neue einfache .NET-Klassenbibliothek wie folgt erstellen:
Wählen Sie in Visual Studio "Datei", "Neu" und dann "Projekt" aus.
Wählen Sie die Vorlage "Klassenbibliothek (.NET Standard)" und dann "Weiter" aus.
Benennen Sie Ihr Projekt und Die Projektmappe, und wählen Sie dann einen Speicherort aus, um das Projekt lokal zu speichern. Wenn Sie fertig sind, wählen Sie Erstellen aus.
Die Vorlagenklassenbibliothek reicht aus, um ein NuGet-Paket zu erstellen, daher verwenden wir für dieses Lernprogramm die vorhandene Vorlage, und wir schreiben keinen zusätzlichen Code.
Einrichten und Generieren eines Pakets
Wählen Sie Ihr Projekt im Projektmappen-Explorer aus, klicken Sie mit der rechten Maustaste, und wählen Sie dann Eigenschaften aus.
Füllen Sie das Formular aus, und stellen Sie sicher, dass Ihre Paket-ID eindeutig ist, andernfalls kann es zu Konflikten mit vorhandenen Paketen auf NuGet.org führen. Eine gängige Benennungskonvention ist etwa: Company.Product.Feature. Wenn Sie Ihr Paket jedes Mal generieren möchten, wenn Sie Ihr Projekt erstellen, aktivieren Sie das Kontrollkästchen "NuGet-Paket generieren" auf build.if you want to generate your package every time you build your project, select the Generate NuGet package on build checkbox.
Wählen Sie Ihr Projekt im Projektmappen-Explorer aus, klicken Sie mit der rechten Maustaste auf "Pack ", um das
.nupkgPaket zu generieren.
Überprüfen Sie den Status des Paketbefehls im Ausgabefenster.
Generieren eines API-Schlüssels
Nachdem wir nun unser nupkg Paket erstellt haben, sind wir fast bereit, es zu veröffentlichen, aber zuerst müssen wir einen API-Schlüssel generieren, um eine Verbindung mit der NuGet.org-API herzustellen.
Melden Sie sich bei Ihrem NuGet.org-Konto an, oder erstellen Sie ein Konto, falls noch nicht.
Wählen Sie das Symbol "Benutzername" und dann "API-Schlüssel" aus.
Wählen Sie "Erstellen" aus, und geben Sie dann einen Namen für Ihren Schlüssel ein. Geben Sie Ihrem Schlüssel einen Neuen Push-Paket- und Paketversionsbereich , und geben Sie
*das Feld "Glob-Muster" ein, um alle Pakete auszuwählen. Wenn Sie fertig sind, wählen Sie Erstellen aus.
Wählen Sie "Kopieren" aus, und speichern Sie Ihren API-Schlüssel an einem sicheren Speicherort. Wir benötigen diesen Schlüssel, um unser NuGet-Paket zu veröffentlichen.
Veröffentlichen eines Pakets in NuGet.org
Sie können Ihr Paket über die Web-UI, dotnet CLI oder nuget.exe CLI veröffentlichen. Wir konzentrieren uns auf die Veröffentlichung von Paketen mithilfe der Befehlszeile in diesem Abschnitt. Dazu benötigen Sie den Namen Ihres Pakets, einen API-Schlüssel und die Quell-URL.
Navigieren Sie an einer Eingabeaufforderung mit erhöhten Rechten zu dem Ordner, der Ihr
nupkgPaket enthält.Führen Sie den folgenden Befehl aus, um Ihr Paket in NuGet.org zu veröffentlichen. Ersetzen Sie die Platzhalter durch den Paketnamen und den API-Schlüssel.
dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.jsonDie Ausgabe des vorherigen Befehls sollte etwa wie folgt aussehen.
