使用 dotnetup 更新已追蹤的 .NET 安裝

Note

dotnetup 目前已公開預覽。 其特性與行為可能會在正式上市前改變。

dotnetup 將請求的通道與已解析的版本分開儲存。 更新會再次解決每個滾動通道。

選擇更新範圍

請使用以下指令之一:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

執行時更新包括核心的 .NET 與 ASP.NET Core 執行環境。 在 Windows 上,它們也包含 Windows Desktop 執行階段需求。

限制安裝根目錄

預設情況下,更新可以處理所選資訊清單中所有根的相依性需求。 用 --install-path 來限制操作:

dotnetup update --install-path D:\tools\dotnet

更新儲存庫檔案

SDK 需求可以使用 global.json 作為其來源。 要將新解析的 SDK 版本寫回每個原始檔案,請執行:

dotnetup sdk update --update-global-json

若沒有此選項,dotnetup 會安裝更新,但不會編輯儲存庫檔案。

更新會在垃圾回收刷新已變更的 global.json 來源之前處理已儲存的需求。 在更改儲存庫的 global.json 後,先從該儲存庫執行 dotnetup sdk install,再更新其已儲存的需求項目。 否則,第一次更新可能仍會處理之前的需求。

了解更新行為

  • 精確的 SDK 和執行時版本會被跳過——因為是明確要求的,所以永遠無法更新。
  • 每個安裝需求都會獨立處理。
  • 單一項目失敗後,所有安裝需求的處理仍會繼續進行。
  • 指令在處理完所有剩餘安裝需求後回報失敗。
  • 成功的更新會執行垃圾回收——一個清理程序,移除所有已安裝但你設定的安裝需求其實不需要的元件。
  • 如果另一個相依需求仍需要該版本,則會保留已安裝的版本。

檢視結果

驗證追蹤狀態與磁碟上的安裝項目:

dotnetup list

對於機器可讀輸出:

dotnetup list --format json

也請參閱