欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  后端开发

.NET Core CLI工具文档dotnet-install 脚本参考

程序员文章站 2022-04-25 10:56:26
...

名称

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