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。