Ybd.AbpLite.Template
4.1.0
dotnet new install Ybd.AbpLite.Template@4.1.0
Ybd.AbpLite.Template
ABP Framework 10.7.0 轻量后端脚手架(dotnet new 模板)。分层清晰,干净起步:不含任何用户 / 登录业务,也不含 Identity / OpenIddict。数据库默认 SQL Server,也可选 MySQL / PostgreSQL。JWT、Redis、RabbitMQ、审计日志、统一返回、DbMigrator、AI、多租户按需选配。AI 和多租户默认关闭。自带测试项目,dotnet test 不需要任何数据库或中间件。
非 ABP 官方项目。通过 NuGet 引用 ABP 包,不包含 ABP 源码。
安装
dotnet new install Ybd.AbpLite.Template
更新到最新版:dotnet new install Ybd.AbpLite.Template(重复执行即可);卸载:dotnet new uninstall Ybd.AbpLite.Template。
使用
# 默认:SQL Server,带审计日志和 DbMigrator
dotnet new xiaoba -n Acme.Shop
# MySQL + Redis 缓存 + RabbitMQ 分布式事件
dotnet new xiaoba -n Acme.Shop --database mysql --redis true --eventbus rabbitmq
# PostgreSQL
dotnet new xiaoba -n Acme.Shop --database pgsql
# 最小:不要 JWT、不要审计表、不要 DbMigrator
dotnet new xiaoba -n Acme.Shop --jwt false --audit false --migrator false
cd Acme.Shop
dotnet run --project src/Acme.Shop.HttpApi.Host # 打开 /swagger
dotnet test # 不需要数据库
| 参数 | 说明 | 默认 |
|---|---|---|
-n |
项目名。命名空间 / 项目 / 目录用原名(Acme.Shop);类名前缀去掉符号(AcmeShop),库名用下划线(Acme_Shop) |
MyApp |
--database |
sqlserver / mysql / pgsql(自动选用对应的 EF Core 驱动包与顺序 GUID 策略)。大小写不敏感,Mysql 与 mysql 相同 |
sqlserver |
--port |
Host 本地开发端口 | 5280 |
--jwt |
true 时引入 JWT 认证(NuGet 包 Ybd.AbpLite.Jwt);false 则自己配置认证 |
true |
--redis |
true 时使用 Redis 作为分布式缓存 |
false |
--audit |
true 时包含 ABP 审计日志(仅 5 张表) |
true |
--migrator |
true 时包含独立的 DbMigrator 控制台项目 |
true |
--tests |
true 时包含测试项目(xUnit + 内存 SQLite,含接口测试与分层依赖守护) |
true |
--eventbus |
local(进程内)/ rabbitmq(跨服务) |
local |
--ai |
true 时引入 AI 工作区(NuGet 包 Ybd.AbpLite.AI)。配置 Ai 节后可创建 Agent(一次运行里调用工具和内存技能)。兼容协议的 HTTP 代理只改 Endpoint。默认不拉取 AI 包 |
false |
--multitenancy |
true 时启用多租户。名单在宿主库的 AbpTenants;未写连接串的租户共享宿主库,写了 Default 连接串的租户使用独立库。不引入 Identity 和权限模块 |
false |
创建项目不会生成迁移。安装 dotnet tool install -g dotnet-ef --version 10.* 后,在项目目录执行:
dotnet ef migrations add Initial -p src/Acme.Shop.EntityFrameworkCore -s src/Acme.Shop.HttpApi.Host -o EntityFrameworkCore/Migrations
开发环境启动 Host 时会按 Database:AutoMigrateOnStartup 自动建库建表。JWT 密钥在创建时随机生成;数据库、Redis、RabbitMQ 的账号密码是开发默认值。
统一返回由独立包 Ybd.AbpLite.UnifiedResponse 提供,默认返回 { success, data, error };共享契约的 ABP 动态客户端引用 Ybd.AbpLite.UnifiedResponse.Client,或请求加 X-Unified-Response: native 获取 ABP 原生裸 DTO。
许可
MIT
-
net10.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.