『.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。