Instalace a správa NuGet v Visual Studio pro Mac

Uživatelské NuGet Správce balíčků v Visual Studio pro Mac umožňuje snadno instalovat, odinstalovat a aktualizovat 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 NuGet balíčku do projektu, a ukazuje řetěz nástrojů, který proces usnadňuje.

Úvod k používání balíčků NuGet Visual Studio pro Mac najdete v tématu Rychlý Visual Studio pro Mac

Vyhledání a instalace balíčku

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

    Přidání nové NuGet kontextové akce balíčku

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

    Seznam NuGet balíčků

  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 kliknutím na tlačítko Přidat balíček zahajte instalaci.

    Přidání balíčku NuGet EntityFramework

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

    Projekty Xamarin

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

    Projekty .NET Core

    • V uzlu > NuGet se zobrazí každý NuGet, který jste stáhli. Balíček můžete aktualizovat nebo odebrat z tohoto seznamu.

Použití NuGet balíčků

Po NuGet balíčku a aktualizaci odkazů na projekt můžete programovat s rozhraními API stejně jako s libovolnými odkazy na projekt.

Na začátek souboru přidejte 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 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í se ikona aktualizace Šipka nahoru  s kruhem .

Kliknutím pravým tlačítkem na Závislosti přejděte do místní nabídky a kliknutím na Aktualizovat aktualizujte všechny balíčky:

Místní nabídka Závislosti se zvýrazněnou nabídkou Aktualizovat

  • Spravovat NuGet balíčků – Otevře okno pro přidání dalších balíčků do projektu.
  • Aktualizace – zkontroluje 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 také dostupné na úrovni řešení a ovlivňují všechny projekty v řešení.

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

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

Místní nabídka Závislosti s možností Spravovat NuGet balíčky... zvýrazněná nabídka

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

Dialogové NuGet Spravovat balíčky otevřených se zaškrtnutou možností Zobrazit předběžné verze balíčků

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

Dialogové NuGet Spravovat balíčky otevřené na kartě Nainstalováno s vybraným balíčkem a otevřeným rozevíracím seznamem Nová verze.

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

V okně Řešení můžete zobrazit, jaká verze balíčku je aktuálně nainstalovaná, a kliknout pravým tlačítkem na balíček, který chcete aktualizovat.

Nabídka Balíčky s možnostmi Aktualizovat, Odebrat, Aktualizovat

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

Oznámení zobrazené, když je k dispozici nová verze balíčku

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

  • Aktualizace – zkontroluje zdrojový server a stáhne novější verzi (pokud existuje).
  • Remove – 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 NuGet balíčky...:

    Správa NuGet pro řešení

  2. Při správě balíčků pro řešení vám uživatelské rozhraní umožňuje vybrat projekty, které jsou ovlivněny operacemi:

    Project selektoru při správě balíčků pro řešení

Karta Konsolidovat

Při práci v řešení s více projekty se považuje za osvědčený postup, abyste měli jistotu, že všude, kde v každém projektu použijete stejný balíček NuGet, používáte také stejné číslo verze tohoto balíčku. Visual Studio pro Mac to usnadňuje poskytnutím karty Konsolidovat v uživatelském rozhraní Správce balíčků, když se rozhodnete spravovat balíčky pro řešení. Na této kartě můžete snadno zjistit, kde různé projekty v řešení používají balíčky s odlišnými čísly verzí:

Správce balíčků Karta Konsolidovat uživatelského rozhraní

V tomto příkladu projekt NuGetDemo používá Microsoft.EntityFrameworkCore 2.20, zatímco NuGetDemo.Shared používá Microsoft.EntityFrameworkCore 2.2.6. Pokud chcete konsolidovat verze balíčků, proveďte následující kroky:

  • V seznamu projektů vyberte projekty, které se mají aktualizovat.
  • Vyberte verzi, která se má použít ve všech projektech v seznamu Nová verze, například Microsoft.EntityFrameworkCore 3.0.0.
  • Vyberte tlačítko Konsolidovat balíček.

Aplikace Správce balíčků vybranou verzi balíčku do všech vybraných projektů, po jejichž uplynutí se balíček už nebude na kartě Konsolidovat zobrazit.

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

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

V Visual Studio pro Mac přejděte na Visual Studio > Předvolby > NuGet > Zdroje a zobrazte a upravte seznam zdrojů balíčků. Všimněte si, že zdrojem může být vzdálený server (určený adresou URL) nebo místní adresář.

Zdroje balíčků

Kliknutím na Přidat nastavte nový zdroj. Zadejte popisný název a 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é:

Dialogové okno Přidat zdroj balíčku s výzvou k zadání názvu, adresy URL umístění, uživatelského jména a hesla.

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

Dialogové okno Přidat zdroj balíčku zobrazující rozevírací seznam se seznamem zdrojů balíčků

Správa verzí

Následující NuGet popisuje použití NuGet bez potvrzení balíčků do správy zdrojového kódu. Pokud nechcete ukládat binární soubory a nepoužívané informace do správy zdrojového kódu, můžete nakonfigurovat Visual Studio pro Mac tak, aby automaticky obnovoval balíčky ze serveru. To znamená, že když vývojář načte projekt ze správy zdrojového kódu poprvé, Visual Studio pro Mac automaticky stáhne a nainstaluje požadované balíčky.

Automatické obnovení balíčků

Podrobnosti o tom, jak vyloučit z sledovaného adresáře, najdete v dokumentaci ke konkrétnímu packages zdroji.

Viz také