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

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.

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.

Návod

Pokud chcete rozhraní příkazového řádku NuGet zpřístupnit v konzole Package Manager v Visual Studio, přečtěte si téma Using nuget.exe CLI v konzole.

dostupnost

Přesné podrobnosti najdete v dostupnosti funkcí .

  • Všechny příkazy jsou k dispozici na Windows.
  • Všechny příkazy fungují s nuget.exe spuštěnými na mono s výjimkou případů, kdy je uvedeno pro pack, restorea update.
  • Příkazy pack, , restoredeletelocalsa 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 NuGet Description
balíček Creation 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šechno Publikuje balíček do zdroje balíčku.
Config Všechno Všechno Získá nebo nastaví hodnoty konfigurace NuGet.
nebo ? Všechno Všechno Zobrazí informace nápovědy nebo nápovědu k příkazu.
Místní obyvatelé Spotřeba 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.
obnovit Spotřeba 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šechno Uloží klíč rozhraní API pro daný zdroj balíčku, pokud tento zdroj balíčku vyžaduje klíč pro přístup.
Spec Creation Všechno Vygeneruje soubor .nuspec pomocí tokenů při generování souboru z projektu Visual Studio.
Sekundární příkazy Příslušné role Verze NuGet Description
přidat 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í.
delete Publikování Všechno Odebere nebo zruší seznam balíčků ze zdroje balíčku.
init Creation 3.3+ Přidá balíčky ze složky do zdroje balíčku pomocí hierarchického rozložení.
nainstalovat Spotřeba Všechno Nainstaluje balíček do aktuálního projektu, ale neupravuje projekty ani referenční soubory.
list Spotřeba, možná publikování Všechno Zobrazí balíčky z daného zdroje.
Zrcadlo 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ě.
hledání Spotřeba 5.8+ Vyhledá daný zdroj pomocí zadaného řetězce dotazu.
Zdroje Consumption, Publishing Všechno Spravuje zdroje balíčků v konfiguračních souborech.
aktualizace Spotřeba Všechno Aktualizuje 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í:

Úloha Příkazy
Spotřeba config, help, , install, listlocals, restoresearchsetapikey, , sourcesupdate
Creation config, help, init, , packspec
Publikování add, config, delete, , helplist, 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).

Localization

NuGet.exeprů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 dodáván 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.

  • Last updated on