Paketerstellungsworkflow

Das Erstellen eines Pakets beginnt mit dem kompilierten Code (in der Regel .NET-Assemblys), den Sie mit anderen verpacken und für andere freigeben möchten, entweder über den öffentlichen nuget.org-Katalog oder einen privaten Katalog innerhalb Ihrer Organisation. Das Paket kann auch zusätzliche Dateien enthalten, z. B. eine Infodatei, die angezeigt wird, wenn das Paket installiert wird, und kann Transformationen zu bestimmten Projektdateien enthalten.

Ein Paket kann auch dazu dienen, beliebig viele andere Abhängigkeiten einzubeziehen, ohne eigenen Code zu enthalten. Ein solches Paket ist eine bequeme Möglichkeit, ein SDK bereitzustellen, das aus mehreren unabhängigen Paketen besteht. In anderen Fällen kann ein Paket nur Symboldateien (.pdb) enthalten, um das Debuggen zu unterstützen.

Hinweis

Wenn Sie ein Paket für die Verwendung durch andere Entwickler erstellen, ist es wichtig zu verstehen, dass sie von Ihrer Arbeit abhängig sind. Die Erstellung und Veröffentlichung eines Pakets impliziert auch die Verpflichtung, Fehler zu beheben und andere Updates vorzunehmen, oder zumindest das Paket als Open Source verfügbar zu machen, damit andere es beibehalten können.

Unabhängig vom Fall beginnt das Erstellen eines Pakets mit der Entscheidung des Bezeichners, der Versionsnummer, der Lizenz, der Copyrightinformationen und anderen erforderlichen Inhalten. Sobald Sie fertig sind, können Sie den Befehl "Pack" verwenden, um alles in einer .nupkg Datei zusammenzufügen. Diese Datei kann in einem NuGet-Feed wie nuget.org veröffentlicht werden.

Tipp

Ein NuGet-Paket mit der .nupkg Erweiterung ist einfach eine ZIP-Datei. Um den Inhalt eines Pakets auf einfache Weise zu untersuchen, ändern Sie die Erweiterung zu .zip und erweitern Sie dann den Inhalt wie gewohnt. Stellen Sie sicher, dass Sie die Dateierweiterung wieder zu .nupkg ändern, bevor Sie versuchen, sie auf einen Host hochzuladen.

Um den Erstellungsprozess zu erlernen und zu verstehen, beginnen Sie mit dem Erstellen eines Pakets , das Sie durch die kernlichen Prozesse führt, die allen Paketen gemeinsam sind.

Von dort aus können Sie eine Reihe weiterer Optionen für Ihr Paket in Betracht ziehen:

• Die Unterstützung mehrerer Zielframeworks beschreibt, wie Sie ein Paket mit mehreren Varianten für unterschiedliche .NET Frameworks erstellen.
• Das Erstellen lokalisierter Pakete beschreibt, wie sie ein Paket mit mehreren Sprachressourcen strukturieren und wie separate lokalisierte Satellitenpakete verwendet werden.
• Vorabversionen von Paketen zeigen, wie Sie Alpha-, Beta- und rc-Pakete für kunden freigeben, die interessiert sind.
• Quell- und Konfigurationsdateitransformationen beschreibt, wie Sie sowohl einseitige Tokenersetzungen in Dateien ausführen können, die einem Projekt hinzugefügt werden, als auch web.config und app.config mit Einstellungen ändern können, die bei der Deinstallation des Pakets ebenfalls zurückgesetzt werden.
• Symbolpakete bieten Anleitungen zum Bereitstellen von Symbolen für Ihre Bibliothek, mit denen Verbraucher beim Debuggen in Ihren Code eintauchen können.
• Bei der Paketversionsverwaltung wird erläutert, wie Sie die genauen Versionen identifizieren, die Sie für Ihre Abhängigkeiten zulassen (andere Pakete, die Sie aus Ihrem Paket nutzen).
• Systemeigene Pakete beschreiben den Prozess zum Erstellen eines Pakets für C++-Consumer.
• Das Signieren von Paketen beschreibt den Prozess zum Hinzufügen einer digitalen Signatur zu einem Paket.

Wenn Sie dann bereit sind, ein Paket in nuget.org zu veröffentlichen, folgen Sie dem einfachen Prozess in " Veröffentlichen eines Pakets".

Wenn Sie einen privaten Feed anstelle von nuget.org verwenden möchten, lesen Sie die Übersicht über Hostingpakete