更新或移除 dotnetup

Note

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

本文將說明如何管理該 dotnetup 工具本身。 若要更新或移除由 dotnetup 管理的 .NET SDK 和執行階段,請參閱 更新安裝。

請查看 dotnetup 版本

顯示 dotnetup 的版本:

dotnetup --version

若要同時顯示提交、架構、執行時識別碼及已驗證的安裝,請執行:

dotnetup --info

更新dotnetup

要在原地更新獨立的 dotnetup 執行檔,請執行:

dotnetup self update

此指令可在 dotnetup 0.3.0 預覽版中使用。 它會從已安裝的版本標籤中選擇發行通道。 官方每日版本也會使用這個 preview 標籤,因此請明確指定頻道以持續使用每日版本:

dotnetup self update --channel daily

要從較新的每日版本返回到最新的公開預覽,請執行:

dotnetup self update --channel preview --force

--force 可以降級或重新安裝執行檔。 關於指令選項與限制,請參見 dotnetup self update。

更新 dotnetup 不會改變你的 .NET 安裝、環境設定或追蹤的安裝規格。

從舊版更新或恢復執行檔

如果你的版本無法辨識 self update,或執行檔無法啟動,請重新執行下載腳本。 腳本會替換選定安裝目錄中現有的執行檔。

在 macOS 或 Linux 上,執行:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

在 Windows 上,執行:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

腳本預設安裝最新的 preview 建置版本。 如果你使用 daily 建置檔或自訂安裝目錄,請傳遞你第一次安裝時使用的相同選項。 例如,在 macOS 或 Linux 上:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

在 Windows 上:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

設定更新通知

在成功完成互動式安裝與更新指令後,dotnetup 可以通知你有更新的版本可用。 提示不會安裝更新。

要停用通知,請執行:

dotnetup self update --update-notifications false

要再次啟用通知,請使用 --update-notifications true。 關於檢查頻率與輸出行為,請參見 更新通知。

移除 dotnetup

要移除 dotnetup 及它所管理的所有內容,請依序完成這些步驟。

1. 找出安裝根目錄

列出 dotnetup 追蹤的安裝根目錄:

dotnetup list

記錄每個不在 dotnetup 資料目錄中的安裝根目錄。 您會在後續步驟中刪除這些資料夾。

2. 移除環境設定

移除 dotnetup 對 PATH 和 DOTNET_ROOT 所做的變更:

dotnetup env clear

在 shell 模式中,從設定檔 dotnetup 已變更的那個 shell 執行此指令,或使用 --shell 選項選取該 shell。 在 Windows 的 everywhere 模式下,這個指令會變更系統PATH,並且需要提升權限。

這個指令不會移除 SDK 或執行時。 更多資訊請參閱 「移除環境設定」。

3. 刪除安裝根目錄與資料目錄

刪除你在第一步記錄的每個安裝根目錄。

然後刪除 dotnetup 的資料目錄。 此目錄包含預設安裝根目錄、清單、設定檔及下載快取。

作業系統 預設資料目錄
Windows 作業系統 %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetup,或在未設定 XDG_DATA_HOME 時,則為 ~/.local/share/dotnetup

如果你設定了 DOTNET_DOTNETUP_DATA_DIR 環境變數,請改為刪除那個目錄,然後移除該環境變數。

4. 刪除 dotnetup 執行檔

刪除包含 dotnetup 該執行檔的目錄。 預設情況下,下載腳本將 dotnetup 安裝在 ~/.dotnetup。 如果你手動新增這個目錄 PATH ,請從你的 shell 設定檔或使用者環境變數中移除該條目。

開啟一個新終端機以使用更新後的環境。

也請參閱