使用 .NET CORE 建立 项目模板，模板项目，Template

场景：平常工做中，你可能会碰到须要新建一个全新的解决方案的状况（如公司新起了一个新项目，须要有全新配套的后台程序），若是公司内部基础框架较多、解决方案须要DDD模式等，那么重新起项目到各类依赖引用到能实际可用，一大堆的配置都须要从新设定、测试，耗时耗力，根据项目的大小，每每可能须要 1-2 小时甚至更久。

在 .net core 以前，虽然有相关的解决方法能够实现“项目模板”这个需求，但在具体操做时很不方便，从 .net core 1.0 开始，提供了“模板引擎”，增长了 dotnet new --install（-i） 命令和选项，经过该命令，可让你方便的建立属于你本身的项目模板。

本文原始地址：https://blog.zhuliang.ltd/2019/07/net-core/custom-template-using-dotnetcore.html

经过本文你能够了解和掌握：

1. 掌握如何将一个现有解决方案中的项目做为项目模板。
   1. 掌握如何在本地建立项目模板并安装和使用。
   2. 掌握如何将本地模板打包成 nuget 包，并经过包 id 进行安装使用该模板。
2. 了解、掌握简单的 dotnet 和 nuget 命令及其配置。（windows 和 mac 会作差别说明）

准备工做

本次项目结构以下（DDD）：

你能够在个人 github 库：
https://github.com/ArtechChu/Template 直接下载该模板源码

• 用于发布的项目一共两个，Template.Console 和 Template.WebApi
  • 其中 Console 项目就是简单的引用了下其余项目进行输出。
  • WebApi 项目简单配置了下依赖注入，你能够将此项目做为 api 模板项目来讲

Console 项目概要:

WebApi 项目概要：

将本地项目做为本地模板，经过命令进行安装和使用

1. 本次示例以 Console 为例，将控制台项目涉及到的项目拷贝一份到以下文件夹中：

2. 手动建立一个名为“.template.config”的文件夹，并在该文件夹内建立文件：template.json

   {
     "$schema": "http://json.schemastore.org/template",
     "author": "Artech",
     "classifications": [ "Console" ],
     "name": "Custom Console",
     "identity": "Custom Console", //模板惟一标识
     "groupIdentity": "Custom Console", 
     "shortName": "CustomConsole", //【修改】短名称，使用 dotnet new <shortName> 安装模板时的名称
     "tags": {
       "language": "C#", 
       "type": "project" 
     },
     "sourceName": "Template", //【修改】在使用 -n 选项时，会替换模板中项目的名字
     "preferNameDirectory": true
   }

   • 这里主要说明下 shortName 和 sourceName 这 2 个属性。
     • shortName：短名称，用于在使用“dotnet new -l”命令时显示，安装时也可直接根据该短名称进行安装。
     • sourceName：当咱们在使用"dotnet new" 命令进行安装时，若是指定了 -n 或者 -o 选项，那么选项后面的名字会自动替换 sourceName 中指定的名字，由于咱们的项目命名规则是 "Template.XXXX"，因此这里设定为“Template”，若是你的项目命名规则是“公司.项目.XXX”，那么这里请设定为“公司.项目”。

3. 安装该模板到本地模板库

   # 经过以下命令查看当前本机已安装模板：
   dotnet  new  -l

   # 模板安装命令：dotnet  new  i <path | nugetId>
   # 这里由于是安装本地模板，直接使用路径（绝对和相对都可）
   dotnet  new  -i  .

4. 安装该短名称为 CustomConsole 的模板

   假定安装路径为 D:\TestTemplate
   假定新起的项目名为“Company.Group”

   # 这里使用 -n 和 -o 选项来分别指定新项目的名字以及输出目录
   # 设定新项目的名字为“Company.Group”，由于当前定位已经在 TestTemplate 文件夹内，因此直接用“.”，以下：
    dotnet   new   CustomConsole   -n   Company.Group   -o   .

   文件夹内容以下：

   • 使用模板新建的项目文件夹自动为“Company.Group.XXXX”

   测试：

   更多关于 template.json 的说明请参考：http://json.schemastore.org/template

   • 在 template.json 中，你还能够指定 symbols 等，来实现更多的自定义功能，如联动预编译指令等等。

将本地项目打包为 nuget 包，并经过命令进行安装和使用

本次示例以 Console +WebApi 为例，在 Templates\Nuget 文件夹中，创建 Content 文件夹用于存放 nuget 包内容，具体以下：

• ConsoleTemplate 中的 .template.config\template.json 内容同上方 Console 示例。

• WebApiTemplate 中的 .template.config\template.json 内容以下：

  {
    "$schema": "http://json.schemastore.org/template",
    "author": "Artech",
    "classifications": [ "WebApi" ],
    "name": "Custom WebApi",
    "identity": "Custom WebApi",
    "groupIdentity": "Custom WebApi",
    "shortName": "CustomWebApi",
    "tags": {
      "language": "C#",
      "type": "project"
    },
    "sourceName": "Template",
    "preferNameDirectory": true
  }

1. 在 content 目录内建立一个 nuspec 文件：Custom.Template.NetCore.nuspec，内容以下：

   <?xml version="1.0" encoding="utf-8"?>
   <package xmlns="http://schemas.microsoft.com/packaging/2012/06/nuspec.xsd">
     <metadata>
       <id>Custom.Template.NetCore</id>
       <version>1.0.1</version>
       <description>
         Custom Template, including WebApi, Console
       </description>
       <authors>Artech</authors>
       <packageTypes>
         <packageType name="Template" />
       </packageTypes>
     </metadata>
   </package>

   • 须要注意，packageType 为 Template，metadata.id 必须保证惟一，其余按需设置便可。
   • 必须是在 content 文件夹内。nuget 在打包的时候，是根据 content 文件夹来进行的。

2. 使用 nuget pack 命令打包

   # 注意路径的相对位置
   nuget   pack   Custom.Template.NetCore.nuspec   -OutputDirectory   .

• 打包后的内容为：

3. 发布该 nuget 包到 nuget server

   这里用的是自建 nuget server，你能够按自身状况打包上传。

   • 你能够直接使用 Nuget Package Explorer 进行发布包
   • 也可使用 nuget push 来发布，以下：

   nuget push Custom.Template.NetCore.1.0.1.nupkg -Source "你的nuget 服务 url" -ApiKey "你的nuget api key"

4. 经过 nuget 安装模板到本地

• 安装前本地已经安装的模板以下：
  

• 安装

  dotnet new -i Custom.Template.NetCore::*

5. 经过模板安装 CustomWebApi

   安装路径为：D:\TestWebApiTemplate

   dotnet  new  CustomWebApi  -n  Company.Group  -o  .

6. 建立一个解决方案，并将全部的项目添加到解决方案 Company.Group.sln 中

   dotnet new sln -n Company.Group
   # windows 下没法使用 glob pattern 只能逐个添加
   dotnet sln Company.Group.sln add Company.Group.Application\Company.Group.Application.csproj
   dotnet sln Company.Group.sln add Company.Group.Domain\Company.Group.Domain.csproj
   dotnet sln Company.Group.sln add Company.Group.DomainService\Company.Group.DomainService.csproj
   dotnet sln Company.Group.sln add Company.Group.IApplication\Company.Group.IApplication.csproj
   dotnet sln Company.Group.sln add Company.Group.IDomainService\Company.Group.IDomainService.csproj
   dotnet sln Company.Group.sln add Company.Group.Infrastructure.CrossCutting\Company.Group.Infrastructure.CrossCutting.csproj
   dotnet sln Company.Group.sln add Company.Group.Repository\Company.Group.Repository.csproj
   dotnet sln Company.Group.sln add Company.Group.WebApi\Company.Group.WebApi.csproj

   若是你用的是 mac / linux ，则能够直接用 globbing pattern 来添加，以下：

   dotnet sln Company.Group.sln add **/*.csproj

参考

https://devblogs.microsoft.com/dotnet/how-to-create-your-own-templates-for-dotnet-new/

https://github.com/dotnet/dotnet-template-samples

https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-new?tabs=netcore22

https://docs.microsoft.com/en-us/nuget/install-nuget-client-tools