Note
dotnetup 目前已公開預覽。 其特性與行為可能會在正式上市前改變。
dotnetup 將請求的通道與已解析的版本分開儲存。
更新會再次解決每個滾動通道。
這些更新不會更新 dotnetup 的執行檔。
若要更新工具本身,請使用 dotnetup self update。
選擇更新範圍
請使用以下指令之一:
# 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
移除已追蹤的需求
要移除 SDK 需求,請傳遞其儲存的通道或精確版本:
dotnetup sdk uninstall 10.0.1xx
解除安裝會移除該相依項,然後清理選取根目錄中未被引用的安裝。
如果其他需求使所要求的安裝無法進行,或如果清理會移除額外的安裝,它就會發出警告。
在確認操作前,請先檢視這些警告。
在非互動式自動化中,請用 --non-interactive 來跳過確認,而非略過警告。
如為執行階段需求,請使用 dotnetup runtime uninstall。
詳情請參見 SDK 卸載 與 執行時卸載。