外观
nebula-support 概述
2026-03-05
nebula-support 是 Nebula 框架的基础设施层,为所有上层框架模块和业务项目提供两个核心能力:
- 统一依赖版本管理
- 标准化 Gradle 构建流程
组件模块
| 子模块 | Maven 坐标 | 作用 |
|---|---|---|
nebula-support-dependencies | com.huida.nebula.support:nebula-support-dependencies | 第三方依赖 BOM,统一管理 Spring Boot、MyBatis-Plus、Redisson 等 50+ 组件版本 |
nebula-boot-plugin-gradle | 插件 ID:com.huida.nebula.plugin.boot | Gradle 构建插件,自动配置仓库、编译参数、公共依赖、Maven 发布等 |
功能清单
nebula-support-dependencies(BOM)
- 导入 Spring Boot / Spring Cloud / Spring Cloud Alibaba 官方 BOM
- 管理持久层(MyBatis-Plus、Druid、ShardingSphere)版本
- 管理服务治理(Nacos、Sentinel、Seata)版本
- 管理缓存(Redisson)、工具库(Hutool、Guava、Lombok)、文档(Knife4j)等版本
- 引入后所有受管依赖无需写版本号
nebula-boot-plugin-gradle(构建插件)
- 自动配置 Maven 仓库(本地 → 私服 → 阿里云镜像 → 中央仓库)
- 统一 Java 编译版本(JDK 17)、编码(UTF-8)、编译参数
- 自动注入公共依赖(Lombok、MapStruct、Spring Boot Configuration Processor)
- 自动导入
nebula-support-dependenciesBOM - 全局依赖排除(Tomcat → Undertow、Log4j2 替换)
- Maven 发布:按模块名称规则自动识别可发布模块,区分 SNAPSHOT/Release 策略
- Spring Boot 应用自动识别与配置
适用场景
| 场景 | 推荐方式 |
|---|---|
| 新建 Nebula 框架模块(如新增一个 starter) | 引入构建插件,开箱即用 |
| 业务项目引入 Nebula 框架依赖 | 通过 BOM 统一版本,无需逐个指定 |
| 需要将框架模块发布到 Nexus | 开启插件的 enablePublish 配置 |
| 已有自定义发布内容、只需注入发布仓库 | 开启 enablePublishRepository 配置 |
文档阅读推荐
| 文档 | 内容 |
|---|---|
| 快速入门 | 5 步完成环境搭建,适合初次接入 |
| 依赖版本管理 | BOM 引入方式 + 完整依赖版本表 |
| 构建插件使用指南 | 插件各功能详解 + 多场景配置示例 |
| 配置参考手册 | nebula {} 全属性速查表 |
