Referenční informace k rozhraní příkazového řádku NuGet

  • Článek

Rozhraní příkazového řádku NuGet (CLI) nuget.exeposkytuje kompletní rozsah funkcí NuGet pro instalaci, vytváření, publikování a správu balíčků bez provedení jakýchkoli změn v souborech projektu.

Pokud chcete použít libovolný příkaz, otevřete příkazové okno nebo prostředí Bash a pak spusťte nuget příkaz a příslušné možnosti, například nuget help pack (pro zobrazení nápovědy k příkazu balíčku).

Tato dokumentace odráží nejnovější verzi rozhraní příkazového řádku NuGet. Přesné podrobnosti o libovolné verzi, kterou používáte, získáte spuštěním nuget help požadovaného příkazu.

Pokud chcete zjistit, jak používat základní příkazy s rozhraním příkazového nuget.exe řádku, přečtěte si téma Instalace a používání balíčků 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.

Tip

Pokud chcete rozhraní příkazového řádku NuGet zpřístupnit v konzole Správce balíčků v sadě Visual Studio, přečtěte si téma Použití rozhraní příkazového řádku nuget.exe v konzole.

Dostupnost

Přesné podrobnosti najdete v dostupnosti funkcí.

  • Všechny příkazy jsou k dispozici ve Windows.
  • Všechny příkazy fungují s nuget.exe spuštěnými na mono s výjimkou případů, kdy jsou uvedeny pro pack, restorea update.
  • Příkazy pack, , localsrestoredeletea push příkazy jsou k dispozici také v systému Mac a Linux prostřednictvím rozhraní příkazového řádku dotnet.

Příkazy a použitelnost

Dostupné příkazy a použitelnost pro vytváření balíčků, spotřebu balíčků nebo publikování balíčku na hostitele:

Běžné příkazy Příslušné role Verze NuGetu Popis
pack Vytvoření 2.7+ Vytvoří balíček NuGet ze .nuspec souboru projektu nebo souboru projektu. Při spuštění na mono není vytvoření balíčku ze souboru projektu podporováno.
push Publikování Vše Publikuje balíček do zdroje balíčku.
config Vše Vše Získá nebo nastaví hodnoty konfigurace NuGet.
help or ? Vše Vše Zobrazí informace nápovědy nebo nápovědu k příkazu.
locals Využití 3.3+ Uvádí umístění globálních balíčků, http-cache a dočasných složek a vymaže obsah těchto složek.
restore Využití 2.7+ Obnoví všechny balíčky, na které odkazuje formát správy balíčků, který se používá. Při spuštění na mono se nepodporuje obnovení balíčků pomocí formátu PackageReference.
setapikey Publikování, spotřeba Vše Uloží klíč rozhraní API pro daný zdroj balíčku, pokud tento zdroj balíčku vyžaduje klíč pro přístup.
spec Vytvoření Vše Vygeneruje .nuspec soubor pomocí tokenů při generování souboru z projektu sady Visual Studio.
Sekundární příkazy Příslušné role Verze NuGetu Popis
add Publikování 3.3+ Přidá balíček do zdroje balíčků, který není http, pomocí hierarchického rozložení. Pro zdroje HTTP použijte nabízení.
odstranění Publikování Vše Odebere nebo zruší seznam balíčků ze zdroje balíčku.
init Vytvoření 3.3+ Přidá balíčky ze složky do zdroje balíčku pomocí hierarchického rozložení.
install Využití Vše Nainstaluje balíček do aktuálního projektu, ale neupravuje projekty ani referenční soubory.
list Spotřeba, možná publikování Vše Zobrazí balíčky z daného zdroje.
mirror Publikování Zastaralé ve verzi 3.2 nebo novější Zrcadlí balíček a jeho závislosti ze zdroje do cílového úložiště.
search Využití 5.8+ Vyhledá daný zdroj pomocí zadaného řetězce dotazu.
sources Consumption, Publishing Vše Spravuje zdroje balíčků v konfiguračních souborech.
update Využití Vše Aktualizace balíčky projektu na nejnovější dostupné verze. Nepodporuje se při spuštění v mono.

Různé příkazy používají různé proměnné prostředí.

Příkazy rozhraní příkazového řádku NuGet podle příslušných rolí:

Role Příkazy
Využití config, help, , install, localslist, restoresearchsetapikey, , sourcesupdate
Vytvoření config, help, init, , packspec
Publikování add, config, delete, , listhelp, push, , setapikeysources

Vývojáři, kteří se zabývají pouze využíváním balíčků, například potřebují jenom pochopit, že podmnožina příkazů NuGet.

Poznámka:

Názvy možností příkazů nerozlišují malá a velká písmena. Možnosti, které jsou zastaralé, nejsou zahrnuty v tomto odkazu, například NoPrompt (nahrazeno ) NonInteractivea Verbose (nahrazeno Verbosity).

Lokalizace

NuGet.exe průběh, upozornění a chybové zprávy se překládají do stejných národních prostředí jako Visual Studio. NuGet.exe se dodává jako jeden exe a vzhledem k aspektům velikosti jsou pouze nejčastěji povrchované zprávy přeloženy ve všech jazycích.