Instalace a správa balíčků NuGet v sadě Visual Studio pro Mac

  • Článek

Důležité

Visual Studio pro Mac je naplánované na vyřazení ze 31. srpna 2024 v souladu s moderními zásadami životního cyklu Společnosti Microsoft. I když můžete dál pracovat se sadou Visual Studio pro Mac, existuje několik dalších možností pro vývojáře na Macu, jako je verze Preview nového rozšíření C# Dev Kit pro VS Code.

Přečtěte si další informace o časových osách podpory a alternativách.

Uživatelské rozhraní Správce balíčků NuGet v sadě Visual Studio pro Mac umožňuje snadno instalovat, odinstalovat a aktualizovat balíčky NuGet v projektech a řešeních. Balíčky můžete vyhledat a přidat do projektů .NET Core, ASP.NET Core a Xamarin.

Tento článek popisuje, jak zahrnout balíček NuGet do projektu a ukazuje řetěz nástrojů, který proces usnadňuje.

Úvod k používání NuGetu v sadě Visual Studio pro Mac najdete v tématu Rychlý start: Instalace a použití balíčku v sadě Visual Studio pro Mac

Vyhledání a instalace balíčku

  1. Pokud je projekt otevřený v sadě Visual Studio pro Mac, klikněte pravým tlačítkem na složku Závislosti (složka Packages, pokud používáte projekt Xamarin) v okně řešení a vyberte Spravovat balíčky NuGet....

    This screenshot is of Add new NuGet package context action.

  2. Zobrazí se dialogové okno Spravovat balíčky NuGet. Ujistěte se, že je rozevírací seznam Zdroj balíčku v levém dolním rohu dialogového okna nastavený tak nuget.org, abyste hledali centrální úložiště balíčků NuGet.

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

  3. Pomocí vyhledávacího pole v pravém horním rohu vyhledejte konkrétní balíček, například EntityFramework. Jakmile najdete balíček, který chcete použít, vyberte ho a výběrem tlačítka Přidat balíček spusťte instalaci.

    This screenshot is of add EntityFramework NuGet Package.

  4. Jakmile se balíček stáhne, přidá se do projektu. Řešení se změní v závislosti na typu projektu, který upravujete:

    Projekty Xamarin

    • Uzel Reference bude obsahovat seznam všech sestavení, která jsou součástí balíčku NuGet.
    • Uzel Balíčky zobrazí každý balíček NuGet, který jste stáhli. Balíček můžete aktualizovat nebo odebrat z tohoto seznamu.

    Projekty .NET Core

    • Uzel Závislosti NuGet zobrazí všechny balíčky > NuGet, které jste stáhli. Balíček můžete aktualizovat nebo odebrat z tohoto seznamu.

Použití balíčků NuGet

Po přidání balíčku NuGet a aktualizaci odkazů na projekt můžete programovat s rozhraními API stejně jako u všech odkazů na projekt.

Ujistěte se, že do horní části souboru přidáte všechny požadované using direktivy:

using Newtonsoft.Json;

Aktualizace balíčků

Aktualizace balíčků je možné provést buď najednou, kliknutím pravým tlačítkem myši na uzel Závislosti (uzel Balíčky pro projekty Xamarin) nebo jednotlivě u každého balíčku. Když je k dispozici nová verze balíčku NuGet, zobrazí This is the update icon for updating a new version of NUGet package - Up arrow with circle.se ikona aktualizace .

Po kliknutí pravým tlačítkem myši na Závislosti se dostanete k místní nabídce a zvolte Aktualizovat , aby se aktualizovaly všechny balíčky:

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

  • Správa balíčků NuGet – Otevře okno pro přidání dalších balíčků do projektu.
  • Aktualizace – Kontroluje zdrojový server pro každý balíček a stáhne všechny novější verze.
  • Obnovení – Stáhne všechny chybějící balíčky (bez aktualizace existujících balíčků na novější verze).

Možnosti aktualizace a obnovení jsou k dispozici také na úrovni řešení a ovlivňují všechny projekty v řešení.

Aktualizace na předběžné verze balíčků

Pokud chcete aktualizovat na novější předběžnou verzi balíčku, můžete kliknutím pravým tlačítkem na Závislosti otevřít místní nabídku a zvolit nabídku Spravovat balíčky NuGet... .

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

Zaškrtněte políčko Zahrnout předběžné verze v dolní části dialogového okna.

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

Nakonec na kartě Aktualizace v dialogovém okně vyberte balíček, který chcete aktualizovat, a v rozevíracím seznamu Nová verze zvolte novou předběžnou verzi a vyberte Aktualizovat balíček.

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

Vyhledání zastaralých balíčků

V okně řešení můžete zobrazit, jakou verzi balíčku je aktuálně nainstalovaná. Kliknutím pravým tlačítkem myši na balíček aktualizujte.

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

Když je k dispozici nová verze balíčku, zobrazí se vedle názvu balíčku také oznámení. Můžete se rozhodnout, jestli ho chcete aktualizovat.

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

V zobrazené nabídce máte dvě možnosti:

  • Aktualizace – Zkontroluje zdrojový server a stáhne novější verzi (pokud existuje).
  • Odebrat – odebere balíček z tohoto projektu a odebere příslušná sestavení z odkazů projektu.

Správa balíčků pro řešení

Správa balíčků pro řešení je pohodlný způsob, jak pracovat s více projekty současně.

  1. Klikněte pravým tlačítkem na řešení a vyberte Spravovat balíčky NuGet...:

    This screenshot shows Manage NuGet packages for the solution.

  2. Když spravujete balíčky pro řešení, uživatelské rozhraní umožňuje vybrat projekty ovlivněné operacemi:

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

Karta Sloučení

Když pracujete v řešení s více projekty, ujistěte se, že všude, kde v každém projektu používáte stejný balíček NuGet, používáte také stejný počet verzí tohoto balíčku. Visual Studio pro Mac usnadňuje poskytování karty Konsolidovat v uživatelském rozhraní Správce balíčků, když se rozhodnete spravovat balíčky pro řešení. Pomocí karty Konsolidovat můžete snadno zjistit, kde jsou balíčky s odlišnými čísly verzí používány různými projekty v řešení:

This screenshot shows the Package Manager UI Consolidate tab.

V tomto příkladu projekt NuGetDemo používá Microsoft.EntityFrameworkCore 3.1.23, zatímco NuGetDemo.Shared používá Microsoft.EntityFrameworkCore 5.0.2. Chcete-li konsolidovat verze balíčků, postupujte takto:

  1. Vyberte projekty, které chcete aktualizovat v seznamu projektů.
  2. Vyberte verzi, která se má použít ve všech těchto projektech v seznamu Nová verze , například Microsoft.EntityFrameworkCore 6.0.3.
  3. Vyberte tlačítko Konsolidovat balíček.

Správce balíčků nainstaluje vybranou verzi balíčku do všech vybraných projektů, po kterých se balíček již nezobrazuje na kartě Konsolidovat .

Přidání zdrojů balíčků

Balíčky, které jsou k dispozici pro instalaci, se zpočátku načítají z nuget.org. Do sady Visual Studio pro Mac ale můžete přidat další umístění balíčků. Je užitečné pro testování vlastních balíčků NuGet ve vývoji nebo použití privátního serveru NuGet ve vaší společnosti nebo organizaci.

V sadě Visual Studio pro Mac přejděte ke zdrojům NuGet > předvoleb > sady Visual Studio > a zobrazte a upravte seznam zdrojů balíčků. Zdroje mohou být vzdáleným serverem (určeným adresou URL) nebo místním adresářem.

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

Vyberte Přidat a nastavte nový zdroj. Zadejte popisný název a umístění (adresu URL nebo cestu k souboru) ke zdroji balíčku. Pokud je zdrojem zabezpečený webový server, zadejte také uživatelské jméno a heslo , jinak nechte tyto položky prázdné:

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

Při hledání balíčků je pak možné vybrat různé zdroje:

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

Správa verzí

Dokumentace NuGet popisuje použití NuGetu bez potvrzení balíčků ke správě zdrojového kódu. Pokud nechcete ukládat binární soubory a nepoužívané informace ve správě zdrojového kódu, můžete sadu Visual Studio pro Mac nakonfigurovat tak, aby automaticky obnovovala balíčky ze serveru. Když vývojář poprvé načte projekt ze správy zdrojového kódu, Visual Studio pro Mac automaticky stáhne a nainstaluje požadované balíčky.

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

Podrobnosti o tom, jak vyloučit packages adresář ze sledování, najdete v konkrétní dokumentaci ke správě zdrojového kódu.

Viz také