1. 首页
  2. 文章中心
  3. ASP.NET

.NET Core自定义项目模板的全过程

233 阅读 0 评论
我是靠谱客的博主 忧虑龙猫，这篇文章主要介绍.NET Core自定义项目模板的全过程，现在分享给大家，希望可以做个参考。

前言：

前面介绍 自定义项目模板 中介绍了一种简单的方式——通过创建项目导出为项目模板方式实现。本次将采用dotenet cil（手脚架）来创建项目模板。

那么，我们首先看下当前dotnet 支持的项目模板：

可以看到当前dotnet中已经提供了很多模板项目，那么如何根据项目开发的积累内容通过dotnet cli创建一个自己的项目来提升开发效率呢？

1、实现自定义项目模板

自定义模板项目模板肯定就需要模板实现，本次就使用使用之前文章中项目结构作为模板项目来实现自定义项目模板

　

接下跟着步骤来创建模板项目

创建模板配置文件

在项目根文件夹中创建文件夹：.template.config 并在目录下创建 template.json。如下图：

定义项目模板相关信息

　　　修改template.json内容为以下内容：

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "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

  • author：模板作者
  • classifications：模板特征标识。上文举例的配置是因为我自定义的模板包括了console和webapi。
  • identity：此模板的唯一名称
  • name：用户看到的模板名称
  • shortName：短名称。当使用CLI命令创建模板项目时，使用短名称将利于使用。
  • sourceName：模板替换的关键文本，使用时需要注意，要选择合适的替换文本，不然容易误伤代码。

项目模板安装

　　　接下来进入项目目录，将这个模板安装到cli中。使用dotnet new -i 进行模板的安装。

复制代码
1
dotnew new -i TempDemo

卸载项目模板：

复制代码
1
dotnet new -u 模板目录

使用命令创建项目：

复制代码
1
dotnet new apiTmp -n Test -o .

apiTmp：是模板配置文件中指定的shortName。

-n：指定的是将项目中出现的所有文本MyJob替换为Test，因为配置中sourceName是ApiTemplate，可按需配置。

-o：指定的是生成项目输出目录，上述命令生成项目输出到当前目录。

结果如下图：　　　　

　　

此通过dotnet cli创建项目模板已完成，但仅仅这样完全不能满足日常工作需求。

　　如：A项目需要日志记录，但B项目不需要日志记录；A项目需要制定PG数据库作为存储方式，B项目需要制定MySQL作为存储方式。

　　那么这些问题能否在项目创建时根据设置而满足项目需求呢？

2、模板项目进阶用法

文件过滤：根据参数过滤制定文件和代码内容

　　a) 定义参数：在template.json中添加以下内容：EnableAuditLog-参数名称

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  //……
  "symbols": {
    //是否使用审计日志功能
    "EnableAuditLog": {
      "type": "parameter", //它是参数
      "dataType": "bool", //bool类型的参数
      "defaultValue": "false" //默认是不启用
    }
  },
  "sources": [
    {
      "modifiers": [
        {
          "condition": "(!EnableAuditLog)", //条件，由EnableAuditLog参数决定
          "exclude": [ //排除下面的文件
            "AuditLogDemo/Fliters/AuditLogActionFilter.cs"
          ]
        }
      ]
    }
  ]
}

　　b) 取消审计日志生效位置：

　c) 重新生成模板，查看当前模板支持的参数：

　　d) 创建项目检查设置是否生效：

选择执行：根据变量值选择程序集引用

　　a) 添加参数：DbType指定选项数据库类型

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
"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) 修改项目文件：根据条件选择对应程序集

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<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) 使用数据库处，同步处理

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
#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

            });
#endif

　　　d) 更新模板后，查看已生成了对应参数

　　　e) 创建项目查看生效情况：　

复制代码
1
2
3
4
5
//不使用数据库
dotnet new apiTmp -n AA -D None

//使用PG数据库
dotnet new apiTmp -n BB -D PgSQL

　　　可以看到项目引用和程序代码都根据传入参数生成了。　　　　

3、项目模板打包发布

　好东西当然不能只给自己使用，而应该怎么将生成的模板给大家使用呢？——Nuget 包发布

　a）在模板根目录创建一个nuspec文件：apiTmp.nuspec

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
<?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 命令打包　　

复制代码
1
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自定义项目模板内容请搜索靠谱客以前的文章或继续浏览下面的相关文章希望大家以后多多支持靠谱客！

最后

以上就是忧虑龙猫最近收集整理的关于.NET Core自定义项目模板的全过程的全部内容，更多相关.NET内容请搜索靠谱客的其他文章。

本图文内容来源于网友提供，作为学习参考使用，或来自网络收集整理，版权属于原作者所有。
点赞(154)

相关文章

ASP.NET Core中使用令牌桶限流的实现
ASP.NET Core中使用令牌桶限流的实现
.NET医院公众号系统线程CPU双高问题分析
.NET医院公众号系统线程CPU双高问题分析
.net数据库操作框架SqlSugar的简单入门
.net数据库操作框架SqlSugar的简单入门
ASP.NET Core实现自动依赖注入
ASP.NET Core实现自动依赖注入
.NET Core自定义项目模板的全过程
.NET Core自定义项目模板的全过程
.NET RulesEngine（规则引擎）的使用详解
.NET RulesEngine（规则引擎）的使用详解
Asp.Net Core添加请求头自定义认证的示例
Asp.Net Core添加请求头自定义认证的示例
ASP.NET Core扩展库之Http请求模拟功能的使用
ASP.NET Core扩展库之Http请求模拟功能的使用

评论列表共有 0 条评论

立即
投稿
返回
顶部