.NET Core 3.0 本地工具

.NET Core从最早期的版本就开始支持全局工具了。如果仅仅需要在某个项目中或某个文件夹中使用特定的工具,那么.NET Core 3.0就允许您这样做。 

使用.NET Core 3.0,您可以在特定的文件夹下安装“本地”工具,它的作用范围仅限于该文件夹及其子文件夹。 

 

.NET Core 3.0之前 

如果我想在一个项目中使用Cake Build,那么在.NET Core 3.0之前,我可以这样做,把Cake.Tool安装为全局的工具: 

.NET Core 3.0 本地工具

 

但是如果多个项目需要使用不同版本的 Cake.Tool,那么在.NET Core 3.0之前,我们只能这么做: 

.NET Core 3.0 本地工具

 

然后这样用: 

.NET Core 3.0 本地工具

但是这样也有几个缺点: 

  • 这个命令比较难记,略长。 

  • 没有这个项目中所安装工具的清单。 

  • 如果同一个版本的工具安装在n个地方,那么就有n个拷贝。 

  • 由于工具文件的后缀名可能不一样,所以启动工具的命令可能是和平台有关的。 

 

 

.NET Core 3.0 本地工具

打开Visual StudioPackage Manager Console(Powershell或者其它终端也可以),在安装本地工具之前,首先要创建一个本地工具清单文件,使用命令dotnet new tool-manifest 

.NET Core 3.0 本地工具

 

然后进入项目所在目录,在.config文件夹下面可以看到名为dotnet-tools.json这个文件: 

.NET Core 3.0 本地工具

 

然后我在这个项目里面安装Cake.Tool这个工具,使用dotnet tool install xxx即可: 

.NET Core 3.0 本地工具

 

然后再看dotnet-tools.json文件: 

.NET Core 3.0 本地工具

可以看到cake.tool显示在里面了。 

 

运行本地工具 

如果Cake.Tool是全局安装的话,那么我直接执行cake --help就应该有结果: 

.NET Core 3.0 本地工具

但是,很显然这样做不行。 

 

由于Cake.Tool是本地安装的,运行本地工具需要在前边加上dotnet: 

.NET Core 3.0 本地工具

这样就可以了。 

 

其实上面那种写法是下面写法的简写: 

.NET Core 3.0 本地工具

 

也可以这样写: 

.NET Core 3.0 本地工具

 

此外,在工具安装目录的子目录里也可以使用这个工具。 

 

共享本地工具 

我们可以把.config目录提交到源码管理,这样的话,其它开发者也可以使用安装的本地工具了。这些工具实际是安装在全局nuget包缓存里,如果第一次运行的时候没有安装工具的包,那么你需要先执行 dotnet tool restore 进行还原,然后才可以使用这些本地工具。 

.NET Core 3.0 本地工具