Instalace klientských nástrojů NuGetu

  • Článek

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

Pokud chcete pracovat s NuGetem jako uživatelem balíčku nebo tvůrcem, můžete v sadě Visual Studio použít nástroje rozhraní příkazového řádku a funkce NuGetu. Tento článek stručně popisuje možnosti různých nástrojů, jejich instalaci a jejich srovnávací dostupnost funkcí.

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:

Nástroj Popis Stáhnout
dotnet SDK Nástroj CLI pro knihovny .NET Core a .NET Standard a pro jakýkoli projekt ve stylu sady SDK, například pro projekt , který cílí na rozhraní .NET Framework. Tento nástroj rozhraní příkazového řádku je součástí sady .NET Core SDK a poskytuje základní funkce NuGet na všech platformách. V sadě 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 Core. Sada .NET Core SDK
nuget.exe Nástroj ROZHRANÍ příkazového řádku pro knihovny rozhraní .NET Framework a pro všechny projekty, které nejsou ve stylu sady SDK, jako je například projekt , který cílí na knihovny .NET Standard. Tento nástroj rozhraní příkazového řádku poskytuje všechny funkce NuGet ve Windows a většinu funkcí v systému Mac a Linux při spouštění v rámci Mono. nuget.exe
Visual Studio Ve Windows je Správce balíčků NuGet součástí sady Visual Studio 2012 a novější. Visual Studio poskytuje uživatelské rozhraní Správce balíčků a konzolu Správce balíčků (PowerShell ve Windows). Tyto nástroje můžete použít ke spouštění většiny operací NuGet. Visual Studio
Visual Studio pro Mac Na Macu jsou některé funkce NuGet integrované přímo. Správce balíčků Konzola není aktuálně dostupná. Pro další funkce použijte sadu dotnet SDK nebo nuget.exe nástroje rozhraní příkazového řádku. Visual Studio pro Mac
Visual Studio Code Možnosti NuGet ve Windows, Mac a Linuxu jsou dostupné prostřednictvím rozšíření marketplace nebo používají nástroje dotnet SDK nebo nuget.exe rozhraní příkazového řádku. Visual Studio Code

Poznámka:

Visual Studio pro Mac plánujeme do 31. srpna 2024 v souladu s Moderní zásady životního cyklu Od Microsoftu Další informace najdete v tématu Co se děje s Visual Studio pro Mac.

Rozhraní příkazového řádku MSBuild také obnoví a vytvoří balíčky. MSBuild 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.

Správce balíčků příkazy konzoly fungují jenom v sadě Visual Studio ve Windows a nefungují v jiných prostředích PowerShellu.

Zásady podpory

Zásady podpory sady Visual Studio pro Windows najdete v části Ž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 podpory NuGet.exe najdete v moderních zásadách životního cyklu společnosti Microsoft.

Zásady podpory sady .NET SDK najdete v zásadách podpory .NET a .NET Core.

Vydání oprav

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

Všechny chyby zabezpečení by měly být hlášeny do centra Microsoft Security Response Center (MSRC) na stránce sestavy MSRC. Podívejte se také na zásady zabezpečení v úložišti NuGet.Client.

NuGet.exe zrušení seznamu

Z tools.json se odeberou zastaralé, zastaralé nebo zranitelné verze NuGet.exe.

Visual Studio

V sadě Visual Studio 2017 a novějším obsahuje instalační program sady Visual Studio Správce balíčků NuGet se všemi úlohami, které využívají .NET.

Můžete také nainstalovat Správce balíčků samostatně nebo ověřit instalaci. Spusťte instalační program sady Visual Studio a zkontrolujte nastavení možností v části Správce balíčků NuGet v nástrojích > kódu jednotlivých komponent>. Další informace najdete v tématu Instalace a správa balíčků v sadě Visual Studio pomocí Správce balíčků NuGet.

Poznámka:

Pro starší verze sady Visual Studio si můžete stáhnout rozšíření NuGet na adrese https://dist.nuget.org/index.html.

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

Pomocí rozhraní příkazového řádku dotnet nebo rozhraní příkazového nuget.exe řádku můžete podporovat funkce NuGet v integrovaném vývojovém prostředí sady Visual Studio. Rozhraní příkazového řádku dotnet se instaluje s některými úlohami sady Visual Studio, jako je .NET Core. Rozhraní nuget.exe příkazového řádku musí být nainstalované samostatně, jak je popsáno výše. Porovnání funkcí nástrojů najdete v části Dostupnost funkcí.

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

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

dotnet SDK

Dotnet SDK je nástroj .NET Core 2.0 CLI, který funguje na všech platformách (Windows, Mac 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 Core (například .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.

Rozhraní příkazového řádku nuget.exe

Rozhraní příkazového řádku NuGet , nuget.exeje nástroj příkazového řádku pro Windows, který poskytuje všechny funkce NuGet. Toto rozhraní příkazového řádku se také může spouštět v systému Mac OSX 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í nuget.exe rozhraní příkazového řádku.

Instalace nuget.exe

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

  • Nejnovější doporučenou verzi si můžete stáhnout na adrese https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Pokud už máte nástroj rozhraní příkazového nuget.exe řádku nainstalovaný, můžete ho pomocí příkazu nuget update -selfaktualizovat na nejnovější verzi.
  • Z důvodu kompatibility se staršími systémy kontinuální integrace poskytuje předchozí adresa URL https://nuget.org/nuget.exe aktuálně zastaralé verze 2.8.6 nástroje rozhraní příkazového řádku.

  1. Navštivte nuget.org/downloads a stáhněte si NuGet verze 3.3 nebo novější.

    • Verze 5.0 a novější vyžaduje rozhraní .NET Framework verze 4.7.2 nebo novější.
    • K publikování balíčků do nuget.orgverze 4.1.0 a novějších se vyžaduje .
    • Verze 2.8.6 není kompatibilní s Mono.

  2. Každý soubor ke stažení je nuget.exe přímo. Dejte prohlížeči pokyn, aby soubor uložil do složky podle vašeho výběru. Soubor ke stažení není instalační program, takže pokud soubor spustíte přímo z prohlížeče, nic neuvidíte.

  3. Pokud chcete nástroj ROZHRANÍ příkazového řádku používat odkudkoli, přidejte umístění nuget.exe složky pro soubor do proměnné prostředí PATH.

Dostupnost funkcí

Následující tabulka porovnává dostupné funkce pro nástroje dotnet a nuget.exe CLI pro podporované platformy.

Funkce Rozhraní příkazového řádku dotnet nuget CLI (Windows) NuGet CLI (Mono) Visual Studio (Windows) Visual Studio pro Mac
Vyhledávací balíčky ✔ ✔ ✔ ✔ ✔
Instalace a odinstalace balíčků ✔ ✔ (1) ✔ ✔ ✔
Aktualizace balíčků ✔ ✔ ✔ ✔
Obnovení balíčků ✔ ✔ ✔ (2) ✔ ✔
Správa informačních kanálů balíčků (zdrojů) ✔ ✔ ✔ ✔ ✔
Správa balíčků v informačním kanálu ✔ ✔ ✔
Nastavení klíčů rozhraní API pro informační kanály ✔ ✔
Vytváření balíčků (3) ✔ ✔ ✔ (4) ✔
Publikování balíčků ✔ ✔ ✔ ✔
Replikace balíčků ✔ ✔
Správa složek globálního balíčku a mezipaměti ✔ ✔ ✔
Správa konfigurace NuGetu ✔ ✔ ✔

Poznámky k funkcím

  • (1) Nemá vliv na soubory projektu. Místo toho použijte nástroj rozhraní příkazového řádku sady SDK dotnet.
  • (2) Funguje pouze se packages.config soubory, nikoli se soubory řešení (.sln).
  • (3) Prostřednictvím rozhraní příkazového řádku jsou k dispozici různé pokročilé funkce balíčků, protože nejsou reprezentované v nástrojích uživatelského rozhraní sady Visual Studio.
  • (4) Funguje se .nuspec soubory, ale ne se soubory projektu.

Připravované funkce

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

Vývojáři pracující ve Windows můžou také prozkoumat Průzkumníka balíčků NuGet. Tato aplikace je opensourcový samostatný nástroj, který umožňuje 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.