Ybd.AbpLite.Template 4.1.0

dotnet new install Ybd.AbpLite.Template@4.1.0
                    
This package contains a .NET Template Package you can call from the shell/command line.

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.

Version Downloads Last Updated
4.1.0 52 11/7/2026
4.0.0 101 10/29/2026
3.0.0 105 10/26/2026
2.0.0 116 10/19/2026
1.3.0 130 10/17/2026