『.NET Core CLI工具文档』（十四）dotnet-install 脚本参考

电玩女神 2022-09-25 02:17 157阅读 0赞

> 说明：本文是个人翻译文章，由于个人水平有限，有不对的地方请大家帮忙更正。  
> 原文：[dotnet-install scripts reference][]  
> 翻译：[dotnet-install 脚本参考][dotnet-install]

## 名称 ##

dotnet-install.ps1 | dotnet-install.sh - 用于安装命令行界面（CLI）工具的脚本和共享运行时

## 概要 ##

Windows:

`dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Debug] [-NoPath] [-SharedRuntime]`

OS X/Linux:

`dotnet-install.sh [--channel] [--version] [--install-dir] [--debug] [--no-path] [--shared-runtime]`

## 描述 ##

`dotnet-install` 安装脚本用来执行非管理员安装 CLI 工具链和共享运行时。你可以从我们的 [CLI GitHub repo][] 下载脚本。

其主要用于帮助自动化场景和非管理员安装。有两个脚本，一个是在 Windows 上工作的 PowerShell 和另一个在 Linux/OS X 上工作的 bash 脚本。他们两者有同样的行为。Bash 脚本也可以“理解”为 PowerShell 的切换，因此你可以全线使用他们。

安装脚本会从 CLI 下载 ZIP/tarball（压缩包）文件生成，并且将可能在默认位置或者在通过 `--install-dir` 指定的位置进行安装。默认情况下，该安装脚本将下载 SDK 和安装它；如果你仅仅想获取共享运行时，你可以指定 `--shared-runtime` 参数。

默认情况下，安装脚本将安装位置添加到当前会话的 $PATH 中。这可以被覆盖，如果使用 `--no-path` 参数。

在运行脚本之前，请安装所有的必须 [依赖][Link 1]。

你可以使用 `--version` 参数安装一个指定的版本。该指定的版本需要由 3 部分的版本（例如：1.0.0-13232）。如果忽略，它将默认到被调用脚本的上级文件夹中找到的第一个包含 `sdkVersion`节点的 global.json 文件。如果不存在，它会使用最新的。

你也可以使用这个脚本通过用 `--debug` 参数来获得 SDK 或共享运行时的调试符号的调试二进制文件。如果第一次安装你不这样做，稍后实际上你确实需要调试符号，你可以使用这个参数和你安装的版本重新运行脚本。

## 选项 ##

不同脚本实现的选项。

### PowerShell (Windows) ###

`-Channel [CHANNEL]`

安装的渠道（例如：“future”、“preview”、“production”）。默认版本是“Production”。

`-Version [VERSION]`

安装的 CLI 版本。你需要指定由 3 部分组成的版本（例如：1.0.0-13232）。如果忽略，它将默认到被调用脚本的上级文件夹中找到的第一个包含 `sdkVersion`节点的 global.json 文件。如果不存在，它会使用最新的。

`-InstallDir [DIR]`

安装的路径。如果目录不存在则创建它。默认值是 `%LocalAppData%\.dotnet`。

`-Debug`

**true** 表明应该使用包含调试符号的更大包；否则，**false**。默认值是 **false**。

`-NoPath`

**true** 表明前缀/安装目录不导出到当前会话的路径；否则，**false**。默认值是 **false**，那就是，PATH 被修改。这使得 CLI 工具安装后立即可用。

`-SharedRuntime`

**true** 仅仅安装共享运行时。**false** 安装整个 SDK。默认值是 **false**。

### Bash (OS X/Linux) ###

`--channel [CHANNEL]`

安装的渠道（例如：“future”、“preview”、“production”）。默认版本是“Production”。

`--version [VERSION]`

安装的 CLI 版本。你需要指定由 3 部分组成的版本（例如：1.0.0-13232）。如果忽略，它将默认到第一个包含 `sdkVersion`节点的 global.json 文件。如果不存在，它会使用最新的。

`--install-dir [DIR]`

安装的路径。如果目录不存在则创建它。默认值是 `%HOME%/.dotnet`。

`--debug`

**true** 表明应该使用包含调试符号的更大包；否则，**false**。默认值是 **false**。

`--no-path`

**true** 表明前缀/安装目录不导出到当前会话的路径；否则，**false**。默认值是 **false**，那就是，PATH 被修改。这使得 CLI 工具安装后立即可用。

`--shared-runtime`

**true** 仅仅安装共享运行时。**false** 安装整个 SDK。默认值是 **false**。

## 例子 ##

Windows:

./dotnet-install.ps1 -Channel Future

OS X/Linux:

./dotnet-install.sh --channel Future

安装最新的开发版本到默认位置。

Windows:

./dotnet-install.ps1 -Channel preview -InstallDir C:\cli

OS X/Linux:

./dotnet-install.sh --channel preview --install-dir ~/cli

安装最新的预览版本到指定的位置。

[dotnet-install scripts reference]: https://docs.microsoft.com/zh-cn/dotnet/articles/core/tools/dotnet-install-script
[dotnet-install]: https://github.com/SeayXu/CheatSheet/blob/master/dotnet/dotnet-install-script.md
[CLI GitHub repo]: https://github.com/dotnet/cli/tree/rel/1.0.0-preview2/scripts/obtain
[Link 1]: https://github.com/dotnet/core/blob/master/Documentation/prereqs.md