【采坑日记】maven项目转gradle项目

爱被打了一巴掌 2023-02-27 10:53 48阅读 0赞

## 简书地址：[https://www.jianshu.com/p/cecc1e8da33b][https_www.jianshu.com_p_cecc1e8da33b] ##

## 起因： ##

原来项目基本都是基于maven来管理，但是随着spring的不断更新及市面上也大部分转用gradle，公司内部存在maven管理和gradle项目参差不一的情况，所以想尝试统一都用gradle来做项目，减少其他开发人员的成本

## 基础环境： ##

IntelliJ IDEA Community Edition 2020.1.3   (毕竟免费了，不用破解了)

jdk：1.8

springboot： 2.3.1.RELEASE

## 步骤： ##

### 1. 转换： ###

Maven项目转Gradle项目，在pom文件所在的目录中 打开Terminal中输入：

gradle init --type pom

（如果idea中gradle有配置好，也可以直接在idea中右击pom.xml文件 Open Terminal 直接在控制台中运行命令）

然后重新打开gradle项目，不然直接gradle build可能会报错 ，重新选择import Gradle项目基本上就没问题了

**注：**有的同学不知道首次怎么import  gradle项目的，可以进行如下操作（知道的同学跳过）：

File->close project  进入idea首页，import project；选择最外层的父级bulid.gradle文件即可

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 1][]

我们可以看到maven项目已经转换成gradle项目

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 2][]

## 2. 包依赖管理 ##

gradle实现类似maven的dependency-management 包依赖管理大体上有两种方式

1. 依赖项管理DSL（就是在父级的bulid.gradle中维护包的版本信息）

2. 导入原有已存在的maven-bom，本文用的就是该方式（基本就是maven常用的parent-pom.xml）

### 原项目maven-bom引用： ###

因为我们原来的maven项目的包管理基本上都是依赖于一个parent-bom来做版本控制，如果使用gradle的话又得重新配置父工程的bulid.gradle，麻烦诶，故使用gradle的mavenBom引入原有的parent-bom；

**1）首先先生成这个maven-bom**（会的继续跳过）

1.  删除无用的pom.xml文件，留下项目中的父级pom.xml
2.  右击这个管理包版本的父级pom.xml  -> Add AS Maven Project
3.  本地使用install到本地仓库，私服使用deploy发布到私服仓库![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 3][]
4.

**2）要使用包的依赖管理，就需要引入 **dependency-management-plugin插件

**3）要正常使用打包服务，就需要引入** spring-boot-gradle-plugin（配置参考下面）

【注】：直接在父级的bulid.gradle 修改配置，可以避免子项目的包引入的重复编写

父级 bulid.gradle：

buildscript {
    #变量定义
        ext {
            springBootVersion = '2.3.1.RELEASE'
            dependencyVersion = '1.0.9.RELEASE'
            tangoParentBomVersion = '1.0.1'
        }
    
    #插件库
        repositories {
            gradlePluginPortal()
        }
    #引入插件
        dependencies {
    
            classpath "io.spring.gradle:dependency-management-plugin:$dependencyVersion"
            classpath "org.springframework.boot:spring-boot-gradle-plugin:$springBootVersion"
        }
    }
    
    # 子项目需要的配置
    
    subprojects {
    #子项目引用插件
        apply plugin: 'java'
        apply plugin: 'maven-publish'
        apply plugin: 'io.spring.dependency-management'
    
    #子项目仓库指定
        repositories {
            mavenLocal()
            maven {
                url = 'https://maven.aliyun.com/repository/public/'
            }
            maven {
                url = 'http://repo.maven.apache.org/maven2'
            }
        }
    
    # 我们生成的自定义 maven-bom
        dependencyManagement {
            imports {
                mavenBom "com.tango:parent-starter-bom:$tangoParentBomVersion"
            }
        }
    
    }

**4）ok，准备完成，在子项目中我们就可以直接引用自定义的maven-bom中的包而不需要去指定版本了**

以下为子项目的 bulid.gradle

dependencies {
        compile 'org.springframework.boot:spring-boot-starter-web'
        compile 'org.springframework.boot:spring-boot-starter-actuator'
        compile 'org.springframework.boot:spring-boot-starter-aop'
        compile 'org.projectlombok:lombok'
        annotationProcessor 'org.projectlombok:lombok'
        compile 'org.apache.commons:commons-lang3'
        compile 'org.springframework.boot:spring-boot-starter-validation'
        testCompile 'org.springframework.boot:spring-boot-starter-test'
        testCompile 'junit:junit:4.12'
    }
    
    description = 'service-api'

**4）ok,运行子项目，依赖正常，正常启动**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 4][]

## **3. 打包发布** ##

结束了吗？当然没，打包的时候发现jar中并没有包含依赖的libs包，jar包只有100k明显的不对，运行jar包报错：*找不到主清单*属性或找不到主类。这时候需要引入打包的插件：spring-boot-gradle-plugin，刚才我们在父级的bulid.gradle中已经引入，但是我们还需要在子项目中应用，（不知道为什么在父级配置中设置无效，必须得在子项目中引入才起效）：

子项目 gradle文件中加入引用

jar.enabled = true
    apply plugin: 'org.springframework.boot'

gradle 重新clean->bulid，此时在目录下看到包已经正常，也可以正常运行

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 5][]

## 总结： ##

第一次用gradle还是遇到挺多坑的，主要的可能是包依赖的这个问题

排版比较乱，各位看官有看不懂的地方，还请指出哈，不喜勿喷，实力有限

参考：

关联maven-bom install问题：[https://www.jianshu.com/p/031f858f08bb][https_www.jianshu.com_p_031f858f08bb]

包依赖：[https://blog.csdn.net/u013632755/article/details/100714691][https_blog.csdn.net_u013632755_article_details_100714691]

bulid乱码问题：[https://blog.csdn.net/qq\_25740665/article/details/105609876][https_blog.csdn.net_qq_25740665_article_details_105609876]

为何转gradle：[https://www.jianshu.com/p/deb61835497d][https_www.jianshu.com_p_deb61835497d]

[https_www.jianshu.com_p_cecc1e8da33b]: https://www.jianshu.com/p/cecc1e8da33b
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70]: /images/20230209/8eb39b24f9734fea8c8d97d251ecfba0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 1]: /images/20230209/a40c905d3f4f438cb7df3c7091142866.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 2]: /images/20230209/8ee1863b61434d96af66e364eb62430c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 3]: /images/20230209/5104a93cb74747c4be3a6385612ffa3d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20200717115333384.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20200717115946641.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2h1YW5nXzU1MA==,size_16,color_FFFFFF,t_70
[https_www.jianshu.com_p_031f858f08bb]: https://www.jianshu.com/p/031f858f08bb
[https_blog.csdn.net_u013632755_article_details_100714691]: https://blog.csdn.net/u013632755/article/details/100714691
[https_blog.csdn.net_qq_25740665_article_details_105609876]: https://blog.csdn.net/qq_25740665/article/details/105609876
[https_www.jianshu.com_p_deb61835497d]: https://www.jianshu.com/p/deb61835497d