一.什么是 .NET Core Global Tools

2018年5月31日(北京时间)微软发布了 .NET Core 2.1 正式版,.NET Core 2.1 为我们带来了一个新的特性:.NET Core Global Tools。用过NodeJs的人一定对NPM不会陌生,它就是受到NPM的启发,为提供了.NET Core tools 提供了一个新的部署和扩展机制 。它是一个 .NET Core 控制台应用程序,它们是作为 NuGet 包来打包和获取的。默认情况下,这些 tools 是依赖于框架的应用程序 ,并包含其所有的 NuGet 依赖项。这意味着 .NET Core tools 默认运行在所有支持 .NET Core 的操作系统和芯片架构上,并带有一组二进制文件。默认情况下,dotnet tool install 命令会在 NuGet.org 上查找 tools 。您也可以改用您自己的 NuGet 源。

二.使用

请确保你的.NET Core SDK升级到2.1(版本号2.1.300),若没有请访问官网进行安装:https://www.microsoft.com/net/learn/get-started/windows

我们主要使用 dotnet tool 命令来进行操作:

使用情况: dotnet tool [选项] [命令]

选项:
-h, --help 显示帮助信息。 命令:
install <PACKAGE_ID> 安装在命令行上使用的工具。
uninstall <PACKAGE_ID> 卸载工具。
update <PACKAGE_ID> 将工具更新为最新稳定版本以供使用。
list 列出当前开发环境中的已安装工具。

1.命令使用:

(1).安装tool dotnet tool install -g <工具ID>

(2).卸载tool dotnet tool uninstall -g <工具ID>

(3).更新tool dotnet tool update -g <工具ID>

(4).列出本地已安装tool dotnet tool list -g

2.安装第一个tool

官方为我们提供了一个tool示例 dotnetsay,我们通过命令进行安装:

dotnet tool install -g dotnetsay

然后我们执行命令使用该工具

dotnetsay

它为我我们输出了一个机器人:

你可以访问 dotnetsay 的源码来学习如何编写 tool。

三.编写第一个.NET Core Global Tool

1.新建一个.NET Core 控制台程序

2.编写代码

我们编写一句代码,输出 “Hello .NET Core Global Tools”。

using System;

namespace HelloDotnetCoreTool
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("Hello .NET Core Global Tools");
}
}
}

3.编辑csproj文件

选中项目->右键菜单->编辑csproj文件,在 PropertyGroup节点下加入:

<PackAsTool>true</PackAsTool>

完整示例:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
<OutputType>Exe</OutputType>
<PackAsTool>true</PackAsTool>
<TargetFramework>netcoreapp2.1</TargetFramework>
</PropertyGroup> </Project>

4.编辑Nuget包信息

选中项目->右键菜单->属性->Package,编辑我们的包信息。

5.打包

我们可以使用 dotnet pack 命令来进行打包,也可以使用VS提供的菜单来进行打包:选中项目->右键菜单->打包 (项目配置选为 Release),然后在 bin\Release目录下,就可以找到我们打包的nuget包。

6.安装

打开命令提示符(cmd),进入到nuget包所在目录,执行命令进行安装:

dotnet tool install -g HelloDotnetCoreTool --add-source ./

出现如下提示表示安装成功:

然后我们使用list命令来进行查询已安装的工具列表:

dotnet tool list -g

可以看到,我们编写的工具已经安装成功了。

7.使用

我们在命令提示符(cmd)中使用命令 hellodotnetcoretool,可以输出我们刚刚编写的 “Hello .NET Core Global Tools”

四.发布到 nuget.org

我们可以将我们编写的工具发布到 nuget.org ,那么任何人都可以通过命令安装、使用我们的工具了。

使用浏览器访问:http://www.nuget.org/ ,然后注册账户进行登录。

我们选择右上角的菜单 “Upload Packages”

选择我们刚刚打包的文件进行上传就可以了:

上传以后,需要等待10分钟左右,nuget.org 会对你的包来进行验证,这个时候你是无法通过命令来安装你的工具的,只有验证通过了才行。然后再等20分钟左右,nuget.org 便会对你的工具进行索引,这个时候就能过通过搜索来访问你的工具了。

五.案例

我编写了两个实用的 .NET Core Global Tool ,在这里为大家做一下简单的介绍

1.DotnetRSA

它是一个生成RSA加密算法所需的秘钥的工具,支持生成xml、pkcs1、pkcs8三种格式,并且支持三种格式之间进行相互转换。它是一个正规的命令行应用程序。你可以使用命令来进行安装:

dotnet tool install -g dotnetrsa

详细介绍:https://www.cnblogs.com/stulzq/p/9131074.html

项目地址:https://github.com/stulzq/dotnetrsa

简单演示,生成一个 xml 格式,长度为2048的RSA秘钥

dotnetrsa gen -f xml -s 2048 -o d:\

生成的秘钥:

2.dotnet-cnblog

前面我写了一篇文章 《如何高效的编写与同步博客 (.NET Core 小工具实现)》,在里面我介绍了一个使用 .NET Core 实现的可以快速解析Markdown文件里的本地图片,并上传到博客园,同事进行内容转换然后保存到新的文件里,可以让你的博客快速的发布在博客园,不需要手动对每张图片进行上传,是一个十分方便快捷使用的小工具,现在我将它改造成了 .NET Core Global Tool,你可以使用命令来进行安装:

dotnet tool install -g dotnet-cnblog

使用方法为:

dotnet-cnblog <Markdown文件路径>

使用演示:

详细介绍以及项目地址请访问:https://github.com/stulzq/CnBlogPublishTool

六.其他工具

由 natemcmaster 维护了一个工具列表,请访问 https://github.com/natemcmaster/dotnet-tools 进行查看,我编写的dotnetrsa工具已加入此列表。

七.参考资料

如何编写.NET Core Global Tools (附两个案例)的更多相关文章

  1. [尝鲜]妈妈再也不用担心 dotnet core 程序发布了: .NET Core Global Tools

    什么是 .NET Core Global Tools? Global Tools是.NET Core 2.1 中一个初次出现的特性.Global Tools提供了一种方法,让开发人员编写的.NET C ...

  2. 如何创建一个自己的.NET Core Global Tools

    索引 NET Core应用框架之BitAdminCore框架应用篇系列 框架演示:https://www.bitadmincore.com 框架源码:https://github.com/chenyi ...

  3. NET Core 2.1 Global Tools

    微软工程师Nate McMaster的博文.NET Core 2.1 Global Tools https://natemcmaster.com/blog/2018/05/12/dotnet-glob ...

  4. .NET Core开发日志——Global Tools

    .NET Core 2.1引入了一个新的功能,Global Tools,其本质是包含控制台应用程序的nuget包,目前而言,还没有特别有用的工具,不过相信随着时间的推移,各种有创意或者实用性强的Glo ...

  5. RHEL / CentOS Linux Install Core Development Tools Automake, Gcc (C/C++), Perl, Python & Debuggers

    how do I install all developer tools such as GNU GCC C/C++ compilers, make and others, after install ...

  6. python练习:编写一个函数isIn,接受两个字符串作为参数,如果一个字符串是另一个字符串的一部分,返回True,否则返回False。

    python练习:编写一个函数isIn,接受两个字符串作为参数,如果一个字符串是另一个字符串的一部分,返回True,否则返回False. 重难点:定义函数的方法.使用str类型的find()函数,可以 ...

  7. 使用 VSCode 编写 .NET Core 项目之初体验

    注:本文在根据 微软官方文档指导下,根据自己的学习中整理,并不完全照搬文档,但也大体和文档学习路线相似,主要为记录学习过程. 官方学习地址: https://code.visualstudio.com ...

  8. .Net Core WebApi上传图片的两种方式

    我这边主要是为了上传图片,话不多说,上代码. 方式一:通过Form表单上传 后端: /// <summary> /// 上传图片,通过Form表单提交 /// </summary&g ...

  9. 如何在vscode中编写.net core 项目(vscode)

    1.下载拓展  .NET Core Extension Pack  (作者:保哥) 这个里面将需要的插件都打包了小白一键下载就好了 2.下载扩展   vscode-solution-explorer ...

随机推荐

  1. 3Delight feats. OpenVDB

    Full GI, no multiple scattering now (no point-cloud similar solution in 3Delight now) Blackbody Cart ...

  2. 轻量简单好用的C++JSON库CJsonObject

    1. JSON概述 JSON: JavaScript 对象表示法( JavaScript Object Notation) .是一种轻量级的数据交换格式. 它基于ECMAScript的一个子集.许多编 ...

  3. Jmeter学习——http请求Content encoding的重要性

    今天在测试一个接口的时候,遇到的问题,困扰了我一天 下面是一个接口,使用的是post请求,Content-Type为application/json 返回参数如下: 瞬间懵逼了!!!为什么呢?渠道是存 ...

  4. java 获取当前系统可用字体名称

    //获取系统的字体 public static void getLocalFontFamily(){ GraphicsEnvironment ge=GraphicsEnvironment.getLoc ...

  5. c#判断两个对象和对象中的属性是否相同(以及记录对象中的哪些字段,和详细的改变情况)

    当前项目需要记录变更记录,即用户在进行编辑后,将变更操作记录下来.但是数据没有发生变化,则不记录. 代码1:(仅仅返回是否变化的标识) /// <summary> /// 反射对比实体属性 ...

  6. 利用系统函数模拟实现nginx 系统脚本启动的特殊颜色专业效果

    利用系统函数模拟实现nginx 系统脚本启动的特殊颜色专业效果/etc/init.d/nginxd {start/stop/restart/reload}利用if语句实现: ============= ...

  7. vs2010 2013 2015 有用各种功能插件

    https://blog.csdn.net/daydayup_chf/article/details/80803221

  8. Linux学习之路(一)

    导语: 早前为了方便日常开发,建立跟生产环境类型的环境的时候考虑使用docker作为模拟生产环境,结果没想到给自己的学习挖了一个大坑.其他关于docker容器技术的坑先不在这里赘述,有时间的话在其他文 ...

  9. SpringCloud之初识Zuul(网关)---动态路由,权限验证

    通过前面的学习,使用Spring Cloud实现微服务的架构基本成型,大致是这样的: 我们使用Spring Cloud Netflix中的Eureka实现了服务注册中心以及服务注册与发现:而服务间通过 ...

  10. 【工具大道】使用SSH远程登录Mac 电脑

    本文地址 一.打开ssh Mac Terminal是自带SSH的,可以用whereis来看看: $ whereis ssh 但是在现有进程中找不到ssh对应的进程: $ ps aux | grep s ...