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

说明：本文是个人翻译文章，由于个人水平有限，有不对的地方请大家帮忙更正。
原文：dotnet-install scripts reference
翻译：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 参数。

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

你可以使用 --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

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