dotnetup 如何運作

Note

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

dotnetup 它會把您要求的項目和它安裝的檔案分開。 此模式允許多個需求項目共用一個 .NET 安裝,並讓 dotnetup 移除不再需要的檔案。

安裝根目錄

.NET 安裝根目錄是 dotnetup 追蹤的目錄。 安裝根節點有:

  • 一個完整限定的目錄路徑。
  • 一個架構:x86、x64或arm64。
  • 零個或多個安裝規格,指定為 channels。
  • 零個或多個具體安裝。

目前的 CLI 會安裝為執行中 dotnetup 程序的架構版本。 它沒有架構選項。

dotnetup 管理的預設 .NET 安裝根目錄為 dotnetup 資料目錄中的 dotnet 子目錄:

Platform 預設安裝根目錄
Windows 作業系統 %LOCALAPPDATA%\dotnetup\dotnet
macOS ~/Library/Application Support/dotnetup/dotnet
Linux $XDG_DATA_HOME/dotnetup/dotnet,或 ~/.local/share/dotnetup/dotnet 當 XDG_DATA_HOME 未被設定時

使用 --install-path 選擇另一個安裝根目錄。 明確的安裝路徑優先於來自 global.json的路徑,而該路徑則優先於預設安裝根節點。

dotnetup不會寫入系統管理的 .NET 目錄,例如 Program Files\dotnet 或 /usr/share/dotnet。

元件

dotnetup 管理以下元件類型:

元件 執行時規範名稱 已安裝內容
.NET SDK 不適用 SDK、主機、執行時、目標包及相關 SDK 內容
.NET 運行時間 runtime Microsoft.NETCore.App 執行階段
ASP.NET Core 執行環境 aspnetcore Microsoft.AspNetCore.App 執行階段
Windows 桌面執行環境 windowsdesktop Microsoft.WindowsDesktop.AppWindows 上的執行階段

ASP.NET Core 別名aspnet與 Windows 桌面別名desktop在執行時元件規範中被接受。

安裝規格

安裝規格會記錄一個元件以及一個通道或精確版本。 例如,SDK 10.0.1xx 規範的意思是「將最新的 SDK 保持在 10.0.1xx 功能帶內」。

你可以在 「頻道」和版本中了解更多不同種類的受支援頻道和版本的資訊。

每個規格都有以下來源之一:

  • Explicit: 你在命令列中提供了通道或版本。
  • GlobalJson:dotnetup 從一個 global.json 檔案推斷 SDK 需求。

All 是卸載過濾器。 它未儲存為規範來源。

精確版本即為固定的規格。 更新指令不會使其前進。 通道規範可在更新時解析為較新的版本。

安裝與共用檔案

安裝會記錄一個具體的元件版本及其所使用的子元件目錄。 兩個規格可以解析到相同的安裝項目。

解除安裝指令會先移除相符的規格。 垃圾回收則保留與剩餘版本需求相符的最新安裝版本。 它只有在當沒有任何剩餘規格需要它們時,才移除安裝及其未共享的子元件。

在解除安裝變更狀態之前,若其他規範保留了請求的安裝,或垃圾回收移除了額外的安裝,則會發出警告。 在互動模式下,這些警告需要使用者確認。 詳情請參見 SDK 卸載行為 與 執行時卸載行為。

已追蹤與未追蹤的安裝

預設情況下,安裝指令會將其規格與結果記錄在資訊清單中。 追蹤安裝可由 dotnetup 列出、更新並移除。

這個 --untracked 選項可以安裝檔案但不會記錄它們。 dotnetup 不列出、更新或移除那些檔案。 只有當其他程序擁有目標目錄時,才使用此選項。

為防止意外混合,若目標包含現有但不在所選資訊清單中的 .NET 安裝,追蹤安裝即失敗。 選擇不同的目錄、移除現有安裝,或使用 --untracked.

狀態檔

dotnetup 資料目錄包含以下使用者層級狀態檔案:

檔案 Purpose
dotnetup_manifest.json 追蹤安裝根目錄、安裝規範、安裝及共享子元件。
dotnetup_manifest.json.sha256 偵測到 dotnetup 未撰寫的資訊清單內容變更。
dotnetup.config.json 儲存 .NET 存取模式、dotnetup 目錄是否位於 PATH 上,以及是否啟用更新通知。
update-checks/ 儲存時間戳記和 dotnetup 更新檢查的可用版本。

請勿編輯這些檔案。 使用 dotnetup install、 update、 uninstall和 env 指令來更改相關狀態。 用 dotnetup self update --update-notifications <true|false> 來更改通知設定,而不需更新執行檔。

DOTNET_DOTNETUP_DATA_DIR環境變數會變更資料目錄。 這個 --manifest-path 選項只會變更單一指令所使用的資訊清單。 它不會改變設定檔或預設安裝根目錄。

並行作業

安裝、更新、卸載、列出及垃圾回收等工作流程協調對共享安裝狀態的存取。 一個接受多個規格的指令會在安裝前解析這些規格,並可同時下載它們。 清單變更仍維持序列化。

自我更新則是協調 dotnetup 執行檔的替換,並與 .NET 安裝狀態分開。 其他指令在自我更新持有其協調鎖時可能會失敗。 更新結束後重試這些指令。 如需詳細資訊,請參閱 dotnetup self update。

也請參閱