Instalace klientských nástrojů NuGetu

Chcete nainstalovat balíček? Viz Způsoby instalace balíčku NuGet.

Pokud chcete pracovat s NuGetem jako příjemcem balíčku nebo tvůrcem, můžete v Visual Studio použít nástroje příkazového řádku a funkce NuGetu. Tento článek stručně popisuje možnosti různých nástrojů. Vysvětluje také, jak je nainstalovat a porovnat dostupnost funkcí napříč nástroji.

Rychlé úvody k NuGet

Pokud chcete začít používat NuGet ke využívání balíčků, přečtěte si následující články:

Pokud chcete začít vytvářet balíčky NuGet, přečtěte si tyto články:

Přehled nástrojů

nástroj Description Stáhnout
dotnet SDK Nástroj rozhraní příkazového řádku pro .NET a .NET standardní knihovny a pro jakýkoli projekt ve stylu SDK jako je ten, který cílí na .NET Framework. Tento nástroj rozhraní příkazového řádku je součástí sady .NET SDK a poskytuje základní funkce NuGet na všech platformách. V Visual Studio 2017 a novějších se rozhraní příkazového řádku dotnet automaticky nainstaluje se všemi úlohami souvisejícími s .NET. .NET SDK
nuget.exe Nástroj rozhraní příkazového řádku pro knihovny .NET Framework a pro jakýkoli projekt non-SDK-style jako je ten, který cílí na knihovny .NET Standard. Tento nástroj rozhraní příkazového řádku poskytuje všechny funkce NuGet na Windows a většinu funkcí v systémech macOS a Linux při spouštění v Mono. nuget.exe
Visual Studio Plnohodnotné integrované vývojové prostředí (IDE), které zahrnuje Package Manager NuGet. Visual Studio poskytuje uživatelské rozhraní Package Manager a konzolu Package Manager (PowerShell v Windows). Tyto nástroje můžete použít ke spouštění většiny operací NuGet. Visual Studio
Visual Studio Code Lehký open-source editor kódu pro Windows, macOS a Linux, který nabízí funkce NuGet prostřednictvím rozšíření z Marketplace. Můžete také použít sadu dotnet SDK nebo nástroje rozhraní příkazového řádku nuget.exe z Visual Studio Code. Visual Studio Code

K obnovení a vytváření balíčků můžete použít také rozhraní příkazového řádku Microsoft Build engine (MSBuild). MsBuild ale není nástroj pro obecné účely pro práci s NuGetem. Tento nástroj rozhraní příkazového řádku je primárně užitečný na buildových serverech.

Package Manager příkazy konzoly fungují jenom v rámci Visual Studio na Windows a nefungují v jiných prostředích PowerShellu.

Zásady podpory

Pro informace o podpoře Visual Studio pro Windows, viz životní cyklus a údržba produktu Visual Studio.

Nejnovější verze nuget.exe je plně podporovaná a může se spoléhat na opravy chyb, aktualizace a vylepšení. Další informace o zásadách nuget.exe podpory najdete v tématu Moderní zásady životního cyklu.

Zásady podpory sady .NET SDK najdete v tématu .NET a .NET základní zásady podpory.

Vydání oprav

Opravené verze nuget.exe se vydávají výhradně v případě, že se vyžadují důležité opravy zabezpečení pro dlouhodobou podporu (LTS) Visual Studio nebo .NET SDK.

Všechny chyby zabezpečení by se měly nahlásit do Centra pro hlášení bezpečnostních chyb společnosti Microsoft (MSRC) na stránce ohlášení MSRC. Podrobné informace o hlášení problémů se zabezpečením najdete v zásadách zabezpečení v úložišti NuGet.Client.

NuGet.exe zrušení seznamu

Z koncového bodu se odeberou nepodporované, zastaralé, nebo zranitelné verze.

Visual Studio

V Visual Studio 2017 a novějším zahrnuje instalační program Visual Studio NuGet Package Manager se všemi úlohami, které využívají .NET.

Můžete také nainstalovat Package Manager samostatně nebo ověřit instalaci. Spusťte instalační program Visual Studio a pod možností Jednotlivé komponenty>Nástroje pro kód>Správce balíčků NuGet. Další informace najdete v tématu Instalace a správa balíčků v Visual Studio pomocí Package Manager NuGet.

Nástroje rozhraní příkazového řádku

K podpoře funkcí NuGet v prostředí Visual Studio IDE můžete použít buď rozhraní příkazového řádku dotnet, nebo rozhraní příkazového řádku nuget.exe. Rozhraní příkazového řádku dotnet se instaluje s některými pracovními zátěžemi ve Visual Studio, jako je .NET. nuget.exe Příkazový řádek musí být nainstalovaný samostatně, jak je uvedeno výše. Porovnání funkcí nástrojů najdete v části Dostupnost funkcí .

  • Pokud chcete cílit na .NET nebo .NET Standard, použijte nástroj rozhraní příkazového řádku sady DOtnet SDK. Toto rozhraní příkazového řádku se vyžaduje pro formát projektu ve stylu sady SDK, který používá SDK atribut.

  • Pokud chcete cílit na architekturu .NET (jenom projekty bez sady SDK), použijte nástroj rozhraní příkazového řádku nuget.exe. Pokud je projekt migrován z packages.config formátu do PackageReference, použijte místo toho nástroj rozhraní příkazového řádku sady SDK dotnet.

dotnet SDK

Dotnet SDK je nástroj rozhraní příkazového řádku .NET. Funguje na všech platformách (Windows, macOS a Linux) a poskytuje základní funkce NuGet, jako je instalace, obnovení a publikování balíčků. Rozhraní příkazového řádku dotnet poskytuje přímou integraci se soubory projektu .NET, jako jsou soubory .csproj, což je užitečné ve většině scénářů. Toto rozhraní příkazového řádku je také vytvořené přímo pro každou platformu a nevyžaduje instalaci Mono.

Instalace sady dotnet SDK

Pokud chcete zjistit, jak používat základní příkazy pomocí nástroje rozhraní příkazového řádku sady DOtnet SDK, přečtěte si téma Instalace a správa balíčků NuGet pomocí rozhraní příkazového řádku dotnet.

nuget.exe – rozhraní příkazového řádku

NuGet CLI, nuget.exe, je nástroj pro Windows, který poskytuje veškeré funkce NuGet. Toto rozhraní příkazového řádku se také může spouštět v systémech macOS a Linux pomocí mono s určitými omezeními.

Pokud chcete zjistit, jak používat základní příkazy s nástrojem rozhraní příkazového nuget.exe řádku, přečtěte si téma Správa balíčků NuGet pomocí rozhraní příkazového řádku nuget.exe.

Nainstalujte nuget.exe

Vždy nainstalujte nejnovější verzi nástroje, která podporuje vaši konfiguraci.

Pokud už je nástroj rozhraní příkazového nuget.exe řádku nainstalovaný, můžete ho pomocí příkazu nuget update -selfaktualizovat na nejnovější verzi.

  1. Stáhnout nuget.exe:

  2. Po zobrazení výzvy soubor uložte do libovolné složky. Soubor nuget.exe se stáhne přímo. Stažený soubor není instalační program, takže nemusíte soubor spouštět přímo z prohlížeče.

  3. Pokud chcete použít nástroj rozhraní příkazového řádku z libovolné složky, přidejte do proměnné prostředí složku, která obsahuje soubor PATH.

Dostupnost funkcí

Následující tabulka porovnává dostupné funkce pro rozhraní příkazového řádku dotnet, nuget.exe CLI a nástroje Visual Studio pro podporované platformy.

funkce dotnet CLI NuGet CLI (Windows) NuGet CLI (Mono) Visual Studio
Vyhledávací balíčky
Instalace nebo odinstalace balíčků ✔ (1)
Aktualizace balíčků
Obnovení balíčků ✔ (2)
Správa zdrojů balíčků
Správa balíčků ve feedu
Nastavení klíčů rozhraní API pro informační kanály
Vytváření balíčků (3) ✔ (4)
Publikování balíčků
Replikace balíčků
Správa globálních balíčků a složek mezipaměti
Správa konfigurace NuGetu

Poznámky k funkcím:

  • (1) Použití této funkce nemá vliv na soubory projektu. Místo toho použijte nástroj rozhraní příkazového řádku sady SDK dotnet.
  • (2) Tato funkce funguje pouze se soubory packages.config, a ne se soubory řešení (.sln nebo .slnx).
  • (3) Různé pokročilé funkce balíčků jsou k dispozici pouze prostřednictvím rozhraní příkazového řádku, protože nejsou reprezentovány v nástrojích Visual Studio uživatelského rozhraní.
  • (4) Tato funkce funguje se soubory .nuspec , ale ne se soubory projektu.

Připravované funkce

Pokud chcete zobrazit náhled nadcházejících funkcí NuGet, nainstalujte si Insiders Channel verze Visual Studio, která funguje souběžně se stabilními verzemi Visual Studio. Pokud chcete nahlásit problémy nebo sdílet nápady pro verze Preview, otevřete problém v úložišti NuGet GitHub.

Vývojáři, kteří pracují na Windows, můžou také prozkoumat průzkumníka balíčků NuGet. Tato aplikace je opensourcový samostatný nástroj, pomocí kterého můžete vizuálně zkoumat, vytvářet a upravovat balíčky NuGet. Je užitečné pro mnoho scénářů, jako je provádění experimentálních změn struktury balíčku bez opětovného sestavení balíčku.