您的位置:首页 > 编程语言 > Java开发

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

2016-03-20 00:55 330 查看
本文为作者原创,转载请注明出处:/content/4153901.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.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.4 查找依赖包名

点击maven网站

搜索需要导入的包,例如
gson
,点击对应版本,例如
2.6.2


选择gradle,将会出现
'com.google.code.gson:gson:2.6.2'


复制 & 粘贴

1.5 完整的例子

?
repositories{ ... } 是放置这些包的仓库,接下来介绍

sourceCompatibility、version只是java plugin的部分属性,更多请看 java plugin 45.8

2.添加依赖仓库

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

?
不需要记住仓库的地址,直接使用即可,多个仓库可以同时用,通常我们会将远程仓库与本地仓库一起使用,因为缓存在本地磁盘上的文件速度更快,不需要重复下载。

关于
jcenter
mavenCentral
的区别,推荐看stackoverflow的回答

当然,国外的仓库在国内使用速度可能会比较慢,Gradle支持自定义地址,例如公司的仓库地址、国内仓库镜像地址等。

?
有时,我们需要调用自己编译实现的
*.jar
,我们也可以将包含这些文件的文件夹(不同于mavenLocal)映射为一个仓库,但一般不推荐这样做

?

3.依赖常见问题

3.1 依赖传递性

很多库依赖于其他库,例如a.jar依赖b.jar,在Gradle中,只需添加a.jar即可,Gradle将自动把a依赖的所有库全部下载。

但是,有时你并不想让Gradle自动去做这件事情,比如你希望明明白白地知道添加哪些库,可以配置
transitive
实现,编译时报错,你就可以知道进一步需添加哪些库。

?
另一种情况是,依赖传递可能会导致版本冲突,即依赖传递下载的库可能与项目依赖的另一个库版本冲突,这种情况下可以排除一些库,而下载其他所有的依赖库,即选择性排除。

?

3.2 版本冲突

版本冲突时十分常见的,比如下面的例子

?
Gradle解决冲突有以下几种方式

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

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



?

3.3 动态依赖

动态依赖增加了库版本依赖时的灵活性

?

3.4 更多设置

指定库文件类型

?
使用分类器(classifiers)

?
替换传递依赖的版本

?
常用命令

(1) 查看所有依赖库
gradle dependencies
(2) 查看指定配置(详见 1.3)的依赖库
gradle dependencies -configuration <configuration>
例 gradle dependencies -configuration compile => 查看编译时依赖
例 gradle dependencies -configuration runtime => 查看运行时依赖

/content/4153901.html
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: