Gradle 的使用教程 -Gradle 通过 mavenLocal() 指向本地仓库 -Gradle 依赖包的存储位置
文章目录
- Gradle
Gradle
Gradle项目管理工具
基于Groovy的特定领域语言来声明项目设置
Gradle安装(Windows)
1.下载解压版
-
v6.5:https://downloads.gradle-dn.com/distributions/gradle-6.5-bin.zip(用迅雷下载可能会快些)
2.配置环境变量
- gradle_home
- 变量名:
GRADLE_HOME
- 变量值:
D:\work\gradle-6.5
(gradle安装目录)
- 变量名:
- path(编辑)
- 变量名:
Path
(编辑) - 变量值:
%GRADLE_HOME%\bin
(增加)
- 变量名:
- gradle_user_home(在远程仓库下载的jar包保存到该路径下)
- 变量名:
GRADLE_USER_HOME
- 变量值:
D:\work\gradleCK
- 变量名:
3.配置init.gradle
`allprojects { repositories { mavenLocal() maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" } } buildscript { repositories { maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' } } } }`
- 在
gradle安装目录\init.d
目录下,创建init.gradle文件,初始化基本配置:配置远程仓库地址(gradle没有自己的仓库,使用的是maven的仓库)
4.验证是否配置成功
cmd输入命令:gradle -v
Gradle工程目录
`gradle-demo |---src |---|---main |---|---|---java(放置正式代码目录) |---|---|---resources(放置正式配置文件目录) |---|---|---webapp(放置页面元素) |---|---test |---|---|---java(放置单元测试代码目录) |---|---|---resources(放置测试配置文件目录) |---build.gradle |---settings.gradle`
Gradle在idea中使用
- 创建gradle项目
- 创建完成后更改gradle配置(Settings),选择自己安装的gradle
- groovy语言编辑器,
Tools - Groovy Console
groovy编程语言
输出
`//介绍groovy编程语言 println("hello groovy"); // idea快捷键sout println("hello groovy") // 可以省略最后的分号 println "hello groovy" // 可以省略括号 println 12 + ":" + 24`
断言 assert
`age = 18 assert age == 19` * 1 * 2
定义变量
`// groovy 中定义变量 // def 是弱类型,groovy会自动根据情况来给变量赋予对应的类型 def i = 18; println i; // 字符串定义 str1 = 'xiaoming' // 定义普通字符串 str2 = "name:${str1}" //可以引用变量 str3 = '''name:xiaoming age:18''' //按格式定义字符串 println str1 println str2 println str3 // 定义一个集合类型 def list = ['a','b'] // 往list中添加元素 list.add("xiaoming") list << 'c' // 取出list中第3个元素 println list.get(2) // 定义一个map def map = ['key1':'value1','key2':'value2'] // 向map中添加键值对 map.key3 = 'value3' // 打印出key3的值 println map.get('key3')` 
闭包(无参数)
`// groovy 中的闭包 // 什么是闭包?闭包其实就是一段代码块。在gradle中,我们主要是把闭包当参数来使用 // 闭包省略() //plugins({ // id('java') //}) //相当于 //plugins { // id 'java' //} // 定义一个闭包 def b1 = { println "hello b1" } // 定义一个方法,方法里面需要闭包类型的参数 def method1(Closure closure) { //closure() closure.call() } // 调用方法method1 method1(b1) method1 b1 method1({ println "xiaoming" }) method1 { println "xiaoming" }` 
闭包(有参数)
`//定义一个闭包,带参数 def b2 = { v -> println "hello ${v}" } // 定义一个方法,方法里面需要闭包类型的参数 def method2(Closure closure){ //closure("xiaoma") closure.call("xiaoma") } // 调用方法method2 method2 b2 method2 { v -> println "hello ${v}" }` 
总结
- idea中,使用groovy语言编辑器,
Tools - Groovy Console
- 方法调用,省略分号,小括号
- 定义字符串,单引号定义普通字符串,双引号可以引用变量,三引号按格式定义字符串
gradle构建脚本介绍
gradle构建脚本介绍(build.gradle)
两个重要的概念 project 和 task
任何一个Gradle构建都由一个或多个project组成,每个project包括许多的构建部分
每个project由一个或多个Task组成,每个Task表示在构建执行过程中的一个原子操作
构建Project完成后会生成一个jar或者war文件,构建过程中Gradle基于build.gradle实例化一个org.gradle.api.Project对象,并通过project变量来隐式的调用其成员变量
Project对象属性:project(隐式使用)、group、name、version、path、description、projectDir、buildDir、ant
其它常用配置:plugins(apply plugin)、dependencies、repositories、task、ext(gradle.properties 属性配置)
Gradle管理jar包
build.gradle文件的基本内容
`plugins { id 'java' // web工程需要的插件 id 'war' } version '1.0-SNAPSHOT' group 'xin.yangshuai' sourceCompatibility = 1.8 /* * 指定所使用的仓库 */ repositories { // Gradle没有自己的中央仓库 // 先从本地maven仓库寻找依赖的jar包,存在则直接使用本地maven仓库的jar mavenLocal() // 本地maven仓库没有则从远程仓库下载jar包,并保存到 环境变量GRADLE_USER_HOME 配置的路径下 // 设置maven仓库阿里镜像地址 maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } // 配置使用Maven的中央仓库 mavenCentral() } /** * 配置依赖的jar包 */ dependencies { testCompile group: 'junit', name: 'junit', version: '4.12' /* web工程需要的jar包 */ compile group: 'org.springframework', name: 'spring-context', version: '5.0.2.RELEASE' compile group: 'org.springframework', name: 'spring-web', version: '5.0.2.RELEASE' compile group: 'org.springframework', name: 'spring-webmvc', version: '5.0.2.RELEASE' providedCompile group: 'javax.servlet', name: 'javax.servlet-api', version: '3.0.1' providedCompile group: 'javax.servlet', name: 'jsp-api', version: '2.0' }` 
配置使用的仓库repositories
使用maven本地仓库
- 修改build.gradle文件,配置maven本地仓库
mavenLocal()
`repositories { mavenLocal() }`
- 使用maven本地仓库,需要告知gradle本地maven仓库的地址,配置
M2_HOME
环境变量,M2_HOME/conf/settings.xml
中指定我们本地仓库的位置- 变量名:
M2_HOME
- 变量值:
D:\work\apache-maven-3.6.3
(maven安装路径)
- 变量名:
当我们使用maven本地仓库(mavenLocal())时,jar包会直接利用本地maven仓库,而不会去下载
注意: gradle寻找本地maven仓库位置的策略
USER_HOME/.m2/settings.xml
>>M2_HOME/conf/settings.xml
>>USER_HOME/.m2/repository
1、我们一般在
maven的安装目录/conf/settings.xml
(也就是我们配置的maven环境变量)中配置本地仓库位置,所以我们需要让gradle选择该路径,从而使用我们配置的maven本地仓库2、gradle先寻找
USER_HOME/.m2/settings.xml
,所以我们要删掉该文件(其实也可以将安装目录下的settings.xml复制过来)3、maven环境变量我们习惯配置成MAVEN_HOME,但是gradle寻找的是M2_HOME,所以我们需要配置M2_HOME环境变量
参考:https://blog.csdn.net/qq_23085893/article/details/79633934
验证: 切换使用mavenCentral()和mavenLocal(),查看jar包引用地址
使用远程仓库
- 修改build.gradle文件,配置maven中央仓库
`repositories { mavenCentral() }`
-
当需要在远程仓库下载jar包时,会将jar包保存到
GRADLE_USER_HOME\caches\modules-2\files-2.1\
文件夹下,配置GRADLE_USER_HOME
环境变量,也可以直接在idea中指定位置-
变量名:
GRADLE_USER_HOME
-
变量值:
D:\work\gradleCK
-
其它可用的远程仓库地址
`repositories { mavenLocal() // 阿里 maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } mavenCentral() }`
关于gradle中jar包引用的说明
如果我们在
repositories{}
中先配置mavenLocal()(maven本地仓库)
,再配置mavenCentral()(远程仓库)
,那么gradle引用jar的位置就会出现两个,如果本地maven仓库中存在则直接引用本地maven仓库中的jar包,如果本地maven仓库中不存在,则会连接远程仓库地址,将jar包下载到gradle本地缓存地址,并且引用该地址下的jar包。注意: gradle并不会向本地maven仓库中下载jar包,gradle缓存路径下的jar包与maven本地仓库中的jar包的格式也有区别。
参考:https://blog.csdn.net/feinifi/article/details/81458639
验证: 查看项目中不同jar包的引用地址(maven仓库中存在的jar包和不存在的jar包,观看其引用的地址)
gradle中jar包的依赖配置
jar包依赖方式
`/** * 配置依赖的jar包 * gradle工程所有的jar包的坐标都在dependencies属性内放置 * 每一个jar包的坐标都有三个基本元素组成 group,name,version * 添加坐标的时候都要带上jar包的作用域 */ dependencies { testCompile group: 'junit', name: 'junit', version: '4.12' }`
jar包的依赖范围(作用域)
jar包的依赖范围(作用域):
compile:编译阶段:主程序、测试程序均有效;运行阶段:均有效
providedCompile:编译阶段:主程序、测试程序均有效;运行阶段:均无效(依靠运行时环境提供的jar包)
runtime:编译阶段:主程序、测试程序均无效(无需依赖);运行阶段:均有效
testCompile:编译阶段:主程序无效,测试程序有效;运行阶段:均有效
testRuntime:编译阶段:主程序、测试程序均无效(无需依赖);运行阶段:测试程序有效
jar包依赖版本冲突默认解决方式
jar包依赖具有传递性
依赖jar包版本存在冲突解决方案:
maven:最短路径原则,先声明原则
gradle:选择最高版本
修改jar包依赖的配置策略
`configurations.all { resolutionStrategy { // 配置后将不自动处理jar包版本冲突,可以与依赖的排除配合使用 failOnVersionConflict() // 强制使用某个版本的jar包,覆盖依照gradle默认策略引用的jar包 force 'org.slf4j:slf4j-api:1.7.24' } }`
- 直接在build.gradle中配置configurations.all{}
依赖的排除
`dependencies { compile(group: 'org.hibernate', name: 'hibernate-core', version: '3.6.3.Final') { // 排除某个依赖,其中 module 相当于 jar包坐标中的 name exclude(group: 'org.slf4j', module: 'slf4j-api') } }` * 1 * 2 * 3 * 4 * 5 * 6
任务(Task)的编写
`// 任务(task)的主要操作动作 // dependsOn:依赖相关操作,定义任务时参数依赖、任务内部依赖、外部添加依赖 // doFirst:任务执行之前执行的方法 // doLast(<<(旧功能,不提倡)):任务执行之后执行的 task t1 { doFirst { println 't1 do first' } println 'hello t1' doLast { println 't1 do last' } } // 参数依赖 task t2(dependsOn: 't1') { // t2执行前操作 doFirst { println 't2 do first' } println 'hello t2' // t2 执行后操作 doLast { println 't2 do last' } } // 结论:在构建Project时,只执行直接定义在task下(非doFirst和doLast闭包中)的代码,有依赖也不会再次执行依赖的task // 直接调用task时,只执行在doFirst或doLast闭包中的代码,并且会优先执行依赖的task的doFirst或doLast闭包中的代码 task t3 { // 任务内部依赖 dependsOn 't1' println 'hello t3' doLast { println 't3 do last' } } task t4 { doFirst { println 't4 do first' } println 'hello t4' } // 外部添加依赖 t4.dependsOn 't1' //动态任务 4.times { val -> task "task${val}" { doFirst { println "The task is task${val}" } println "hello task${val}" } } task t5 { // 给任务添加自定义属性 ext.myProperty = 'The property value' doFirst { println "t5 ${myProperty}" } println 'hello t5' }` 
Gradle项目构建生命周期
Gradle项目构建生命周期
初始化阶段:通过settings.gradle判断哪些项目需要初始化,加载所有需要初始化的项目的build.gradle文件并为每个项目创建project对象
配置阶段:执行各项目下的build.gradle脚本,完成project的配置,并且构造task任务关系图以便在执行阶段按照依赖关系执行task中的配置代码(直接定义在task下的代码,配置阶段就需要执行)
执行阶段:通过配置阶段的task图,按顺序执行需要执行的任务中的动作代码(任务调用才会执行的代码,定义在doFirst或doLast中的代码)
Gradle项目构建过程中的钩子方法(我们可以直接覆写这些方法,在方法中加入我们自己的逻辑)(写在build.gradle或者settings.gradle中)
`// 项目构建之前 gradle.settingsEvaluated { println "初始化阶段0 settingsEvaluated" } gradle.projectsLoaded { println "初始化阶段1 projectsLoaded" } // 配置阶段 gradle.beforeProject { println "配置阶段0 beforeProject" } gradle.afterProject { println "配置阶段1 afterProject" } gradle.projectsEvaluated { println "配置阶段2 projectsEvaluated" } gradle.taskGraph.whenReady { println "配置阶段3 taskGraph.whenReady" } // 执行阶段 gradle.taskGraph.beforeTask { println "执行阶段0 taskGraph.beforeTask" } gradle.taskGraph.afterTask { println "执行阶段1 taskGraph.afterTask" } gradle.buildFinished { println "执行阶段2 buildFinished" }` 
Gradle创建多模块项目
- 父模块有settings.gradle文件,子模块没有,settings中配置所拥有的子模块
`rootProject.name = 'gradle-demo-comment' include 'model' include 'core' include 'web' include 'admin'`
- 父模块build.gradle中配置公用的信息,插件、依赖等
`// 配置统一信息,包括root模块 allprojects { // 统一引入 java 插件,并指定版本(注:不能将plugins {id 'java'} 直接挪到 allprojects 里面,变换一下形式) apply plugin: 'java' sourceCompatibility = 1.8 // 统一配置公共属性,例如:group、version group 'xin.yangshuai' version '1.0-SNAPSHOT' } // 子模块配置统一信息 subprojects { // 配置公用的资源库 repositories { mavenCentral() } // 配置公用的依赖 dependencies { compile 'ch.qos.logback:logback-classic:1.2.2' } } dependencies { }` 
- 子模块build.gradle中配置特有的信息
`apply plugin: 'war' //如果使用plugins引用插件,则buildscript必须放到plugins前面 buildscript { repositories { maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } jcenter() } dependencies { classpath 'com.bmuschko:gradle-tomcat-plugin:2.5' } } dependencies { compile project(':core') // providedCompile:只在编译时依赖,运行环境下不需要 providedCompile 'javax.servlet:javax.servlet-api:3.1.0' }` 
参考
https://www.bilibili.com/video/BV1iW411C7CV?from=search&seid=4133834168566660009
https://www.bilibili.com/video/BV1J4411C7Q5?from=search&seid=10862907195955895488
本文作者:cps666
本文链接:https://www.cnblogs.com/cps666/p/17312767.html
版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 2.5 中国大陆许可协议进行许可。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步