使用.Net Core CLI命令dotnet new創建自定義模板

2019 年 10 月 3 日
筆記

文章起源來自一篇部落格：使用 .NET CORE 創建項目模板，模板項目，Template – DeepThought – 部落格園
之前使用Abp的時候就很認同Abp創建模板項目的方式。想不到.Net Core出了更贊的方式創建模板。之前寫過一個系列文章，有不少對Abp框架的改動（見文章：基於.NetCore和ABP框架如何讓Windows服務執行Quartz定時作業 – repeatedly – 部落格園），如果將其加入自定義模板，應該是一個不錯的想法。
本篇文章就對該項目著手改造。項目程式碼地址：DotNetCore_Practice/ABP.WindowsService at master · PuzzledAlien/DotNetCore_Practice

系統必備

.NET Core 2.2 SDK 或更高版本。

搭建模板項目

因為是對現有的項目改造，將其作為模板進行改造，所以就直接在原有的項目上處理。私以為實際項目使用的話，可以創建一個目錄名為AbpWindowsServiceTemplate，然後將項目拷貝進去。不多廢話了。

建立文件夾，名為.template.config
在該文件下，創建文件template.json
打開文件，模板配置內容如下

{   "$schema": "http://json.schemastore.org/template",   "author": "TemplateAuthor",   "classifications": [ "Console","WebApi" ],   "name": "MyJobTemplate",   "identity": "MyJobTemplate",   "groupIdentity": "MyJobTemplate",   "shortName": "JT",   "tags": {     "language": "C#",     "type": "project"   },   "sourceName": "MyJob",   "preferNameDirectory": true  }

保存配置之後，這就算搭建成功。當然這是搭建一個項目的最基本配置，詳細配置參考請查閱 json.schemastore.org/template

基礎配置說明

$schema：template.json 文件的 JSON 架構。默認值使用http://json.schemastore.org/template。
author：模板作者
classifications：模板特徵標識。上文舉例的配置是因為我自定義的模板包括了console和webapi。
identity：此模板的唯一名稱
name：用戶看到的模板名稱
shortName：短名稱。當使用CLI命令創建模板項目時，使用短名稱將利於使用。
sourceName：模板替換的關鍵文本，使用時需要注意，要選擇合適的替換文本，不然容易誤傷程式碼。

如何使用

本地安裝模板

在文件夾.template.config所在目錄執行命令

dotnet  new  -i  .

上面的命令使用的是相對路徑進行安裝，還可以使用絕對路徑安裝。先卸載再嘗試一下絕對路徑安裝。

卸載模板

執行卸載命令

dotnet new -u

執行之後可以看到羅列處理的所有已經安裝的模板，以及相應的卸載命令。找到需要卸載的模板，類似下文。

 D:GitHubDotNetCore_PracticeABP.WindowsService      Templates:        MyJobTemplate (JT) C#      Uninstall Command:        dotnet new -u D:GitHubDotNetCore_PracticeABP.WindowsService

執行卸載命令

dotnet new -u D:GitHubDotNetCore_PracticeABP.WindowsService

結果如下，卸載成功，可以通過命令dotnet new -l查看是否卸載成功

PS D:TestTemplate> dotnet new -u D:GitHubDotNetCore_PracticeABP.WindowsServiceDemo.MyJob  PS D:TestTemplate>

絕對路徑安裝

卸載模板之後，嘗試絕對路徑安裝模板。嘗試如下，安裝成功

PS D:TestTemplate> dotnet new -i D:GitHubDotNetCore_PracticeABP.WindowsServiceDemo.MyJob

命令生成項目

PS D:TestTemplate> dotnet new JT -n Test -o .  The template "MyJobTemplate" was created successfully.

JT是模板配置文件中指定的shortName。
-n指定的是將項目中出現的所有文本MyJob替換為Test，因為配置中sourceName是MyJob，可按需配置。
-o指定的是生成項目輸出目錄，上述命令生成項目輸出到了D:TestTemplate。