新建项目

安装或升级模板

dotnet new install ZhonTai.Template

升级模板命令和安装模板命令相同

安装指定版本

dotnet new install ZhonTai.Template::8.6.0

查看帮助

dotnet new MyApp -h

-nau, --no-apiui            Disable api document support
                            类型: bool
                            默认: false
-nts, --no-task-scheduler   Disable task scheduler support
                            类型: bool
                            默认: false
-nc, --no-cap               Cap for building distributed transaction and eventbus
                            类型: bool
                            默认: false
-nt, --no-tests             No testing project library
                            类型: bool
                            默认: false
-ns, --no-sample            No module examples
                            类型: bool
                            默认: false
-md, --merge-db             Merge admindb to maindb support
                            类型: bool
                            默认: false
-ms, --micro-service        Micro service project support
                            类型: bool
                            默认: false
-db, --db-type              The database for the project
                            类型: choice
                            MySql       MySql
                            PostgreSQL  PostgreSQL
                            SqlServer   SqlServer
                            Oracle      Oracle
                            Sqlite      Sqlite
                            Firebird    Firebird
                            MsAccess    MsAccess
                            Dameng      达梦
                            ShenTong    神通
                            KingbaseES  人大金仓
                            Gbase       南大通用
                            ClickHouse  ClickHouse
                            QuestDb     QuestDb
                            Xugu        虚谷
                            默认: Sqlite

查看已安装模板

dotnet new list

卸载模板

dotnet new uninstall ZhonTai.Template

创建新项目

dotnet new MyApp -n MyCompanyName.MyProjectName

选择MyCompanyName.MyProjectName.Host设为启动项目。直接编译运行后，将在 bin\Debug\net8.0 目录下自动创建SQLite数据库admindb.db， 使用Navicat工具连接 admindb.db 数据库查看表结构和数据

• 切换数据库为MySql

dotnet new MyApp -n MyCompanyName.MyProjectName  -db MySql

• 无新版接口文档、Cap 和任务调度功能，同时切换数据库为MySql

dotnet new MyApp -n MyCompanyName.MyProjectName  -nau true -nc true -nts true -db MySql

• 新建 admin 权限管理项目，将权限数据库admindb合并到业务库appdb中，同时切换数据库为MySql

dotnet new MyApp -n MyCompanyName.MyProjectName  -md true -db MySql

注意

合并库项目需要将 InitData/Admin/*.json 文件移动到 InitData/App 文件夹中

• 新建微服务项目（不初始化 Admin 数据和显示接口文档，无登录和接口权限控制，不记录操作日志，有数据权限控制），同时切换数据库为MySql

dotnet new MyApp -n MyCompanyName.MyProjectName  -ms true -db MySql

• 🔥多模块开发时，已熟悉怎么开发不想要模块示例，不想增加测试库，可以这样配置 8.3.0

dotnet new MyApp -n MyCompanyName.MyProjectName  -nt true -ns true

更改 jwtconfig.json 配置文件

项目启动前记得修改 token 密钥，很重要！！！

在 mysql 中通过以下查询语句获得一个 32 位长度的唯一编码

SELECT UUID() 
-- 33ce0d4b-3a7b-11ef-8563-526747b33ad4

将生成的唯一编码删除破折号-后，设置 securityKey 密钥

{
  "JwtConfig": {
    //密钥，注意字符串长度不能低于 32 位
    "securityKey": "33ce0d4b3a7b11ef8563526747b33ad4",
  }
}