dotnet restore

Tento článek se týká: ✔️ .net Core 2,1 SDK a novějších verzí

Název

dotnet restore – Obnoví závislosti a nástroje projektu.

Stručný obsah

dotnet restore [<ROOT>] [--configfile <FILE>] [--disable-parallel]
    [-f|--force] [--force-evaluate] [--ignore-failed-sources]
    [--interactive] [--lock-file-path <LOCK_FILE_PATH>] [--locked-mode]
    [--no-cache] [--no-dependencies] [--packages <PACKAGES_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [-s|--source <SOURCE>]
    [--use-lock-file] [-v|--verbosity <LEVEL>]

dotnet restore -h|--help

Description

dotnet restorepříkaz používá NuGet k obnovení závislostí a také nástrojů specifických pro projekt, které jsou zadány v souboru projektu. ve většině případů nemusíte explicitně používat dotnet restore příkaz, protože NuGet obnovení se v případě potřeby spouští implicitně, když spustíte následující příkazy:

v některých případech může být nepraktické spustit implicitní NuGet obnovení pomocí těchto příkazů. Například některé automatizované systémy, například systémy sestavení, musí volat dotnet restore explicitně k řízení, když dojde k obnovení, aby bylo možné řídit využití sítě. chcete-li zabránit implicitnímu obnovení NuGet, můžete použít --no-restore příznak s libovolným z těchto příkazů k zakázání implicitního obnovení.

Zadat informační kanály

chcete-li obnovit závislosti, NuGet potřebovat informační kanály, ve kterých jsou umístěny balíčky. Informační kanály jsou obvykle poskytovány prostřednictvím konfiguračního souboru nuget.config . Pokud je nainstalována sada .NET SDK, je k dispozici výchozí konfigurační soubor. Chcete-li zadat další informační kanály, proveďte jednu z následujících akcí:

Pomocí možnosti můžete přepsat nuget.config informační kanály -s .

Informace o tom, jak používat ověřené informační kanály, najdete v tématu využívání balíčků ze ověřených informačních kanálů.

Složka globálních balíčků

U závislostí můžete určit, kde se obnovené balíčky umístí během operace obnovení pomocí --packages argumentu. pokud není zadaný, použije se výchozí NuGetá mezipaměť balíčku, která se nachází v .nuget/packages adresáři domovského adresáře uživatele ve všech operačních systémech. Například /Home/user1 v systému Linux nebo C:\Users\user1 na Windows.

nástroje specifické pro Project

U nástrojů specifických pro projekt dotnet restore nejprve obnovte balíček, ve kterém je nástroj zabalen, a poté pokračuje v obnovování závislostí nástroje, jak je uvedeno v souboru projektu.

nuget.config rozdíly

Chování dotnet restore příkazu je ovlivněno nastavením v souboru nuget.config , pokud je k dispozici. například nastavení globalPackagesFolder v nuget.config umístí obnovené balíčky NuGet do zadané složky. Toto je alternativa k zadání --packages možnosti dotnet restore příkazu. Další informace najdete v referenčníchinformacích onuget.config.

Existují tři specifická nastavení, která dotnet restore ignorují:

  • bindingRedirects

    přesměrování vazby nefungují s <PackageReference> prvky a rozhraní .net podporuje pouze <PackageReference> prvky pro NuGet balíčky.

  • řešení

    toto nastavení je Visual Studio specifické a nevztahuje se na rozhraní .net. .net nepoužívá packages.config soubor a místo toho používá <PackageReference> elementy pro NuGet balíčky.

  • trustedSigners

    V sadě .NET 5.0.100 SDK byla přidána podpora ověřování podpisů balíčku pro různé platformy.

Stažení manifestu úlohy

Když spustíte tento příkaz, inicializuje asynchronní stahování reklamních manifestů na pozadí pro úlohy. Pokud je stahování pořád spuštěné po dokončení tohoto příkazu, stahování se zastaví. Další informace najdete v tématu inzerování manifestů.

Argumenty

  • ROOT

    Volitelná cesta k souboru projektu, který má být obnoven.

Možnosti

  • --configfile <FILE>

    konfigurační soubor NuGet (nuget.config), který se má použít. Je-li tento parametr zadán, budou použity pouze nastavení z tohoto souboru. Pokud není zadaný, použije se hierarchie konfiguračních souborů z aktuálního adresáře. další informace najdete v tématu běžné konfigurace NuGet.

  • --disable-parallel

    Zakáže obnovení více projektů paralelně.

  • --force

    Vynutí vyřešení všech závislostí i v případě, že bylo poslední obnovení úspěšné. Zadání tohoto příznaku je stejné jako odstranění project.assets.jsv souboru.

  • --force-evaluate

    Vynutí obnovení, aby se znovu vyhodnotily všechny závislosti i v případě, že soubor zámku již existuje.

  • -?|-h|--help

    Vytiskne popis použití příkazu .

  • --ignore-failed-sources

    Pouze upozornit na zdroje, které selhaly, pokud existují balíčky, které splňují požadavky na verzi.

  • --interactive

    Umožňuje zastavení příkazu zastavit a počkat na vstup nebo akci uživatele. Například k dokončení ověřování.

  • --lock-file-path <LOCK_FILE_PATH>

    Výstupní umístění, kde je zapsán soubor zámku projektu. Ve výchozím nastavení je to PROJECT_ROOT\packages.lock.js.

  • --locked-mode

    Nepovolujte aktualizaci souboru zámku projektu.

  • --no-cache

    Určuje, že nejsou požadavky HTTP cache.

  • --no-dependencies

    Při obnovení projektu s odkazy z projektu na projekt (P2P) obnoví kořenový projekt a nikoli odkazy.

  • --packages <PACKAGES_DIRECTORY>

    Určuje adresář pro obnovené balíčky.

  • -r|--runtime <RUNTIME_IDENTIFIER>

    Určuje modul runtime pro obnovení balíčku. Slouží k obnovení balíčků pro moduly runtime, které nejsou explicitně uvedeny v <RuntimeIdentifiers> značce v souboru . csproj . Seznam identifikátorů modulu runtime (identifikátorů RID) najdete v katalogu RID. Zadáním této možnosti několikrát zadejte víc identifikátorů RID.

  • -s|--source <SOURCE>

    určuje identifikátor URI zdroje balíčku NuGet, který má být použit během operace obnovení. Toto nastavení přepíše všechny zdroje zadané v nuget.config soubory. Více zdrojů lze zadat zadáním této možnosti několikrát.

  • --use-lock-file

    Povoluje vygenerování souboru zámku projektu a jeho použití s obnovením.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet] , m[inimal] ,, a n[ormal] d[etailed] diag[nostic] . Výchozí formát je minimal. Další informace naleznete v tématu LoggerVerbosity.

Příklady

  • Obnovit závislosti a nástroje pro projekt v aktuálním adresáři:

    dotnet restore
    
  • Obnovit závislosti a nástroje pro app1 projekt nalezené v dané cestě:

    dotnet restore ./projects/app1/app1.csproj
    
  • Obnovte závislosti a nástroje pro projekt v aktuálním adresáři pomocí cesty k souboru, který jste zadali jako zdroj:

    dotnet restore -s c:\packages\mypackages
    
  • Obnovte závislosti a nástroje pro projekt v aktuálním adresáři pomocí dvou cest k souborům, které jsou k dispozici jako zdroje:

    dotnet restore -s c:\packages\mypackages -s c:\packages\myotherpackages
    
  • Obnoví závislosti a nástroje pro projekt v aktuálním adresáři se zobrazeným podrobným výstupem:

    dotnet restore --verbosity detailed