參考官方檔案：
https://docs.microsoft.com/zh-cn/dotnet/core/tools/custom-templates
https://devblogs.microsoft.com/dotnet/how-to-create-your-own-templates-for-dotnet-new/
為什么要自定義模板？
通常情況下，專案都是由多個子專案組成，相互之間有一定的依賴關系，每個子專案又有各自依賴的包，也有必需的配置項、公共代碼等，當每次創建一個相同結構的專案時，需要手動創建這些子項，手動加入依賴，復制配置項和公共代碼等，這是一個沒有技術含量、繁瑣且容易出錯的操作，雖然可以通過建立模板代碼庫達到以上效果，但是拉取代碼庫后需要修改專案名稱，剔除不需要的依賴包等，也很繁瑣，dotnet new命令提供了自定義模板能力，可以根據自己的需要，動態創建專案，
template.json介紹
該檔案是創建模板必須的，它包含了創建模板所需的配置資訊，下面是必須的配置項，
關于它的完整定義可參考英文檔案：https://github.com/dotnet/templating/wiki/Reference-for-template.json
目錄結構及建議
|--templates
|--mytemplate
| |--src
| |--.template.config
| | |--template.json
| |--模板源代碼
|--mytemplate01
|--src
|--.template.config
| |--template.json
|--模板源代碼
說明：
templates：可以把多個模板都放在該檔案夾下，便于管理，
mytemplate：該檔案夾為所需要創建的模板，如果需要多個模板，只需在其同級建立其他模板檔案夾，例如mytemplate01，
src：模板源代碼存放檔案夾，
.template.config/template.json：模板配置資訊，
模板源代碼：存放自定義的模板源代碼，
創建簡單模板并使用
現在來創建一個簡單的模板，并進行模板的安裝和根據模板創建專案，這個模板為三層結構的WebApi專案，平臺版本為.Net5，添加Sqlserver驅動包和Dapper包，介面檔案使用Swagger，并逐層注入容器，
創建模板專案
新建一個模板專案，命名SingleTplDemo，目錄結構如下：
template.json檔案內容如下：
{
"$schema": "http://json.schemastore.org/template",
"author": "Bai Li",
"classifications": [ "Web/WebAPI" ],
"name": "SingleTplDemoAPI",
"identity": "SingleTplDemoAPI",
"shortName": "SingleTpl",
"tags": {
"language": "C#" ,
"type":"project"
},
"sourceName": "SingleTplDemo",
"preferNameDirectory": true
}
專案代碼結構如下：
安裝模板
使用dotnet new -i命令安裝本地模板（后面會介紹安裝遠程模板），格式如下：
dotnet new -i 模板原始碼路徑
模板原始碼路徑為.template.config檔案夾所在的路徑，
模板安裝完成后，執行dotnet new命令，可以在已安裝模板串列中看到
使用模板創建專案
使用dotnet new命令根據指定模板創建專案，格式如下：
dotnet new 模板名稱 -n 專案名稱 -o 目標路徑
提示成功，則專案創建成功，
檔案夾結構如下：
代碼結構如下：
可以看到通過這個模板創建的專案，結構和代碼檔案一致，
創建動態模板
現在也創建一個三層結構的WebAPI，平臺版本為.Net5，ORM使用Dapper，介面檔案使用Swagger，并逐層注入容器，跟簡單模板不同的是，資料驅動包含SqlServer和MySQL，接下來的計劃是，在通過模板創建專案時，僅使用引入一種資料驅動，
創建模板專案
新建專案模板，結構目錄結構如下：
template.json檔案內容如下：
{
"$schema": "http://json.schemastore.org/template",
"author": "Bai Li",
"classifications": [ "Web/WebAPI" ],
"name": "DynamicTplDemo",
"identity": "DynamicTplDemo",
"shortName": "DynamicTpl",
"tags": {
"language": "C#" ,
"type":"project"
},
"sourceName": "DynamicTplDemo",
"preferNameDirectory": true,
"symbols": {
"SqlType": {
"type": "parameter",
"description": "Sql型別",
"dataType": "choice",
"defaultValue": "MSSQL",
"isRequired": true,
"choices": [
{
"choice": "MSSQL",
"description": "MS SQL"
},
{
"choice": "MySQL",
"description": "My SQL"
}
]
},
"MSSQL": {
"type": "computed",
"value": "(SqlType == \"MSSQL\")"
},
"MySQL": {
"type": "computed",
"value": "(SqlType == \"MySQL\")"
}
}
}
該檔案引入了新的配置：symbols
參考檔案：https://github.com/dotnet/templating/wiki/Reference-for-template.json#symbols
symbols配置項內的有五種型別的子項，這里僅介紹用到的兩種型別，其余的請參考官方檔案：
SqlType：作為模板的引數，在創建專案時，需要指定可選值choice，
MSSQL、MySQL：通過value中運算式計算的結果，提供給模板作為判定資料庫型別的，
專案代碼結構如下：
DbContext.cs檔案中，通過預編譯指令#if等，實作MSSQL和MySQL驅動，以及對應IDbConnection實作的切換，完整內容如下：
using System.Data;
#if MSSQL
using Microsoft.Data.SqlClient;
#elif MySQL
using MySql.Data.MySqlClient;
#endif
namespace DynamicTplDemo.Infrastructure
{
/// <summary>
/// 資料庫背景關系
/// </summary>
public class DbContext
{
/// <summary>
/// 連接字串
/// </summary>
private string _connStr;
public DbContext(string connStr)
{
_connStr = connStr;
}
/// <summary>
/// 打開連接
/// </summary>
/// <returns></returns>
public IDbConnection OpenConnection()
{
IDbConnection conn = null;
#if MSSQL
conn = new SqlConnection();
#elif MySQL
conn = new MySqlConnection();
#endif
conn.ConnectionString = _connStr;
conn.Open();
return conn;
}
}
}
DynamicTplDemo.Infrastructure.csproj檔案中，通過節點PackageReference的Condition屬性的運算式切換，完整內容如下：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net5.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.Data.SqlClient" Version="3.0.0-preview1.21075.2" Condition="'$(MSSQL)'=='true'" />
<PackageReference Include="MySql.Data" Version="8.0.23" Condition="'$(MySql)'=='true'" />
</ItemGroup>
</Project>
安裝模板
安裝命令：
dotnet new -i E:\SourceCode\MyPractices\MyTestTemplates\templates\DynamicTplDemo\src
查看該模板資訊，執行命令：
dotnet new DynamicTpl --help
可以看到，該模板增加了選項-S|--SqlType，且該選項的可選值有MSSQL和MySQL，
使用模板創建專案
執行命令：
dotnet new DynamicTplDemoAPI -n MyDynamicApi -o E:\SourceCode\MyPractices\MyTestTemplates\codes\MyDynamicApi -S MSSQL
提示如下，則表示成功：
檔案夾結構如下：
代碼結構如下，可以看到自動引入了MSSQL的驅動包：
DbContext.cs檔案中，也可以看到僅包含了MSSQL的參考，以及SqlConnection類：
using System.Data;
using Microsoft.Data.SqlClient;
namespace MyDynamicApi.Infrastructure
{
/// <summary>
/// 資料庫背景關系
/// </summary>
public class DbContext
{
/// <summary>
/// 連接字串
/// </summary>
private string _connStr;
public DbContext(string connStr)
{
_connStr = connStr;
}
/// <summary>
/// 打開連接
/// </summary>
/// <returns></returns>
public IDbConnection OpenConnection()
{
IDbConnection conn = null;
conn = new SqlConnection();
conn.ConnectionString = _connStr;
conn.Open();
return conn;
}
}
}
模板打包成Nuget包，并上傳Nuget服務器
以上便是創建和使用模板的方法，但是直接將檔案夾安裝為模板，不是一個好的用法，因為在實際作業中，其他機器上需要使用該模板，就要把檔案夾復制過去安裝，很不方便，那這里就分享一下將模板打包稱Nuget包，并上傳到Nuget服務器，其他機器只需要執行兩行命令，就可以輕松使用上模板，
模板打包
創建檔案夾
建議在templates檔案夾的同級新建檔案夾：packages、tools，
tools：存放工具軟體，下面內容會講到，
packages：存放生成的包，下面內容會講到
下載nuget.exe檔案
下載路徑：https://www.nuget.org/downloads
選擇合適的版本，下載到上面新建的tools檔案夾下，
創建.nuspec檔案
參考檔案：https://docs.microsoft.com/zh-cn/nuget/create-packages/creating-a-package
在模板專案的根目錄下創建.nuspec檔案，本部分內容在上面創建的動態模板上進行，故選擇命名：DynamicTplDemo.nuspec，
檔案內容如下：
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
<metadata>
<id>DynamicTplDemo</id>
<version>1.0.0</version>
<authors>Bai Li</authors>
<description>動態模板包</description>
<copyright>Copyright ?2021 Contoso Corporation</copyright>
<packageTypes>
<packageType name="Template" />
</packageTypes>
</metadata>
<files>
<file src="https://www.cnblogs.com/jijiexuanfeng/p/src/**" target="src" exclude="**\bin\**;**\obj\**" />
</files>
</package>
官方檔案中關于節點的說明定義很清晰，可前往查閱，需要注意的是files>file節點，這里用來排除模板中各子專案下的bin和obj檔案夾，
打包模板，并生成.nupkg檔案
上面準備作業完成，開始進行打包，這里通過tools檔案夾下的nuget.exe工具，將指定的模板專案打包稱.nupkg檔案，并輸出到上面定義好的packages檔案夾下，
切換到指定的專案檔案夾下，執行如下命令：
E:\SourceCode\MyPractices\MyTestTemplates\tools\nuget.exe pack DynamicTplDemo.nuspec -OutputDirectory E:\SourceCode\MyPractices\MyTestTemplates\packages
當提示如下內容，則表示生成包成功，
在packages檔案夾下，可以看到已生成包：
發布包
想要在不同機器上方便使用包，是需要將包發布到nuget包服務器上，通常有兩種方式：Nuget.org、私有源，
發布到Nuget.org
參考檔案：https://docs.microsoft.com/zh-cn/nuget/nuget-org/publish-a-package
發布到私有源
參考檔案：https://docs.microsoft.com/zh-cn/nuget/hosting-packages/overview
私有源有Azure、Nuget.Server、開源專案，
這里使用Baget開源專案（https://github.com/loic-sharma/BaGet），通過Docker部署，直接使用公共鏡像：
#拉取鏡像
docker pull loicsharma/baget
#運行容器
docker run --rm --name nuget-server -p 50557:80 loicsharma/baget:latest
注：此處使用公共鏡像部署僅為了簡單展示包的上傳和安裝步驟，
Baget部署后，使用nuget.exe上傳包：
參考檔案：https://docs.microsoft.com/zh-cn/nuget/reference/cli-reference/cli-ref-push
nuget.exe push E:\SourceCode\MyPractices\MyTestTemplates\packages\DynamicTplDemo.1.0.0.nupkg -src http://localhost:50557/v3/index.json
上傳成功后，可以在Baget服務器上看到上傳的包，
使用包
添加源
將上面自建的Nuget源添加到Nuget配置中，以便后面使用，添加源命令：
dotnet nuget add source http://localhost:50557/v3/index.json -n MyBaget
安裝包
dotnet new --install DynamicTplDemo::1.0.0
安裝成功后，可以看到該包：
使用包
包的使用，跟上面“創建動態模板”的“使用模板創建專案”方式一致：
dotnet new DynamicTplDemo -n MyDynamicTpl -o E:\SourceCode\MyPractices\MyTestTemplates\codes\MyDynamicTpl -S MSSQL
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/279148.html
標籤：.NET Core