教程:使用 .NET CLI 安装和使用 .NET 全局工具

2022-01-07 08:37:37 浏览数 (1)

本文适用于: ✔️ .NET Core 2.1 SDK 及更高版本

本教程介绍如何安装和使用全局工具。 使用在本系列的第一个教程中创建的工具。

先决条件

完成本系列的第一个教程。

使用该工具作为全局工具

通过运行 microsoft.botsay 项目文件夹中的 dotnet tool install 命令,从包中安装该工具 :

代码语言:javascript复制
dotnet tool install --global --add-source ./nupkg microsoft.botsay

--global 参数指示 .NET CLI 将工具二进制文件安装在自动添加到 PATH 环境变量的默认位置中。

--add-source 参数指示 .NET CLI 临时使用 ./nupkg 目录作为 NuGet 包的附加源数据源。 为包提供了唯一名称,以确保它仅位于 ./nupkg 目录中,而不是在 Nuget.org 站点上。

输出显示用于调用该工具和已安装的版本的命令:

代码语言:javascript复制
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.

调用该工具:

代码语言:javascript复制
botsay hello from the bot

备注

如果此命令失败,则可能需要打开新终端来刷新 PATH。

通过运行 dotnet tool uninstall 命令来删除该工具:

dotnet tool uninstall -g microsoft.botsay

使用该工具作为自定义位置中安装的全局工具

从包中安装该工具。

在 Windows 上:

代码语言:javascript复制
dotnet tool install --tool-path c:dotnet-tools --add-source ./nupkg microsoft.botsay

在 Linux 或 macOS 上:

代码语言:javascript复制
dotnet tool install --tool-path ~/bin --add-source ./nupkg microsoft.botsay

--tool-path 参数指示 .NET CLI 将工具二进制文件安装在指定位置中。 如果目录不存在,则会创建该目录。 此目录不会自动添加到 PATH 环境变量中。

输出显示用于调用该工具和已安装的版本的命令:

代码语言:javascript复制
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.

调用该工具:

在 Windows 上:

代码语言:javascript复制
c:dotnet-toolsbotsay hello from the bot

在 Linux 或 macOS 上:

代码语言:javascript复制
~/bin/botsay hello from the bot

通过运行 dotnet tool uninstall 命令来删除该工具:

在 Windows 上:

代码语言:javascript复制
dotnet tool uninstall --tool-path c:dotnet-tools microsoft.botsay

在 Linux 或 macOS 上:

代码语言:javascript复制
dotnet tool uninstall --tool-path ~/bin microsoft.botsay

疑难解答

如果在学习本教程时收到错误消息,请参阅排查 .NET 工具使用问题。

后续步骤

在本教程中,已将工具作为全局工具安装和使用。 有关如何安装和使用全局工具的详细信息,请参阅管理全局工具。 若要安装和使用与本地工具相同的工具,请转到下一教程。

安装和使用本地工具

0 人点赞