前言： 前面介绍 自定义项目模板 中介绍了一种简单的方式——通过创建项目导出为项目模板方式实现。本次将采用dotenet cil（手脚架）来创建项目模板。 那么，我们首先看下当前do
前面介绍 自定义项目模板 中介绍了一种简单的方式——通过创建项目导出为项目模板方式实现。本次将采用dotenet cil（手脚架）来创建项目模板。
那么，我们首先看下当前dotnet 支持的项目模板：
可以看到当前dotnet中已经提供了很多模板项目，那么如何根据项目开发的积累内容通过dotnet cli创建一个自己的项目来提升开发效率呢？
自定义模板项目模板肯定就需要模板实现，本次就使用使用之前文章中项目结构作为模板项目来实现自定义项目模板
接下跟着步骤来创建模板项目
创建模板配置文件
在项目根文件夹中创建文件夹：.template.config 并在目录下创建 template.JSON。如下图：
定义项目模板相关信息
修改template.json内容为以下内容：
{
"author": "cwsheng", //必须
"classifications": [ "WEB/webapi" ], //必须，这个对应模板的Tags
"name": "apiTmp", //必须，这个对应模板的Templates
"identity": "ApiTemplate", //可选，模板的唯一名称
"shortName": "apitmp", //必须，这个对应模板的Short Name
"tags": {
"language": "C#" ,
"type":"project"
},
"sourceName": "ApiTemplate", // 可选，要替换的名字
"preferNameDirectory": true // 可选，添加目录
}注意：shortName和sourceName
项目模板安装
接下来进入项目目录，将这个模板安装到cli中。使用dotnet new -i 进行模板的安装。
dotnew new -i TempDemo
卸载项目模板：
dotnet new -u 模板目录使用命令创建项目：
dotnet new apiTmp -n Test -o .apiTmp：是模板配置文件中指定的shortName。
-n：指定的是将项目中出现的所有文本MyJob替换为Test，因为配置中sourceName是ApiTemplate，可按需配置。
-o：指定的是生成项目输出目录，上述命令生成项目输出到当前目录。
结果如下图：
此通过dotnet cli创建项目模板已完成，但仅仅这样完全不能满足日常工作需求。
如：A项目需要日志记录，但B项目不需要日志记录；A项目需要制定PG数据库作为存储方式，B项目需要制定Mysql作为存储方式。
那么这些问题能否在项目创建时根据设置而满足项目需求呢？
文件过滤：根据参数过滤制定文件和代码内容
a) 定义参数：在template.json中添加以下内容：EnableAuditLog-参数名称
{
//……
"symbols": {
//是否使用审计日志功能
"EnableAuditLog": {
"type": "parameter", //它是参数
"dataType": "bool", //bool类型的参数
"defaultValue": "false" //默认是不启用
}
},
"sources": [
{
"modifiers": [
{
"condition": "(!EnableAuditLog)", //条件，由EnableAuditLog参数决定
"exclude": [ //排除下面的文件
"AuditLogDemo/Fliters/AuditLogActionFilter.cs"
]
}
]
}
]
}b) 取消审计日志生效位置：
c) 重新生成模板，查看当前模板支持的参数：
d) 创建项目检查设置是否生效：
选择执行：根据变量值选择程序集引用
a) 添加参数：DbType指定选项数据库类型
"symbols": {
//数据源类型"DbType": {
"type": "parameter", //它是参数
"datatype": "choice", //选项类型
"choices": [ //选项取值
{
"choice": "Mssql",
"description": "MS SQL Server"
},
{
"choice": "mysql",
"description": "MySQL"
},
{
"choice": "PgSQL",
"description": "postgresql"
},
{
"choice": "SQLite",
"description": "SQLite"
},
{
"choice": "None",
"description": "None"
}
],
"defaultValue": "None",
"description": "The type of SQL to use"
},
"MsSQL": {
"type": "computed",
"value": "(DbType == \"MsSQL\")"
},
"MySQL": {
"type": "computed",
"value": "(DbType == \"MySQL\")"
},
"PgSQL": {
"type": "computed",
"value": "(DbType == \"PgSQL\")"
},
"SQLite": {
"type": "computed",
"value": "(DbType == \"SQLite\")"
},
"None": {
"type": "computed",
"value": "(DbType == \"None\")"
}
}b) 修改项目文件：根据条件选择对应程序集
<Project Sdk="Microsoft.net.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp3.1</TargetFramework>
</PropertyGroup>
<ItemGroup Condition="'$(None)'!='True'">
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.8" />
</ItemGroup>
<ItemGroup Condition="'$(SQLite)' == 'True'">
<PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="3.1.8" />
</ItemGroup>
<ItemGroup Condition="'$(MsSQL)' == 'True'">
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.1.8" />
</ItemGroup>
<ItemGroup Condition="'$(PgSQL)' == 'True'">
<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="3.1.4" />
</ItemGroup>
</Project>c) 使用数据库处，同步处理
#if (!None)
//审计日志存储
services.ADDDbContext<AuditLogDBContent>(options =>
{
string conn = Configuration.GetConnectionString("LogDB");
#if Sqlite
options.UseSqlite(conn, options =>
{
options.MigrationsAssembly("AuditLogDemo");
});
#endif
#if PgSQL
options.UseNpgsql(conn);
#endif
#if MsSQL
options.UseSqlServer(conn);
#endif
});
#endifd) 更新模板后，查看已生成了对应参数
e) 创建项目查看生效情况：
//不使用数据库
dotnet new apiTmp -n AA -D None
//使用PG数据库
dotnet new apiTmp -n BB -D PgSQL
可以看到项目引用和程序代码都根据传入参数生成了。
好东西当然不能只给自己使用，而应该怎么将生成的模板给大家使用呢？——Nuget 包发布
a）在模板根目录创建一个nuspec文件：apiTmp.nuspec
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="Http://schemas.microsoft.com/packaging/2012/06/nuspec.xsd">
<metadata>
<id>apiTmp</id>
<version>1.0.0</version>
<description> WebApi Template </description>
<authors>cwshegn</authors>
<packageTypes>
<packageType name="Template" />
</packageTypes>
</metadata>
</package>b）使用Nuget Pack 命令打包
nuget pack apiTmp.nuspec -OutputDirectory .c) 发布到nuget服务，给小伙伴们下载使用
通过dotnet cli 创建的模板项目，能更方便的根据项目需求生成对应的项目结构，提升开发效率。
可以动手把积累的好项目打包成一个模板项目给小伙伴们使用
参考：
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
https://docs.microsoft.com/en-us/nuget/install-nuget-client-tools
到此这篇关于.net core自定义项目模板的文章就介绍到这了,更多相关.Net Core自定义项目模板内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！
--结束END--
本文标题: .NET Core自定义项目模板的全过程
本文链接: https://lsjlt.com/news/124597.html(转载时请注明来源链接)
有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
2023-05-21
2023-05-21
2023-05-21
2023-05-21
2023-05-20
2023-05-20
2023-05-20
2023-05-20
2023-05-20
2023-05-20
回答
回答
回答
回答
回答
回答
回答
回答
回答
回答
官方手机版
微信公众号
商务合作
0