Správa balíčků pomocí konzoly Správce balíčků sady Visual Studio (PowerShell)

Konzola Správce balíčků v sadě Visual Studio používá příkazy PowerShellu k interakci s balíčky NuGet. Konzolu můžete použít v případě, že neexistuje způsob, jak provést operaci prostřednictvím uživatelského rozhraní Správce balíčků. V konzole můžete použít také příkazy dotnet CLI nebo NuGet CLI.

Tento článek popisuje, jak vyhledat, nainstalovat, aktualizovat a odinstalovat balíčky NuGet pomocí příkazů PowerShellu v konzole Správce balíčků. Kompletní referenční informace k příkazům PowerShellu správce balíčků najdete v referenčních informacích k PowerShellu.

Důležité

Příkazy a argumenty PowerShellu v tomto článku jsou specifické pro konzolu Správce balíčků sady Visual Studio. Tyto příkazy se liší od příkazů modulu PackageManagement , které můžete použít v obecném prostředí PowerShellu. Každé prostředí má příkazy, které nejsou k dispozici v druhém prostředí, a příkazy se stejným názvem se můžou lišit v jejich konkrétních argumentech.

Dostupnost konzoly

Počínaje verzí Visual Studio 2017 se NuGet a Správce balíčků NuGet nainstalují automaticky při vytváření libovolného pracovního vytížení souvisejícího s .NET ve Visual Studio. Správce balíčků můžete nainstalovat také tak, že v instalačním programu sady Visual Studio vyberete Jednotlivé komponenty>Nástroje kódu>Správce balíčků NuGet.

Rozšíření Správce balíčků NuGet můžete vyhledat také v nabídkách Nástroje Rozšíření a aktualizace nebo Rozšíření (Tools nebo ). Pokud v sadě Visual Studio nemůžete použít instalátor rozšíření, můžete rozšíření stáhnout přímo z https://dist.nuget.org/index.html.

Konzola Správce balíčků je integrovaná do Správce balíčků pro Visual Studio ve Windows. Visual Studio Code a Visual Studio pro Mac nezahrnují konzolu. Visual Studio pro Mac má uživatelské rozhraní pro správu balíčků NuGet a ekvivalentní příkazy konzoly jsou k dispozici prostřednictvím rozhraní příkazového řádku NuGet. Další informace najdete v tématu Instalace a správa balíčků NuGet v sadě Visual Studio pro Mac.

Rychlé vyhledání a instalace balíčku

Použití konzoly Správce balíčků k rychlému vyhledání a instalaci balíčku:

1. Otevřete svůj projekt nebo řešení ve Visual Studiu a vyberte Nástroje>Správce balíčků NuGet>Konzola správce balíčků pro otevření okna Konzoly Správce balíčků.

2. V konzole zadejte Find-Package klíčové slovo a vyhledejte balíček, který chcete nainstalovat. Pokud například chcete najít balíčky obsahující klíčové slovo elmah, spusťte následující příkaz. Pokud už znáte požadovaný název balíčku, přeskočte tento krok.

   Find-Package elmah
   

3. Jakmile název najdete, pomocí Install-Package příkazu nainstalujte balíček. Pokud například chcete balíček nainstalovat Elmah.MVC , zadejte:

   Install-Package Elmah.MVC
   

Další podrobnosti o těchto příkazech najdete v částech Najít balíček a Nainstalovat balíček .

Návod

Mnoho operací konzoly závisí na tom, že je v aplikaci Visual Studio otevřené řešení s předem známou cestou. Pokud máte neuložené řešení nebo žádné řešení, zobrazí se chyba Řešení se neotevře nebo neuloží. Ujistěte se, že máte otevřené a uložené řešení. Pokud chcete chybu opravit, vytvořte a uložte řešení nebo uložte neuložené řešení.

Ovládací prvky konzoly

Konzolu Správce balíčků otevřete v sadě Visual Studio tak, že v horní nabídce vyberete Tools>Správce balíčků NuGet>Konzolu Správce balíčků. Konzola je okno sady Visual Studio, které můžete uspořádat a umístit podle potřeby. Další informace naleznete v tématu Přizpůsobení rozložení oken v sadě Visual Studio.

Příkazy konzoly ve výchozím nastavení pracují s konkrétním zdrojem balíčku a projektem zobrazeným v ovládacích prvcích v horní části okna:

Výběr jiného zdroje balíčku nebo projektu změní výchozí hodnoty pro následné příkazy. Chcete-li tato nastavení přepsat pro jednotlivé příkazy beze změny výchozích hodnot, většina konzolových příkazů podporuje volby -Source a -ProjectName.

Pokud chcete spravovat zdroje balíčků, vyberte ikonu ozubeného kolečka, která otevře dialogové okno Nástroje>Možnosti>Správce balíčků NuGet>Zdroje balíčků. Ovládací prvek vedle selektoru projektu vymaže obsah konzoly.

Tlačítko úplně vpravo přeruší dlouhotrvající příkaz. Například spuštěním Get-Package -ListAvailable -PageSize 500 se zobrazí seznam 500 nejlepších dostupných balíčků na výchozím zdroji, jako je nuget.org, což může trvat několik minut.

Vyhledání balíčku

Pokud chcete najít balíček ve výchozím zdroji, použijte Find-Package.

• Vyhledání a výpis balíčků, které obsahují určitá klíčová slova:

  Find-Package <keyword1>
  Find-Package <keyword2>
  

• Vyhledání a výpis balíčků, jejichž název začíná řetězcem:

  Find-Package <string> -StartWith
  

• Ve výchozím nastavení Find-Package vrátí seznam 20 balíčků. Použijte -First k zobrazení dalších balíčků. Pokud chcete například zobrazit prvních 100 balíčků, použijte:

  Find-Package <keyword> -First 100
  

• Zobrazení seznamu všech verzí určitého balíčku:

  Find-Package <PackageName> -AllVersions -ExactMatch
  

Instalace balíčku

Chcete-li nainstalovat balíček do výchozího projektu, použijte Install-Package <PackageName>. Příkaz konzoly Install-Package provede následující akce:

• Provede kroky v části Co se stane při instalaci balíčku NuGet.
• Zobrazí příslušné licenční podmínky v okně konzoly s předpokládanou smlouvou. Pokud s podmínkami nesouhlasíte, měli byste balíček odinstalovat.
• Přidá odkaz na balíček v souboru projektu a v Průzkumníku řešení v uzlu Reference . Než uvidíte změny v souboru projektu, musíte projekt uložit.

Ve výchozím nastavení Install-Package přidá balíček do výchozího projektu, které určuje okno konzoly. Pokud chcete přidat balíček do projektu, který není výchozí, použijte tuto -ProjectName možnost. Pokud chcete například přidat Elmah.MVC balíček do jiného než výchozího UtilitiesLib projektu, spusťte následující příkaz:

Install-Package Elmah.MVC -ProjectName UtilitiesLib

Odinstalace balíčku

Chcete-li odinstalovat balíček z výchozího projektu, použijte Uninstall-Package <PackageName>. Pokud potřebujete najít název balíčku, pomocí příkazu Get-Package zobrazte všechny balíčky nainstalované ve výchozím projektu.

Uninstall-Package provede následující akce:

• Odebere odkazy na balíček z projektu a jakékoliv formáty řízení. Odkazy se už nezobrazují v Průzkumníku řešení. Možná budete muset projekt znovu sestavit, aby se odebrala reference ve složce bin.
• Vrátí jakékoli změny, které instalace balíčku provedla v app.config nebo web.config.
• Odebere dříve nainstalované závislosti, pokud žádné zbývající balíčky tyto závislosti nepoužívají.

Pokud chcete odinstalovat balíček a všechny jeho nepoužívané závislosti, spusťte:

Uninstall-Package <PackageName> -RemoveDependencies

Pokud chcete odinstalovat balíček, i když na něm závisí jiné balíčky, spusťte:

Uninstall-Package <PackageName> -Force

Aktualizace balíčku

Chcete-li aktualizovat balíček, použijte Get-Package a Update-Package. Můžete spustit následující příkazy:

• Pokud chcete zkontrolovat, jestli jsou pro všechny nainstalované balíčky k dispozici novější verze:

  Get-Package -updates
  

• Aktualizace konkrétního balíčku:

  Update-Package <PackageName>
  

• Aktualizace všech balíčků v projektu:

  Update-Package -ProjectName <ProjectName>
  

• Aktualizace všech balíčků v řešení:

  Update-Package
  

Použití rozhraní příkazového řádku NuGet v konzole

Většinu operací konzoly můžete provádět také pomocí rozhraní příkazového řádku NuGet. Příkazy konzoly PowerShellu ale fungují v kontextu uloženého projektu a řešení sady Visual Studio a často provádějí více než ekvivalentní příkazy rozhraní příkazového řádku NuGet. Například instalace balíčku prostřednictvím Install-Package přidá odkaz na soubor projektu, ale příkaz Rozhraní příkazového řádku NuGet ne. Z tohoto důvodu vývojáři pracující v sadě Visual Studio obvykle raději používají příkazy konzoly než rozhraní příkazového řádku NuGet.

Pokud chcete použít příkazy rozhraní příkazového řádku NuGet v konzole Správce balíčků, nainstalujte balíček NuGet.CommandLine .

Install-Package NuGet.CommandLine

Předchozí příkaz nainstaluje nejnovější verzi rozhraní příkazového řádku NuGet. Pokud chcete nainstalovat konkrétní verzi, použijte tuto -Version možnost. Pokud chcete nainstalovat například verzi 4.4.1, zadejte:

Install-Package NuGet.CommandLine -Version 4.4.1

Po instalaci NuGet.CommandLine balíčku můžete pomocí konzoly Správce balíčků spustit všechny příkazy rozhraní příkazového řádku NuGet.

Rozšíření konzoly Správce balíčků

Některé balíčky nainstalují nové příkazy pro konzolu. Například MvcScaffolding vytvoří příkazy jako Scaffold, které generují kontrolery a zobrazení pro ASP.NET MVC.

Nastavení profilu PowerShellu NuGet

Můžete vytvořit profil PowerShellu, který zpřístupní běžně používané příkazy ve všech kontextech PowerShellu, takže nepřijdete o nastavení PowerShellu mezi relacemi. NuGet podporuje profil specifický pro NuGet, obvykle v %UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1.

Pokud chcete najít umístění profilu uživatele, zadejte $profile do konzoly:

$profile
C:\Users\<user>\Documents\WindowsPowerShell\NuGet_profile.ps1

Chcete-li zjistit, zda profil existuje v daném umístění, zadejte test-path $profile. Pokud se příkaz vrátí False, musíte vytvořit profil se zadaným názvem v tomto umístění. Další informace najdete v tématu Profily prostředí Windows PowerShell.

Další kroky

• Instalace a správa balíčků NuGet pomocí rozhraní příkazového řádku dotnet
• Správa balíčků pomocí rozhraní příkazového řádku nuget.exe
• Instalace a správa balíčků v sadě Visual Studio pomocí Správce balíčků NuGet