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

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

上一篇:『.NET Core CLI工具文档』(一).NET Core 命令行工具(CLI)


下一篇:『.NET Core CLI工具文档』(六)dotnet 命令