说明:本文是个人翻译文章,由于个人水平有限,有不对的地方请大家帮忙更正。
原文: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
安装最新的预览版本到指定的位置。