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.删除环境配置
删除 DOTNET_ROOT 所做的 PATH 和 dotnetup 更改:
dotnetup env clear
在 shell 模式下,从其配置文件 dotnetup 已更改的 shell 中运行此命令,或使用 --shell 选项选择该 shell。 在 Windows 上的 everywhere 模式下,此命令会更改系统 PATH,并需要特权提升。
此命令不会删除 SDK 或运行时。 有关详细信息,请参阅 删除环境配置。
3. 删除安装根目录和数据目录
删除在步骤 1 中记录的每个安装根目录。
然后删除 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 配置文件或用户环境变量中删除该条目。
打开新终端以使用更新的环境。