『.NET Core CLI工具文檔』（八）dotnet-restore

說明：本文是我的翻譯文章，因爲我的水平有限，有不對的地方請你們幫忙更正。
原文：dotnet-restore
翻譯：dotnet-restore

名稱

dotnet-restore - 還原一個項目的依賴項和工具

概要

`dotnet restore [--source]

[--packages] [--disable-parallel]  
[--fallbacksource] [--configfile] [--verbosity]
[<root>]`

描述

dotnet restore 命令使用 NuGet 還原在 project.json 文件中被指定的依賴項，以及項目特定工具。
默認狀況下，依賴項和工具的還原是並行完成的。

爲了還原依賴項，須要提供 NeGet 包所在位置的源。
源一般是經過 NuGet.config 配置文件提供的；安裝了 CLI 工具時默認存在一個。
你能夠經過在項目目錄中建立本身的 NuGet.config 文件指定更多的源。
源也能夠在每次調用命令行上指定。

對於依賴項，你能夠在還原操做時使用 --packages 參數指定還原包的位置。
若是沒有指定，默認使用 NuGet 包緩存。
它存在全部的操做系統上的用戶目錄下的 .nuget/packages 目錄中（例如，Linux 上的 /home/user1 或者是 Windows 上的 C:\Users\user1）。

對於項目特定的工具，dotnet restore 首先還原該工具打包的包，而後繼續還原在 project.json 中指定的工具依賴項。

選項

[root]

還原的項目或者項目目錄的列表。該列表能夠是包含一個 project.json 文件的路徑，或者一個 global.json 文件或文件夾的路徑中的一個。還原操做遞歸運行全部子目錄，並還原找到的每一個給定的 project.json 文件。

-s, --source [SOURCE]

指定一個在還原操做期間使用的源。這覆蓋全部在 NuGet.config 文件中指定的源。多個源能夠經過指定此選項屢次來提供。

--packages [DIR]

指定要放置還原的包的目錄。

--disable-parallel

禁用並還原多個項目。

-f, --fallbacksource [FEED]

當在還原操做若是其它全部源不能使用的狀況下指定一個備用來源。全部有效的源格式都是容許的。多個備用源能夠經過指定此選項屢次來提供。

--configfile [FILE]

用於還原操做的配置文件（NuGet.config）。

--verbosity [LEVEL]

使用日誌詳細級別。容許的值：Debug、 Verbose、 Information、Minimal、Warning 或者 Error。

例子

dotnet restore

還原在當前目錄中的項目的依賴項和工具。

dotnet restore ~/projects/app1/project.json

還原在給定的路徑發現 app1 項目依賴項和工具。

dotnet restore -f c:\packages\mypackages

還原在當前目錄中的項目的依賴項和工具，使用文件路徑做爲備用源。

dotnet restore -f c:\packages\mypackages -f c:\packages\myotherpackages

還原在當前目錄中的項目的依賴項和工具，使用兩個文件路徑做爲備用源。

dotnet restore --verbosity Error

還原在當前目錄中的項目的依賴項和工具，並在輸出中僅顯示 errors。