Note
dotnetup 目前處於公開預覽階段。 其特性與行為可能會在正式上市前改變。
dotnetup 用於 global.json 將 SDK 需求與儲存庫或目錄樹關聯。 它會從目前目錄開始,逐層往上搜尋父目錄,並讀取最近存在的 global.json。
使用 global.json 安裝
執行不指定 channel 的 SDK 安裝指令:
dotnetup install
如果最近的 global.json 有 sdk.version,dotnetup則會根據版本和 rollForward 值推導出安裝規格。 它會將檔案的完整路徑記錄為規格來源。 如果目前目錄或其父目錄中不存在 global.json,指令就會使用該 latest 通道。 如果最近的檔案格式錯誤或包含註解,解析會失敗。 dotnetup 不會略過該檔案並搜尋父目錄,或使用 latest 該通道。
rollForward 映射
dotnetup 將 SDK 選擇政策映射 global.json 到可更新的頻道:
rollForward 數值 |
已儲存適用於 SDK 的 dotnetup 需求 10.0.103 |
|---|---|
已省略或 latestPatch |
10.0.1xx |
latestFeature |
10.0 |
latestMinor |
10 |
latestMajor |
latest |
disable、patch、feature、minor 或 major |
10.0.103 |
精確版本的映射會被釘選,且不會因更新而升級。
該 allowPrerelease 屬性不影響 dotnetup 所推導的通道。
來自 global.json 的安裝路徑
如果 sdk.paths 包含一個條目,則 dotnetup 使用第一條路徑。 相對路徑由包含 global.json的目錄解析出。
在目前的公開預覽版本中,dotnetup 會將第一個項目視為路徑。 它不會解讀 $host$ 為哨兵,也不會跳過空白條目。
安裝路徑優先順序為:
-
--install-path。 - 最近的
global.json中的第一筆sdk.paths記錄。 - 預設由 dotnetup 管理的 .NET 安裝根目錄。
保持儲存庫檔案的更新
傳遞 --update-global-json 以將 sdk.version 取代為已安裝或更新的 concrete SDK 版本:
dotnetup install --update-global-json
dotnetup sdk update --update-global-json
更新工作流程只會更新 global.json來源的 SDK 規格。 修飾符保留其他 JSON 屬性、格式及偵測到的文字編碼。
移除相符的儲存庫需求
追蹤規範 global.json 會在垃圾回收期間被刷新。
若檔案已不存在或不再包含 SDK 版本,該規範將被移除。
若要依頻道移除規格,請選擇 globaljson 來源。 此指令移除所選安裝根目錄中所有相符的規範,而非僅移除一個相符的規範:
dotnetup sdk uninstall 10.0.1xx --source globaljson
用 dotnetup list 來查找儲存的通道、來源路徑和安裝根目錄。 加入 --install-path 以選擇自訂根目錄。