当前位置:首页 > Java技术 > Java Gradle入门指南之依赖管理(添加依赖、仓库、版本冲突) (转)

Java Gradle入门指南之依赖管理(添加依赖、仓库、版本冲突) (转)

2022年09月16日 17:18:56Java技术4

本文为作者原创,转载请注明出处:http://www.cnblogs.com/gzdaijie/p/5296624.html


目录

1.添加依赖包名
1.1 依赖类型
1.2 声明依赖
1.3 添加java依赖
1.4 查找依赖包名
1.5 完整的例子
2.添加依赖仓库
3.依赖常见问题
3.1 依赖传递性
3.2 版本冲突
3.3 动态依赖
3.4 更多设置

开发任何软件,如何管理依赖是一道绕不过去的坎,软件开发过程中,我们往往会使用这样那样的第三方库,这个时候,一个好的依赖管理就显得尤为重要了。作为一个自动构建工作,Gradle对依赖管理有着很好的支持。
通常我们使用IDE(Eclipse、IDEA、Android Studio)开发Java项目,IDE自动为我们创建了Gradle文件,添加依赖也不过简单的几行代码,这篇随笔将从逐步解释Gradle的依赖管理方法,希望对大家有所帮助。
如有错误,请不吝指出,非常感谢!如果本文对你有帮助,右下角点个推荐吧~

1.添加依赖包名

1.1 依赖类型

  • 常见的依赖包含两种类型。

    (1) 一类是项目中所需要的库,包括本地/仓库中的文件和其他项目文件(例如一个多项目工程,一个项目依赖于另一个项目) 

    (2) 一类是实现自动化编译、部署等所需的库,包含Gradle的API和Groovy编写的Task、Plugin等,这一类依赖在前2篇随笔有提到和使用

1.2 声明依赖

  • 声明依赖使用下面的闭包
?
1
2
3
dependencies {
<configuration name> <dependencies>
}

1.3 添加java依赖

  • 在这里,我们以构建java项目为例,构建java项目首先需要应用java插件,插件的使用可参考上一篇随笔Java Gradle之插件管理

  • java插件针对不同操作,将依赖分为10类(详见 java plugin 45.5),下面介绍常用的5类

    (1)  compile:源代码(src/main/java)编译时的依赖,最常用
    (2)  runtime:源代码(src/main/java)执行时依赖
    (3)  testCompile:测试代码(src/main/test)编译时的依赖
    (4)  testRuntime:测试代码(src/main/java)执行时的依赖

    (5) archives:项目打包(e.g.jar)时的依赖

  • 通常,一个JAR依赖需包含JAR文件组(group/命名空间)、JAR文件名(name)、JAR文件版本(version),特殊情况下还可指定JDK版本。添加依赖可以有以下方式:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/* 单个依赖 */
compile group: 'log4j' , name: 'log4j' , version: '1.2.17'
// 简写 => compile 'log4j:log4j:1.2.17'
 
/* 以数组形式添加多个依赖*/
compile  'joda-time:joda-time:2.9.2' 'log4j:log4j:1.2.17'
 
/* 闭包形式,以添加额外配置*/
compile (group: 'log4j' , name: 'log4j' , version: '1.2.17' ){
// ... 额外配置
}
/* 等价于 */
compile ( 'log4j:log4j:1.2.17' ){
// ... 额外配置
}

1.4 查找依赖包名

  • 点击maven网站
  • 搜索需要导入的包,例如gson,点击对应版本,例如2.6.2
  • 选择gradle,将会出现'com.google.code.gson:gson:2.6.2'
  • 复制 & 粘贴

1.5 完整的例子

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
// sourceCompatibility = 1.8为java版本,默认为当前JVM版本
apply plugin:  'java'
 
sourceCompatibility =  1.8
version =  '1.0'
 
repositories {
mavenCentral()
}
 
dependencies {
compile  'org.springframework:spring-context:4.2.1.RELEASE'
compile  'log4j:log4j:1.2.17'
}
  • repositories{ ... } 是放置这些包的仓库,接下来介绍
  • sourceCompatibility、version只是java plugin的部分属性,更多请看 java plugin 45.8

2.添加依赖仓库

你可能会疑惑,声明了这些依赖,这些依赖是在哪里找到的呢?repositories定义了下载依赖的仓库

?
1
2
3
4
5
6
7
8
9
10
11
12
13
/* Maven Central respoitory */
repositories {
mavenCentral()
}
/* Maven JCenter respoitory */
repositories {
jcenter()
}
/* Maven local respoitory */
/* 本地仓库是之前下载的依赖,缓存在本地磁盘*/
repositories {
mavenLocal()
}
  • 不需要记住仓库的地址,直接使用即可,多个仓库可以同时用,通常我们会将远程仓库与本地仓库一起使用,因为缓存在本地磁盘上的文件速度更快,不需要重复下载。
  • 关于jcenter和 mavenCentral的区别,推荐看stackoverflow的回答
  • 当然,国外的仓库在国内使用速度可能会比较慢,Gradle支持自定义地址,例如公司的仓库地址、国内仓库镜像地址等。
?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
repositories {
mavenLocal()
/* 指定本地仓库地址 */
maven { url  "file://E:/githubrepo/releases"  }
/* 指定的远程仓库 */
maven { url  "http://mvnrepository.com/"  }
/*
* 公司仓库,可能需要验证
* 不推荐直接将用户名密码写在build.gradle中
* 可以写在~/.gradle/gradle.properties中,再使用
*/
maven {
url  "<you_company_resp_url>"
credentials {
username  'your_username'
password  'your_password'
}
}
// 支持ivy仓库
ivy { url  "<ivy_resp_url>"  }
}
  • 有时,我们需要调用自己编译实现的*.jar,我们也可以将包含这些文件的文件夹(不同于mavenLocal)映射为一个仓库,但一般不推荐这样做
?
1
2
3
repositories {
flatDir { dirs  'libs1/java/...' , 'libs2'  }
}

3.依赖常见问题

3.1 依赖传递性

  • 很多库依赖于其他库,例如a.jar依赖b.jar,在Gradle中,只需添加a.jar即可,Gradle将自动把a依赖的所有库全部下载。
  • 但是,有时你并不想让Gradle自动去做这件事情,比如你希望明明白白地知道添加哪些库,可以配置transitive实现,编译时报错,你就可以知道进一步需添加哪些库。
?
1
2
3
4
dependencies {
// transitive 属性默认为 true
compile group: 'log4j' ,name: 'log4j' ,version: '1.2.17' ,transitive: false
}
  • 另一种情况是,依赖传递可能会导致版本冲突,即依赖传递下载的库可能与项目依赖的另一个库版本冲突,这种情况下可以排除一些库,而下载其他所有的依赖库,即选择性排除。
?
1
2
3
4
5
6
7
dependencies {
compile ( 'commons-httpclient:commons-httpclient:3.1' ){
exclude group: 'commons-codec'  //排除该group的依赖
// exclude group:'commons-codec',module:'commons-codec'
// group是必选项,module可选
}
}

3.2 版本冲突

  • 版本冲突时十分常见的,比如下面的例子
?
1
2
3
4
5
// 库 a 传递性依赖库 b-1.2,与添加的b-1.1冲突
dependencies {
compile  'a:a:1.0'
compile  'b:b:1.1'
}
  • Gradle解决冲突有以下几种方式

    (1) 最近版本策略(默认):上例将忽略b-1.1,而下载b-1.2 
    (2) 冲突失败策略:发生冲突时,编译失败(有些新版本库并不兼容之前的,因此这个库可以让开发者主动作出选择)

    (3) 强制指定版本策略:发生冲突时,使用开发者指定的版本

?
1
2
3
4
5
6
7
8
/* 冲突失败策略设置*/
configurations.all {
resolutionStrategy { failOnVersionConflict() }
}
/* 强制指定版本策略设置*/
dependencies {
compile group: 'b' ,name: 'b' ,version: '1.1' ,force: true
}

3.3 动态依赖

  • 动态依赖增加了库版本依赖时的灵活性
?
1
2
3
4
5
6
dependencies {
/* 选择1以上任意一个版本,这使发生版本冲突的几率变小*/
compile group: 'b' ,name: 'b' ,version: '1.+'
/* 选择最新的版本,避免直接指定版本号 */
compile group: 'a' ,name: 'a' ,version: 'latest.integration'
}

3.4 更多设置

  • 指定库文件类型
?
1
2
// ext 默认jar,可选属性为war、zip
compile group: 'b' ,name: 'b' ,version: '1.1' ,ext: 'war'
  • 使用分类器(classifiers)
?
1
2
// 例如提供了2种包,a-1.0-dev.war, a-1.0-dev.jar
compile group: 'b' ,name: 'b' ,version: '1.1' ,classifier: 'dev' ,ext: 'war'
  • 替换传递依赖的版本
?
1
2
3
compile group: 'a' ,name: 'a' ,version: 'l.0'  {
dependencies  'b:b:1.1'
}
  • 常用命令
(1) 查看所有依赖库
gradle dependencies
(2) 查看指定配置(详见 1.3)的依赖库
gradle dependencies -configuration <configuration>
例 gradle dependencies -configuration compile => 查看编译时依赖
例 gradle dependencies -configuration runtime => 查看运行时依赖

http://www.cnblogs.com/gzdaijie/p/5296624.html


作者:沧海一滴
来源链接:https://www.cnblogs.com/softidea/p/5297001.html

版权声明:
1、JavaClub(https://www.javaclub.cn)以学习交流为目的,由作者投稿、网友推荐和小编整理收藏优秀的IT技术及相关内容,包括但不限于文字、图片、音频、视频、软件、程序等,其均来自互联网,本站不享有版权,版权归原作者所有。

2、本站提供的内容仅用于个人学习、研究或欣赏,以及其他非商业性或非盈利性用途,但同时应遵守著作权法及其他相关法律的规定,不得侵犯相关权利人及本网站的合法权利。
3、本网站内容原作者如不愿意在本网站刊登内容,请及时通知本站(javaclubcn@163.com),我们将第一时间核实后及时予以删除。


本文链接:https://www.javaclub.cn/java/41979.html

标签: Java版本
分享给朋友:

“Java Gradle入门指南之依赖管理(添加依赖、仓库、版本冲突) (转)” 的相关文章

Java中四种访问修饰符的区别

在java中共有4种访问级别,按访问权限由高到低为:public(公有的)、protected(受保护的)、友好的(没有任何访问权限关键字修饰)和private(私有的)。 类型 类内部 同一个包其...

深入理解 Java 并发锁

深入理解 Java 并发锁

📦 本文以及示例源码已归档在 javacore 一、并发锁简介 确保线程安全最常见的做法是利用锁机制(Lock、sychronized)来对共享数据做互斥同步,这样在同一个时刻,只有一个线程可以执行某个方法或者某个代码块,那么操作必然是原子性的,线程安全的...

Java 日志框架详解

Java 日志框架详解

1. JUL学习 JUL全称Java util Logging是java原生的日志框架,使用时不需要另外引用第三方类库,相对其他日志框 架使用方便,学习简单,能够在小型应用中灵活使用。 1.1 架构介绍 Loggers...

Java日志框架那些事儿

Java日志框架那些事儿

在项目开发过程中,我们可以通过 debug 查找问题。而在线上环境我们查找问题只能通过打印日志的方式查找问题。因此对于一个项目而言,日志记录是一个非常重要的问题。因此,如何选择一个合适的日志记录框架也非常重要。在Java开发中,常用的日志记录框架有JDKLog、Log4J、LogBack、SLF4J...

JDBC连接时所犯错误1.字符集设置不合适2.连接MySQL8.0社区版时时区不一致3..包名不能以Java.命名4.驱动被弃用

Microsoft JDBC Driver 的主页为:https://msdn.microsoft.com/en-us/data/aa937724.aspx 下载所需驱动 今天连接时报了四次错,记录下来 1.java.sql.SQLException:...

java计数循环及小技巧

要运行一个很大次数的循环应该选择一个小数,然后去判断 例如本例子是100可以选择10去判断 public static void main(String[] args) { // TODO Auto-generated metho...

Java获取明天的时间(当前时间加一天)

import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Calendar;     public class&nbs...

Java Web 工作技巧总结 16.8

Java Web 工作技巧总结 16.8

摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载,保留摘要,谢谢! 四时不谢之兰,百节长青之竹,万古不败之石,千秋不变之人。 1. AOP – LOG 项目中,一个请求过来,一个响应回去。...

JAVA UUID 生成唯一标识

Writer:BYSocket(泥沙砖瓦浆木匠) 微博:BYSocket 豆瓣:BYSocket Reprint it anywhere u want 需求     项目在设计表的时候,要处理并发多...

编写高质量代码改善java程序的151个建议——[52

编写高质量代码改善java程序的151个建议——[52

原创地址:   http://www.cnblogs.com/Alandre/  (泥沙砖瓦浆木匠),需要转载的,保留下! Thanks Although the world is full of...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。