`dotnet-install` 安裝腳本用來執行非管理員安裝 CLI 工具鏈和共用運行時。 其主要用於幫助自動化場景和非管理員安裝。有兩個腳本,一個是在 Windows 上工作的 PowerShell 和另一個在 Linux/OS X 上工作的 bash 腳本。他們兩者有同樣的行為。Bash 腳本... ...
說明:本文是個人翻譯文章,由於個人水平有限,有不對的地方請大家幫忙更正。
原文: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
安裝最新的預覽版本到指定的位置。