Sdílet prostřednictvím

příkaz restore (rozhraní příkazového řádku NuGet)

  • Článek

Platí pro: spotřeba balíčků • Podporované verze: 2.7+

Stáhne a nainstaluje všechny chybějící balíčky ze packages složky. Pokud používáte NuGet 4.0+ a formát PackageReference, vygeneruje <project>.nuget.props v případě potřeby ve obj složce soubor. (Soubor lze vynechat ze správy zdrojového kódu.)

V systému Mac OSX a Linux s rozhraním příkazového řádku v Mono není obnovení balíčků podporováno pomocí PackageReference.

Využití

nuget restore <projectPath> [options]

kde <projectPath> určuje umístění řešení nebo packages.config souboru. Podrobnosti o chování najdete v poznámkách níže.

Možnosti

  • -ConfigFile

    Konfigurační soubor NuGet, který se má použít. Pokud není zadaný, %AppData%\NuGet\NuGet.Config (Windows) nebo ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux), použije se.

  • -DirectDownload

    (4.0+) Stahuje balíčky přímo bez naplnění mezipaměti binárními soubory nebo metadaty.

  • -DisableParallelProcessing

    Zakáže paralelní obnovení více balíčků.

  • -FallbackSource

    (3.2+) Seznam zdrojů balíčků, které se mají použít jako záložní prostředky pro případ, že se balíček nenajde v primárním nebo výchozím zdroji. K oddělení položek seznamu použijte středník.

  • -Force

    V projektech založených na PackageReference vynutí vyřešení všech závislostí, i když bylo poslední obnovení úspěšné. Určení tohoto příznaku project.assets.json je podobné odstranění souboru. Tím nedojde k obejití mezipaměti http-cache.

  • -ForceEnglishOutput

    (3,5+) Vynutí spuštění nuget.exe pomocí invariantní anglické jazykové verze.

  • -ForceEvaluate

    Vynutí obnovení, aby znovu zhodnotil všechny závislosti, i když již soubor zámku existuje.

  • -?|-help

    Zobrazí informace nápovědy pro příkaz.

  • -LockFilePath

    Výstupní umístění, kde je zamčený soubor zámku projektu. Ve výchozím nastavení je PROJECT_ROOT\packages.lock.jsonto .

  • -LockedMode

    Nepovolujte aktualizaci souboru uzamčení projektu.

  • -MSBuildPath

    (4.0+) Určuje cestu nástroje MSBuild, která se má použít s příkazem a má přednost před -MSBuildVersion.

  • -MSBuildVersion

    (3.2+) Určuje verzi nástroje MSBuild, která se má použít s tímto příkazem. Podporované hodnoty jsou 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Ve výchozím nastavení se vybere msBuild ve vaší cestě, jinak se ve výchozím nastavení nastaví na nejvyšší nainstalovanou verzi nástroje MSBuild.

  • -NoHttpCache

    Zabrání NuGetu v používání balíčků v mezipaměti HTTP. Viz Správa globálních balíčků a složek mezipaměti.

  • -NonInteractive

    Potlačí výzvy k zadání uživatelského vstupu nebo potvrzení.

  • -OutputDirectory

    Určuje složku, ve které jsou balíčky nainstalovány. Pokud není zadána žádná složka, použije se aktuální složka. Vyžaduje se při obnovování se souborem packages.config , pokud PackagesDirectory se nepoužívá nebo SolutionDirectory nepoužívá.

  • -PackageSaveMode

    Určuje typy souborů, které se mají uložit po instalaci balíčku: jeden z nuspec, nupkgnebo nuspec;nupkg.

  • -PackagesDirectory

    Stejné jako OutputDirectory. Vyžaduje se při obnovování se souborem packages.config , pokud OutputDirectory se nepoužívá nebo SolutionDirectory nepoužívá.

  • -Project2ProjectTimeOut

    Časový limit v sekundách pro překlad odkazů mezi projekty

  • -Recursive

    (4.0+) Obnoví všechny projekty odkazů pro projekty UPW a .NET Core. Nevztahuje se na projekty používající packages.config.

  • -RequireConsent

    Před stažením a instalací balíčků ověří, že je povolené obnovení balíčků. Podrobnosti najdete v tématu Obnovení balíčku.

  • -SolutionDirectory

    Určuje složku řešení. Při obnovování balíčků pro řešení není platný. Vyžaduje se při obnovování se souborem packages.config , pokud PackagesDirectory se nepoužívá nebo OutputDirectory nepoužívá.

  • -Source

    Určuje seznam zdrojů balíčků (jako adresy URL), které se mají použít pro obnovení. Pokud tento příkaz vynecháte, použije zdroje zadané v konfiguračních souborech, viz Konfigurace chování NuGetu. K oddělení položek seznamu použijte středník.

  • -UseLockFile

    Umožňuje vygenerovat a použít soubor uzamčení projektu s obnovením.

  • -Verbosity [normal|quiet|detailed]

    Určuje množství podrobností zobrazených ve výstupu: normal (výchozí), quietnebo detailed.

Viz také proměnné prostředí.

Poznámky

Příkaz restore provede následující kroky:

  1. Určete režim operace příkazu restore.

    ProjectPath – typ souboru Chování
    Řešení (složka) NuGet vyhledá .sln soubor a použije ho, pokud se najde. V opačném případě se zobrazí chyba. (SolutionDir)\.nuget slouží jako výchozí složka.
    Soubor .sln Obnovení balíčků identifikovaných řešením; zobrazí chybu, pokud -SolutionDirectory se používá. $(SolutionDir)\.nuget slouží jako výchozí složka.
    packages.config nebo soubor projektu Obnovte balíčky uvedené v souboru, přeložte a nainstalujte závislosti.
    Jiný typ souboru Soubor se předpokládá jako .sln soubor výše. Pokud se nejedná o řešení, NuGet zobrazí chybu.
    (není zadána cesta projectPath)
    • NuGet hledá soubory řešení v aktuální složce. Pokud se najde jeden soubor, použije se k obnovení balíčků; Pokud se najde více řešení, NuGet zobrazí chybu.
    • Pokud neexistují žádné soubory řešení, NuGet vyhledá a použije ho packages.config k obnovení balíčků.
    • Pokud se nenajde žádné řešení nebo packages.config soubor, NuGet zobrazí chybu.

  2. Určete složku balíčků pomocí následujícího pořadí priority (NuGet zobrazí chybu, pokud se nenajde žádná z těchto složek):

    • Složka zadaná pomocí -PackagesDirectory.
    • Hodnota repositoryPath v Nuget.Config
    • Složka zadaná pomocí -SolutionDirectory
    • $(SolutionDir)\packages

  3. Při obnovování balíčků pro řešení NuGet provede následující akce:

    • Načte soubor řešení.
    • Obnoví balíčky na úrovni řešení uvedené ve $(SolutionDir)\.nuget\packages.configpackages složce.
    • Obnovte balíčky uvedené ve $(ProjectDir)\packages.configpackages složce. Pro každý zadaný balíček obnovte balíček paralelně, pokud -DisableParallelProcessing není zadán.

Příklady

# Restore packages for a solution file
nuget restore a.sln

# Restore packages for a solution file, using MSBuild version 14.0 to load the solution and its project(s)
nuget restore a.sln -MSBuildVersion 14

# Restore packages for a project's packages.config file, with the packages folder at the parent
nuget restore proj1\packages.config -PackagesDirectory ..\packages

# Restore packages for the solution in the current folder, specifying package sources
nuget restore -source "https://api.nuget.org/v3/index.json;https://www.myget.org/F/nuget"