Installieren und Verwalten von NuGet-Paketen in Visual Studio für Mac

  • Artikel

Wichtig

Visual Studio für Mac wird am 31. August 2024 gemäß der Microsoft Modern Lifecycle-Richtlinie eingestellt. Sie können zwar weiterhin mit Visual Studio für Mac arbeiten, aber es gibt noch einige andere Optionen für Entwickler auf dem Mac, wie z. B. die Vorschauversion der neuen C# Dev Kit Erweiterung für VS Code.

Erfahren Sie mehr über die Fristen für den Support sowie über mögliche Alternativen.

Über die Benutzeroberfläche des NuGet-Paket-Managers in Visual Studio für Mac können Sie auf einfache Weise NuGet-Pakete in Projekten und Projektmappen installieren, deinstallieren und aktualisieren. Sie können nach Paketen suchen und diese zu Ihren .NET Core-, ASP.NET Core- und Xamarin-Projekten hinzufügen.

Dieser Artikel befasst sich mit dem Einschließen eines NuGet-Pakets in ein Projekt und veranschaulicht die Toolkette, durch die der Prozess nahtlos abläuft.

Eine Einführung in die Verwendung von NuGet in Visual Studio für Mac finden Sie im Schnellstart: Installieren und Verwenden eines Pakets in Visual Studio für Mac.

Suchen nach und Installieren von Paketen

  1. Klicken Sie bei einem in Visual Studio für Mac geöffneten Projekt im Projektmappenfenster mit der rechten Maustaste auf den Ordner Abhängigkeiten (bzw. Pakete, wenn Sie ein Xamarin-Projekt verwenden), und klicken Sie dann auf NuGet-Pakete verwalten... .

    This screenshot is of Add new NuGet package context action.

  2. Das Dialogfeld NuGet-Pakete verwalten wird geöffnet. Stellen Sie sicher, dass das Dropdownmenü Paketquelle in der unteren linken Ecke des Dialogfelds auf nuget.org festgelegt ist, sodass das zentrale NuGet-Paketrepository durchsucht wird.

    This screenshot is of Manage NuGet Packages dialog - List NuGet Packages. The Package source option is set to nuget.org.

  3. Verwenden Sie das Suchfeld in der oberen rechten Ecke, um nach einem bestimmten Paket (z. B. EntityFramework) zu suchen. Wenn Sie ein Paket gefunden haben, das Sie verwenden möchten, wählen Sie es aus, und wählen Sie dann die Schaltfläche Paket hinzufügen aus, um die Installation zu starten.

    This screenshot is of add EntityFramework NuGet Package.

  4. Nachdem das Paket heruntergeladen wurde, wird es Ihrem Projekt hinzugefügt. Die Projektmappe ändert sich, je nachdem, welche Art von Projekt Sie bearbeiten:

    Xamarin-Projekte

    • Der Knoten Referenzen wird eine Liste aller Assemblys enthalten, die Teil eines NuGet-Pakets sind.
    • Der Knoten Pakete zeigt alle NuGet-Pakete an, die Sie heruntergeladen haben. Sie können Pakete aus dieser Liste aktualisieren oder entfernen.

    .NET Core-Projekte

    • Der Abhängigkeiten > NuGet-Knoten zeigt alle NuGet-Pakete an, die Sie heruntergeladen haben. Sie können Pakete aus dieser Liste aktualisieren oder entfernen.

Verwenden von NuGet-Paketen

Sobald das NuGet-Paket hinzugefügt und die Projektverweise aktualisiert wurden, können Sie so mit der API programmieren, wie Sie es mit jedem anderen Projektverweis tun würden.

Versichern Sie sich, dass sie alle erforderlichen using-Anweisungen zum Anfang Ihrer Datei hinzufügen:

using Newtonsoft.Json;

Aktualisieren von Paketen

Paketupdates können entweder alle auf einmal durchgeführt werden, indem Sie mit der rechten Maustaste auf den Knoten Abhängigkeiten (Pakete bei Xamarin-Projekten) klicken, oder einzeln, indem Sie auf jedes Paket klicken. Wenn eine neue Version eines NuGet-Pakets verfügbar ist, wird ein Aktualisierungssymbol angezeigt. This is the update icon for updating a new version of NUGet package - Up arrow with circle..

Klicken Sie mit der rechten Maustaste auf Abhängigkeiten, um das Kontextmenü anzuzeigen, und wählen Sie Aktualisieren aus, um alle Pakete zu aktualisieren:

This screenshot shows the Dependencies context menu with the Update menu highlighted.

  • NuGet-Pakete verwalten: Öffnet das Fenster, um dem Projekt weitere Pakete hinzuzufügen.
  • Aktualisieren: Überprüft den Quellserver auf jedes Paket und lädt neuere Versionen herunter.
  • Wiederherstellen: Lädt fehlende Pakete herunter (ohne bestehende Pakete auf neuere Versionen zu aktualisieren).

Die Optionen Aktualisieren und Wiederherstellen sind auch auf Projektmappenebene verfügbar und wirken sich auf alle Projekte in der Projektmappe aus.

Aktualisieren auf Vorabversionen von Paketen

Wenn Sie ein Update auf eine neuere Vorabversion eines Pakets durchführen möchten, können Sie mit der rechten Maustaste auf Abhängigkeiten klicken, um das Kontextmenü zu öffnen, und dort auf NuGet-Pakete verwalten... klicken.

This screenshot shows Dependencies context menu with Manage NuGet Packages... menu highlighted.

Aktivieren Sie das Kontrollkästchen Vorabversion einbeziehen am unteren Rand des Dialogfelds.

This screenshot shows Manage NuGet Packages dialog opened with the 'Include prereleases option checked.

Wählen Sie schließlich auf der Registerkarte Updates des Dialogfelds das Paket aus, das Sie aktualisieren möchten, wählen Sie in der Dropdownliste bei Neue Version die neue Vorabversion aus, und wählen Sie dann Paket aktualisieren aus.

This screenshot shows Manage NuGet Packages dialog opened to the Installed tab, with a package selected and the New Version dropdown list open.

Suchen veralteter Pakete

Im Projektmappenfenster können Sie die derzeit installierte Version eines Pakets anzeigen. Klicken Sie mit der rechten Maustaste auf das Paket, um es zu aktualisieren.

This screenshot shows Packages menu with the options to Update, Remove, Refresh.

Außerdem wird neben dem Paketnamen eine Benachrichtigung angezeigt, wenn eine neue Version für ein Paket verfügbar ist. Sie können entscheiden, ob Sie es aktualisieren möchten.

This screenshot is of Notification shown when a new package version is available.

Im angezeigten Menü stehen die folgenden zwei Optionen zur Auswahl:

  • Aktualisieren: Überprüft den Quellserver und lädt eine neuere Version herunter (falls vorhanden).
  • Entfernen: Entfernt das Paket aus diesem Projekt und die relevanten Assemblys aus den Projektverweisen.

Verwalten von Paketen für die Projektmappe

Die Verwaltung von Paketen für eine Projektmappe ist eine praktische Möglichkeit, mit mehreren Projekten gleichzeitig zu arbeiten.

  1. Klicken Sie mit der rechten Maustaste auf die Projektmappe, und wählen Sie NuGet-Pakete verwalten... aus.

    This screenshot shows Manage NuGet packages for the solution.

  2. Wenn Sie Pakete für die Projektmappe verwalten, können Sie über die Benutzeroberfläche die Projekte auswählen, die von den Vorgängen betroffen sind:

    This screenshot shows Project selector when managing packages for the solution.

Registerkarte „Konsolidieren“

Wenn Sie in einer Projektmappe mit mehreren Projekten arbeiten, stellen Sie sicher, dass Sie in allen Projekten, für die dasselbe NuGet-Paket verwendet wird, auch dieselbe Version dieses Pakets verwenden. Visual Studio für Mac erleichtert dies durch eine Registerkarte Konsolidieren in der Benutzeroberfläche des Paket-Managers, wenn Sie Pakete für eine Projektmappe verwalten möchten. Mithilfe der Registerkarte Konsolidieren erkennen Sie problemlos, wo Pakete mit unterschiedlichen Versionsnummern von unterschiedlichen Projekten in der Projektmappe verwendet werden:

This screenshot shows the Package Manager UI Consolidate tab.

In diesem Beispiel verwendet das Projekt NuGetDemo das Paket Microsoft.EntityFrameworkCore 3.1.23, während NuGetDemo.Shared das Paket Microsoft.EntityFrameworkCore 5.0.2 verwendet. Führen Sie die folgenden Schritte aus, um Paketversionen zu konsolidieren:

  1. Wählen Sie die zu aktualisierenden Projekte in der Projektliste aus.
  2. Wählen Sie die zu verwendende Version (z. B. Microsoft.EntityFrameworkCore 6.0.3) für diese Projekte über die Liste Neue Version aus.
  3. Klicken Sie auf Paket konsolidieren.

Der Paket-Manager installiert die ausgewählte Paketversion in allen ausgewählten Projekten. Danach erscheint das Paket nicht mehr auf der Registerkarte Konsolidieren.

Hinzufügen von Paketquellen

Pakete, die für die Installation verfügbar sind, werden ursprünglich von nuget.org abgerufen. Sie können jedoch andere Paketspeicherorte zu Visual Studio für Mac hinzufügen. Das ist hilfreich, um Ihre NuGet-Pakete in der Entwicklung zu testen oder einen privaten NuGet-Server innerhalb Ihres Unternehmens oder Ihrer Organisation zu verwenden.

Navigieren Sie in Visual Studio für Mac zu Visual Studio > Einstellungen > NuGet > Quellen, um die Liste der Paketquellen anzuzeigen und zu bearbeiten. Bei den Quellen kann es sich um einen Remoteserver (angegeben durch eine URL) oder ein lokales Verzeichnis handeln.

This screenshot shows Package Sources to add other package locations to Visual Studio for Mac.

Wählen Sie Hinzufügen aus, um eine neue Quelle festzulegen. Geben Sie einen Anzeigenamen und den Speicherort (die URL oder den Dateipfad) für die Paketquelle an. Wenn es sich bei der Quelle um einen sicheren Webserver handelt, geben Sie auch einen Benutzernamen und ein Kennwort an, andernfalls lassen Sie diese Einträge leer:

This screenshot shows Add Package Source dialog with a prompt for Name, location URL, user name, and password.

Verschiedene Quellen können bei der Suche nach Paketen angegeben werden:

This screenshot shows Add Package Source dialog showing a drop down with a list of package sources.

Quellcodeverwaltung

Die NuGet-Dokumentation erläutert das Verwenden von NuGet ohne das Übernehmen von Paketen in die Quellcodeverwaltung. Wenn Sie keine Binärdateien und nicht verwendeten Informationen in der Quellcodeverwaltung speichern möchten, können Sie Visual Studio für Mac für das automatische Wiederherstellen vom Server konfigurieren. Wenn ein Entwickler das Projekt zum ersten Mal aus der Quellcodeverwaltung abruft, lädt Visual Studio für Mac die erforderlichen Pakete automatisch herunter und installiert diese.

This screenshot shows the Preferences screen to automatically restore packages when opening a solution.

Weitere Informationen zum Ausschließen der Verfolgung des Verzeichnisses packages finden Sie in der Dokumentation zu Ihrer speziellen Quellcodeverwaltung.

Weitere Informationen