dotnetup 概述

Note

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

dotnetup是一個跨平台工具鏈管理器，用於使用者層級的 .NET 安裝。 它安裝 .NET SDK 與執行時，無需寫入系統管理的 .NET 目錄。 它也會追蹤你選擇的安裝需求，以便日後能更新或移除相關檔案。

使用 dotnetup 的用途：

• 安裝穩定版、預覽版、每日版或特定 .NET 版本。
• 將多個 SDK 和執行環境需求放在一個受管理的安裝中。
• 安裝最接近的 global.json 檔案所需的 SDK。
• 更新追蹤頻道時，不更改精確版本要求。
• 設定終端機與應用程式如何找到受管理的 dotnet。
• 執行受管理的PATH，不要變更dotnet。

Start

執行互動式設定：

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: Terminal Mode (Suggested)

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!

設定時會問你要安裝哪個 SDK 通道，以及你想如何存取受管理的 dotnet 命令。

若要簡潔且非互動式的安裝設定，請安裝 SDK 並配置目前的 shell：

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.

> dotnetup list
Installations (managed by dotnetup):

  <default-installation-root>

    Tracked channels:
      SDK latest  (source: explicit)

    Installed versions:
      SDK <resolved-version>  (<architecture>)

Total: 1

> dotnet --version
<resolved-version>

如果你不想更改你的 shell 設定檔，可以使用 forwarding 指令：

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.

> dotnetup dotnet --version
<resolved-version>

模式、已解析版本、架構、安裝路徑和 shell 指令會依你的系統和可用的版本而定。

dotnetup 如何管理 .NET

dotnetup 追蹤你要求的 SDK 安裝。 這種追蹤方式可以讓 dotnetup 同時更新多個安裝實例。 它也能 dotnetup 安全地移除未使用或不再支援的安裝項目。

更多資訊請參閱 dotnetup 的運作方式。

選擇接下來要讀的書

目標	文章
判斷 dotnetup 是否符合你的情境	何時使用 dotnetup
安裝 dotnetup 並執行首次設定程序	開始使用 dotnetup
了解通道、安裝根目錄與追蹤	dotnetup 運作原理
使用儲存庫的 global.json	管理儲存庫 SDK 需求
安裝 SDK 與執行環境	安裝 .NET 元件
更新或移除安裝	更新已安裝項目
更新或移除 dotnetup 本身	更新或移除 dotnetup
設定 PATH 和 DOTNET_ROOT	管理 dotnetup 環境
試試預覽版或每日版	使用預覽版和每日版
解決常見問題	dotnetup 故障排除
了解dotnetup收集的資料	dotnetup 遙測
查一下指令語法	dotnetup 指令參考

Availability

dotnetup 現已公開預覽。 指令、選項和行為可能會在預覽版間改變，且正式發行版本的支援生命週期尚未最終確定。

若要安裝 dotnetup，請參閱 開始使用 dotnetup。 安裝好後，執行 dotnetup --version 確認版本並 dotnetup --help 查看可用的指令。