dotnetup 的存放庫 SDK 需求

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$ 為哨兵,也不會跳過空白條目。

安裝路徑優先順序為:

  1. --install-path。
  2. 最近的 global.json 中的第一筆 sdk.paths 記錄。
  3. 預設由 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 以選擇自訂根目錄。

也請參閱