gradle 学习使用

一、GRADLE_USER_HOME

GRADLE_USER_HOME是Gradle构建工具的一个重要属性，用于设置Gradle用户目录的路径。该属性的默认值根据平台不同而不同，Windows平台默认为C:\Users\用户名\.gradle，Linux和Mac平台默认为~/ .gradle。可以通过设置该属性来指定Gradle用户目录的位置。

1、GRADLE_USER_HOME的作用

1. 缓存依赖项：Gradle会在GRADLE_USER_HOME路径下存储缓存的依赖项。这样一来，在同一个项目或者不同项目中，相同的依赖项只需要下载一次，就可以进行共享，加快了构建的速度。
2. 缓存元数据：Gradle还会将元数据（例如版本控制系统、依赖项解析结果等）存储在GRADLE_USER_HOME路径下的缓存目录中。这可以避免在构建过程中重复获取和解析元数据，提高了构建的效率。
3. 存储插件：Gradle会自动下载并安装插件，并将其存储在gradleuserhome目录下的插件目录中。这可以避免在每个项目中都需要手动安装插件，方便了使用。

 

2、GRADLE_USER_HOME的使用方法
　　a. 通过命令行设置GRADLE_USER_HOME的路径：

$ gradle -g /path/to/gradleuserhome

　　b. 通过环境变量设置GRADLE_USER_HOME的路径：

export GRADLE_USER_HOME=/path/to/gradleuserhome

　　c. 通过build.gradle文件设置gradleuserhome的路径：

allprojects {
    gradle.userHome = '/path/to/gradleuserhome'
}

 

3、gradleuserhome的注意事项

• GRADLE_USER_HOME路径必须具有写入权限，否则Gradle无法缓存依赖项、元数据等。
• GRADLE_USER_HOME路径应该定期清理，以避免磁盘空间被过多占用。可以手动删除GRADLE_USER_HOME目录下的不需要的缓存文件，也可以使用Gradle的clean命令进行清理。

 

二、gradle 常用命令

Gradle 常用命令说明:

常用gradle命令	作用
gradle clean	清空build目录
gradle classes	编译业务代码和配置文件
gradle test	编译测试代码，生成测试报告
gradle build	构建项目
gradle build -x test	跳过测试，构建项目
gradle clean bootjar --refresh-dependencies -x test	清空build文件，从干净的状态开始，重新下载所有依赖，跳过测试阶段，然后打包 Spring Boot 应用程序为一个可执行的 JAR 文件

 

需要注意的是：gradle 的指令要在含有 build.gradle 的目录执行。

 

三、gradle 初始化

Gradle 自带的 Maven 源地址是国外的，该 Maven 源在国内的访问速度是很慢的，除非使用了特别的手段。一般情况下，建议使用国内的第三方开放的 Maven 源或企业内部自建 Maven 源。

1、认识 init.d 文件夹

可以在 gradle 的 init.d 目录下创建以.gradle 结尾的文件，.gradle 文件可以实现在 build 开始之前执行，所以你可以在

这个文件配置一些你想预先加载的操作。在 init.d 文件夹创建 init.gradle 文件

allprojects {
    repositories { 
        mavenLocal() 
        maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" } 
        maven { name "Bstek" ; url "https://nexus.bsdn.org/content/groups/public/" }
        mavenCentral()
    }

    buildscript {
        repositories { 
            maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' } 
            maven { name "Bstek" ; url 'https://nexus.bsdn.org/content/groups/public/' } 
            maven { name "M2" ; url 'https://plugins.gradle.org/m2/' }
        }
    }
}

 

拓展 1：启用 init.gradle 文件的方法有：

1. 在命令行指定文件,例如：gradle --init-script yourdir/init.gradle -q taskName。你可以多次输入此命令来指定多个init文件
2. 把init.gradle文件放到 USER_HOME/.gradle/ 目录下
3. 把以.gradle结尾的文件放到 USER_HOME/.gradle/init.d/ 目录下
4. 把以.gradle结尾的文件放到 GRADLE_HOME/init.d/ 目录下

如果存在上面的4种方式的2种以上，gradle会按上面的1-4序号依次执行这些文件，如果给定目录下存在多个init脚本，会按拼音a-z顺序执行这些脚本，每个init脚本都存在一个对应的gradle实例,你在这个文件中调用的所有方法和属性，都会委托给这个gradle实例，每个init脚本都实现了Script接口。

拓展 2：仓库地址说明

• mavenLocal(): 指定使用maven本地仓库，而本地仓库在配置maven时settings文件指定的仓库位置。如E:/repository，gradle查找jar包顺序如下：USER_HOME/.m2/settings.xml >> M2_HOME/conf/settings.xml >> USER_HOME/.m2/repository
• maven { url 地址}，指定maven仓库，一般用私有仓库地址或其它的第三方库【比如阿里镜像仓库地址】。
• mavenCentral()：这是Maven的中央仓库，无需配置，直接声明就可以使用。
• jcenter():JCenter中央仓库，实际也是是用的maven搭建的，但相比Maven仓库更友好，通过CDN分发，并且支持https访问,在新版本中已经废弃了，替换为了mavenCentral()。

总之, gradle可以通过指定仓库地址为本地maven仓库地址和远程仓库地址相结合的方式，避免每次都会去远程仓库下载依赖库。这种方式也有一定的问题，如果本地maven仓库有这个依赖，就会从直接加载本地依赖，如果本地仓库没有该依赖，那么还是会从远程下载。但是下载的jar不是存储在本地maven仓库中，而是放在自己的缓存目录中，默认在USER_HOME/.gradle/caches目录,当然如果我们配置过GRADLE_USER_HOME环境变量，则会放在GRADLE_USER_HOME/caches目录,那么可不可以将gradle caches指向maven repository。我们说这是不行的，caches下载文件不是按照maven仓库中存放的方式。

 

拓展 3：阿里云仓库地址请参考：

https://developer.aliyun.com/mvn/guide