Sdílet prostřednictvím

Instalace a správa balíčků v sadě Visual Studio pomocí Správce balíčků NuGet

Uživatelské rozhraní Správce balíčků NuGet v sadě Microsoft Visual Studio pro Windows umožňuje snadno instalovat, odinstalovat a aktualizovat balíčky NuGet v projektech a řešeních.

Článek je určený jenom pro uživatele Windows. Pokud používáte Visual Studio pro Mac, přečtěte si téma Zahrnutí balíčku NuGet do projektu.

Požadavky

  • Nainstalujte Visual Studio 2022 pro Windows s jakýmkoli pracovním zatížením souvisejícím s .NET.

    Edici 2022 Community si můžete nainstalovat zdarma z visualstudio.microsoft.com nebo použít edici Professional nebo Enterprise.

    Visual Studio 2017 a vyšší automaticky obsahuje Správce balíčků NuGet při instalaci úlohy související s rozhraním .NET. Pokud ho chcete nainstalovat jednotlivě v instalačním programu sady Visual Studio, vyberte kartu Jednotlivé komponenty a pak v nástrojích kódu vyberte Správce balíčků NuGet .

    Pokud v sadě Visual Studio 2015 chybí Správce balíčků NuGet, zkontrolujte rozšíření a aktualizace nástrojů>a vyhledejte rozšíření Správce balíčků NuGet . Pokud v sadě Visual Studio nemůžete použít instalační program rozšíření, stáhněte si rozšíření přímo z https://dist.nuget.org/index.html.

  • Pokud ho ještě nemáte, zaregistrujte si bezplatný účet na nuget.org. Před nahráním balíčku NuGet musíte účet zaregistrovat a potvrdit.

Vyhledání a instalace balíčku

Pokud chcete najít a nainstalovat balíček NuGet pomocí sady Visual Studio, postupujte takto:

  1. Načtěte projekt v Průzkumníku řešení a pak vyberte Projekt>Spravovat balíčky NuGet.

    Otevře se okno Správce balíčků NuGet .

  2. Výběrem karty Procházet zobrazíte balíčky podle oblíbenosti z aktuálně vybraného zdroje (viz Zdroje balíčků).

    • Pokud chcete vyhledat konkrétní balíček, použijte vyhledávací pole vlevo nahoře.
    • Zkrácené informace mohou být zobrazeny vedle každého ID balíčku, aby bylo možné identifikovat správný balíček a liší se v závislosti na vybraných zdrojích balíčků. Mezi příklady patří počet stažení balíčku, hypertextový odkaz na profil autora nebo vlastníka.

    Poznámka:

    Ve verzi Visual Studio 17.11 a vyšších se vlastníci balíčků zobrazují jako hypertextové odkazy profilu, pokud je podporovaný vybraným zdrojem balíčku. Vlastnictví balíčku je definováno zdrojem balíčku. Podívejte se například na téma Správa vlastníků balíčků na nuget.org.

    V sadě Visual Studio 17.10 a starších se zobrazí metadata balíku autora, která jsou prezentována jako prostý text. Další informace najdete v tématu Metadata balíčku autorů.

    • Výběrem balíčku zobrazíte podrobné informace o balíčku. Zobrazí se podokno podrobností na pravé straně a umožňuje vybrat verzi, kterou chcete nainstalovat. Snímek obrazovky zobrazující okno správce balíčků NuGet s vybranou kartou Procházet, podoknem podrobností a s vybranou kartou Podrobnosti balíčku. Na kartě Podrobnosti balíčku můžete zobrazit metadata balíčku, informace o vlastnících, autorech, licencích atd., a v kartě README (pokud ji poskytuje autor balíčku) naleznete soubor README balíčku. Snímek obrazovky zobrazující okno správce balíčků NuGet s vybranou kartou README.

  3. V pravém podokně vyberte v rozevíracím seznamu verzi . Pokud chcete do seznamu verzí zahrnout předběžné verze, vyberte Zahrnout předběžné verze.

  4. Chcete-li nainstalovat balíček NuGet, vyberte Nainstalovat. Může se zobrazit výzva k přijetí licenčních podmínek nebo výzva k ověření instalace.

    Visual Studio nainstaluje balíček a jeho závislosti v projektu. Po dokončení instalace se přidané balíčky zobrazí na kartě Nainstalované. Balíčky najdete také v uzlu Balíčky závislostí> projektu v Průzkumníku řešení. Po instalaci balíčku na něj můžete odkazovat v projektu pomocí using příkazu.

  5. (Volitelné) NuGet má dva formáty, ve kterých může projekt používat balíčky: PackageReference a packages.config. Pokud chcete nastavit výchozí formát, vyberte Možnosti nástrojů>, rozbalte Správce balíčků NuGet, vyberte Obecné a pak zvolte výchozí formát správy balíčků. Další informace naleznete v tématu Volba výchozího formátu správy balíčků.

Odinstalace balíčku

Chcete-li odinstalovat balíček NuGet, postupujte takto:

  1. Načtěte projekt v Průzkumníku řešení, vyberte projekt Spravovat balíčky NuGet>, a pak vyberte kartu Nainstalováno.

  2. V levém podokně vyberte balíček, který chcete odinstalovat (v případě potřeby ho vyhledejte pomocí vyhledávacího pole) a pak v pravém podokně vyberte Odinstalovat .

    Snímek obrazovky znázorňující Správce balíčků NuGet s vybraným balíčkem a zvýrazněným tlačítkem Odinstalovat

Aktualizace balíčku

Chcete-li aktualizovat balíček NuGet, postupujte takto:

  1. Načtěte projekt v Průzkumníku řešení a pak vyberte Projekt>Spravovat balíčky NuGet. U projektů webu nejprve vyberte složku Bin .

  2. Výběrem karty Aktualizace zobrazíte balíčky, které mají dostupné aktualizace z vybraného zdroje balíčků. Vyberte Zahrnout předběžné verze , aby se do seznamu aktualizací zahrnuly předběžné verze balíčků.

  3. Vyberte balíček, který chcete aktualizovat. V pravém podokně vyberte v rozevíracím seznamu požadovanou verzi a pak vyberte Aktualizovat.

    Snímek obrazovky znázorňující Správce balíčků NuGet s vybraným balíčkem a zvýrazněným tlačítkem Aktualizovat

  4. U některých balíčků je tlačítko Aktualizovat zakázané a zobrazí se následující zpráva: Implicitně odkazuje sada SDK. Pokud chcete balíček aktualizovat, aktualizujte sadu SDK, do které patří. Tato zpráva označuje, že balíček je součástí větší architektury nebo sady SDK a nelze jej aktualizovat nezávisle. Tyto balíčky jsou interně označeny <IsImplicitlyDefined>True</IsImplicitlyDefined>. Je například Microsoft.NETCore.App součástí sady .NET Core SDK a verze balíčku se liší od verze rozhraní runtime používané aplikací. Pokud chcete stáhnout novou verzi .NET Core, aktualizujte instalaci .NET Core. Další informace najdete v tématu metabalíky a správa verzí .NET Core. Tento scénář platí pro následující běžně používané balíčky:

    • Microsoft.AspNetCore.All
    • Microsoft.AspNetCore.App
    • Microsoft.NETCore.App
    • NETStandard.Library

    Snímek obrazovky znázorňující balíček NuGet se zakázaným tlačítkem Aktualizovat

  5. Pokud chcete aktualizovat více balíčků na nejnovější verze, zvolte je v seznamu balíčků NuGet a pak vyberte Aktualizovat.

  6. Jednotlivé balíčky můžete aktualizovat také na kartě Nainstalované . V tomto případě můžete také vybrat verzi a možnost Zahrnout předběžné verze .

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. Vyberte řešení ve Správci řešení a pak vyberte Nástroje>Správce balíčků> NuGetSpravovat balíčky NuGet pro řešení.

  2. V okně Spravovat balíčky NuGet pro řešení vyberte projekty, které jsou ovlivněny operacemi.

    Snímek obrazovky znázorňující okno Spravovat balíčky pro řešení s vybranými více projekty

Karta Konsolidace

Vývojáři obvykle považují za špatný postup použití různých verzí stejného balíčku NuGet v různých projektech ve stejném řešení. Visual Studio umožňuje používat pro balíčky NuGet společnou verzi. Uděláte to tak, že pomocí karty Konsolidovat v okně Správce balíčků NuGet zjistíte, kde balíčky s odlišnými čísly verzí používají různé projekty v řešení.

Snímek obrazovky ukazující okno Spravovat balíčky pro řešení s vybranou kartou Konsolidovat.

V tomto příkladu projekt ClassLibrary1 používá EntityFramework 6.2.0, zatímco ConsoleApp1 používá EntityFramework 6.1.0. Chcete-li konsolidovat verze balíčků, postupujte takto:

  1. Na kartě Konsolidovat vyberte projekty, které chcete aktualizovat v seznamu projektů.

  2. V seznamu verzí vyberte verzi, která se má použít pro všechny tyto projekty.

  3. Vyberte volbu Instalovat.

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

Zdroje balíčků

Visual Studio ignoruje pořadí zdrojů balíčků a používá balíček podle toho, který zdroj je první, kdo odpoví na požadavek. Další informace naleznete v tématu Obnovení balíčků. Informace o tom, jak načíst balíček z konkrétního zdroje, naleznete v tématu Mapování zdroje balíčků.

  1. Pokud chcete změnit zdroj, ze kterého Visual Studio načítá metadata balíčku, vyberte zdroj z nabídky zdroje balíčku.

    Snímek obrazovky se zvýrazněným selektorem zdroje balíčku

  2. Pokud chcete spravovat zdroje balíčků, vyberte ikonu Nastavení nebo vyberte Možnosti nástrojů>.

    Snímek obrazovky se zvýrazněnou ikonou Nastavení zdroje balíčku

  3. Informace o správě zdrojů balíčků NuGet najdete v tématu Možnosti NuGet v sadě Visual Studio.

Možnosti správce balíčků NuGet

Když vyberete balíček, Správce balíčků NuGet zobrazí rozbalitelný ovládací prvek Možnosti pod selektorem verze . U většiny typů projektů je k dispozici pouze možnost Zobrazit okno náhledu .

Snímek obrazovky znázorňující rozbalený ovládací prvek Možnosti správce balíčků NuGet

V následujících částech jsou vysvětleny dostupné možnosti.

Možnosti instalace a aktualizace

Tyto možnosti jsou k dispozici pouze pro některé typy projektů:

  • Chování závislostí: Tato možnost konfiguruje způsob, jakým NuGet rozhoduje o tom, které verze závislých balíčků se mají nainstalovat. Má následující nastavení:

    • Přeskočení závislostí přeskočí instalaci závislostí, což obvykle přeruší instalovaný balíček.
    • Nejnižší [Výchozí] nainstaluje závislost s minimálním číslem verze, které splňuje požadavky primárního vybraného balíčku.
    • Nejvyšší oprava nainstaluje verzi se stejnými čísly hlavních verzí a podverze, ale s nejvyšším číslem opravy. Pokud je například zadána verze 1.2.2, nainstaluje se nejvyšší verze, která začíná na verzi 1.2.
    • Nejvyšší podverze nainstaluje verzi se stejným číslem hlavní verze, ale nejvyšším podverzem a číslem opravy. Pokud je zadána verze 1.2.2, nainstaluje se nejvyšší verze, která začíná na 1.
    • Nejvyšší nainstaluje nejvyšší dostupnou verzi balíčku.

  • Akce konfliktu souborů: Tato možnost určuje, jak má NuGet zpracovávat balíčky, které už existují v projektu nebo místním počítači. Má následující nastavení:

    • Výzva vyzve NuGet k zadání dotazu, jestli chcete zachovat nebo přepsat existující balíčky.
    • Ignorovat všechny dává NuGet pokyn, aby přeskočil přepsání jakéhokoli existujícího balíčku.
    • Přepsat vše dává NuGet pokyn, aby přepsal všechny existující balíčky.

Možnosti odinstalace

Tyto možnosti jsou k dispozici pouze pro některé typy projektů:

  • Odebrat závislosti: Při výběru odebere všechny závislé balíčky, pokud nejsou odkazovány jinde v projektu.

  • Vynutit odinstalaci i v případě, že jsou na něm závislosti: Při výběru odinstaluje balíček i v případě, že se na něj v projektu stále odkazuje. Tato možnost se obvykle používá v kombinaci s odebráním závislostí k odebrání balíčku a jakýchkoli závislostí, které nainstaloval. Použití této možnosti však může vést k nefunkčním odkazům v projektu. V takovém případě možná budete muset tyto další balíčky přeinstalovat.

Viz také

Další informace o NuGetu najdete v následujících článcích:

  • Last updated on