BLT.Template 1.0.1

BLT.Template官方微服务脚手架

特别说明

脚手架不是安装在项目中的！ 而是通过 CMD 或 PowerShell 安装到操作系统中的。

脚手架

Mall3s 官方提供了多种 Web 应用类型的脚手架，方便大家快速创建多层架构项目。目前支持以下应用脚手架：

BLT.Template

模板类型	名称	版本	关键词	描述
(opens new window)	BLT.Template	V1.0.1	👉 blt-template	Webapi/后台任务/mq模板

目录结构

--Template                          //Template服务相关项目
    --BLT.Template             //服务，继承BLT.Template.Interface
    --BLT.Template.Entities    //实体
    --BLT.Template.Interface   //接口
    --BLT.Template.SDK         //对外提供BaseData服务的SDK，如多类服务，可统一放在Common上，这个没有特别的要求
--Common                            //公共类相关项目
    --BLT.Template.Library              //公共库
--Test                              //单元测试相关项目
    --BLT.Template.Test                 //单元测试
--WebApi                            //对外接口相关项目
    --BLT.Template.Api                  //接口，引用服务，项目引用多少服务就拥有多少服务对应的接口，可拆开项目划分

安装脚手架 #

打开 CMD 或 Powershell 执行模板安装命令（新版本 --install 可换成 install）：

dotnet new --install BLT.Template::1.0.1

使用脚手架 #

暂时框架只支持.net 6.0

dotnet new blt-template -n 项目名称 -o 项目路径 -f .NET版本

dotnet new blt-template -n Oms -o D:\work\test\test2

这样就可以生成项目代码了，生成之后推荐将所有的 nuget 包更新到最新版本。

关于项目名称和 .NET 版本

通过脚手架生成的项目名称不能包含 短横线 等特殊字符，如有该需求，可在生成之后通过 Visual Studio 进行手动修改。

特别提醒

blt-template 对应的是上面列表的 关键字，我们也可以通过 dotnet new --list 查看。

想了解更多可以使用 dotnet new 关键字 --help 查看更多参数。

脚手架更新 #

只需要重新安装最新版替换即可，如：

dotnet new --install blt-template::1.0.1

不带版本号总是安装最新的版本。

使用教程指引 #

1. 打开window命令行cmd窗口。

2. 执行安装脚手架命令。

   dotnet new --install Mall3s.Template::1.0.1
   

3. 初始化项目。

   dotnet new blt-template -n Oms -o D:\work\test\test2
   

4. 查看项目代码，启动工程。

项目环境依赖 #

若您的脚手架无法启动，请检查是否安装好以下环境，否则请注释掉对应的微服务模块注入。

1. nacos
2. xxl-job
3. rabbitmq
4. redis
5. mysql