Application Construction Platform (ACP)

v2025.3.0 版本更新日志

简介

致力于对业内主流的开源框架进行整合，达到方便易用快速开发的目的。

• 使用Kotlin语言开发；
• 这不是个新轮子，而是组装各种优秀轮子；
• 该项目旨在对业内各组件框架进行封装整合的脚手架，方便进行业务开发；
• 使用该脚手架可快速开发基于Kotlin或Java语言的单体应用、Cloud应用；
• 本人会密切关注业界最新动态，并使用最新技术持续更新优化；

版本说明

• v2021.0.1.0 开始，版本号命名规范改变，前三位大版本号与所使用的SpringCloud版本号一致，第三位小版本号迭代更新，同时将发布至Maven Central
• v2021.0.4.3 开始，仅支持java 11版本，不再提供java 1.8版本
  • tips: 如需java 1.8版本，自行下载源码编译，project.properties中修改为javaVersion=1.8
• v2022.0.0.0 开始，最低要求java 17版本
• v2022.0.4.x 最后一个版本为2022.0.4.6，不再有2022.0.5.x版本，之前的2022.0.5.0-Mx 预览版内容已全部合并进入2022.0.4.6
• v2024.0.0 开始，适配Solon ，版本号命名规范改变：第1位版本号为发布时的年度，第2位版本号为功能更新，第3位版本号为bug修复及依赖更新

技术栈

一、gradle 脚本配置及使用

（一）配置文件

1.gradle/dependencies.gradle

定义外部依赖版本号

2.gradle/globalTask.gradle

全局自定义任务配置，适用于顶层项目

3.gradle/commonTask.gradle

公共自定义任务配置，适用于所有项目模块

4.gradle/publishJar.gradle

发布任务配置，适用于jar项目模块

5.gradle/publishPom.gradle

发布任务配置，适用于pom项目模块

6.spring-app.gradle

Spring Application 配置，适用于spring技术栈应用模块

7.solon-app.gradle

Spring Application 配置，适用于solon技术栈应用模块

8.settings.gradle

定义项目/模块结构

9.project.properties

gradle全局参数：

• gradleVersion：gradle版本号
• group：对应打包时的最外层groupid，最终的groupid还会加上模块路径，例如groupid.acp
• version：版本号
• encoding：编译字符集
• mavenCentralUrl：maven中央仓库地址
• javaVersion：jdk版本号

10.build.gradle

公共构建脚本

11.模块根路径/build.gradle

单个模块特有的构建脚本

（二）自定义任务

• 全局自定义任务
  • publishAll 发布所有构建至maven中央仓库，linux系统适用
  • publishToMavenLocalAll 发布所有构建至maven本地仓库，linux系统适用
• 公共自定义任务
  • clearPj 清理所有输出文件
  • release 编译、打包并输出
    • 如需编译打包对应环境，命令中使用参数 active，例如

    gradlew project:release -Pactive=test

（三）发布至maven仓库

发布至本地仓库

• 执行 publishToMavenLocal 任务

（四）升级命令

gradlew wrapper --gradle-distribution-url=https://mirrors.cloud.tencent.com/gradle/gradle-8.13-all.zip

二、工程结构

acp(root)                 -------工程根目录，root模块
  ├─ doc                  -------公共文档
  ├─ excample             -------测试模块根目录
  │    ├─ solon-cloud     -------Solon Cloud 测试模块
  │    ├─ spring-cloud    -------Spring Cloud 测试模块
  │    ├─ testkotlin      -------单体 Spring Boot Kotlin 测试模块
  │    ├─ testreactive    -------单体 Spring Boot WebFlux 测试模块
  │    └─ testspringboot  -------单体 Spring Boot 测试模块
  │    └─ testsolon       -------单体 Solon Boot 测试模块
  ├─ gradle               -------gradle脚本
  └─ modules              -------子模块路径
       ├─ core            -------核心模块
       ├─ dependency      -------依赖模块
       └─ solon           -------Solon Boot 和 Solon Cloud 适配模块
       └─ spring          -------Spring Boot 和 Spring Cloud 适配模块

三、模块说明

groupId: io.gitee.zhangbinhub.acp

1、依赖管理

位置：modules/dependency

2、核心模块

位置：modules/core

3、Spring技术栈模块

位置：modules/spring

4、Solon技术栈模块

位置：modules/solon

四、打包为 docker 镜像

• 打包：buildImage
• 打包并上传：pushImage

五、使用 Acp 开发的项目