作者:@gzdaijie
本文为作者原创,转载请注明出处: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的依赖管理方法,希望对大家有所帮助。
常见的依赖包含两种类型:
声明依赖使用下面的闭包
dependencies { //依赖项 }
在这里,我们以构建java项目为例,构建java项目首先需要应用java插件,插件的使用可参考上一篇随笔Java Gradle之插件管理
java插件针对不同操作,将依赖分为10类(详见 java plugin 45.5),下面介绍常用的5类
通常,一个JAR依赖需包含JAR文件组(group/命名空间)、JAR文件名(name)、JAR文件版本(version),特殊情况下还可指定JDK版本。添加依赖可以有以下方式:
/* 单个依赖 */ 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‘){ // ... 额外配置 }
点击maven网站
// 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定义了下载依赖的仓库
/* Maven Central respoitory */ repositories { mavenCentral() } /* Maven JCenter respoitory */ repositories { jcenter() } /* Maven local respoitory */ /* 本地仓库是之前下载的依赖,缓存在本地磁盘*/ repositories { mavenLocal() }
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)映射为一个仓库,但一般不推荐这样做
repositories { flatDir { dirs ‘libs1/java/...‘,‘libs2‘ } }
很多库依赖于其他库,例如a.jar依赖b.jar,在Gradle中,只需添加a.jar即可,Gradle将自动把a依赖的所有库全部下载。
但是,有时你并不想让Gradle自动去做这件事情,比如你希望明明白白地知道添加哪些库,可以配置transitive实现,编译时报错,你就可以知道进一步需添加哪些库。
dependencies { // transitive 属性默认为 true compile group:‘log4j‘,name:‘log4j‘,version:‘1.2.17‘,transitive:false }
另一种情况是,依赖传递可能会导致版本冲突,即依赖传递下载的库可能与项目依赖的另一个库版本冲突,这种情况下可以排除一些库,而下载其他所有的依赖库,即选择性排除。
dependencies { compile (‘commons-httpclient:commons-httpclient:3.1‘){ exclude group:‘commons-codec‘ //排除该group的依赖 // exclude group:‘commons-codec‘,module:‘commons-codec‘ // group是必选项,module可选 } }
版本冲突时十分常见的,比如下面的例子
// 库 a 传递性依赖库 b-1.2,与添加的b-1.1冲突 dependencies { compile ‘a:a:1.0‘ compile ‘b:b:1.1‘ }
Gradle解决冲突有以下几种方式
/* 冲突失败策略设置*/ configurations.all { resolutionStrategy { failOnVersionConflict() } } /* 强制指定版本策略设置*/ dependencies { compile group:‘b‘,name:‘b‘,version:‘1.1‘,force:true }
动态依赖增加了库版本依赖时的灵活性
dependencies { /* 选择1以上任意一个版本,这使发生版本冲突的几率变小*/ compile group:‘b‘,name:‘b‘,version:‘1.+‘ /* 选择最新的版本,避免直接指定版本号 */ compile group:‘a‘,name:‘a‘,version:‘latest.integration‘ }
指定库文件类型
// ext 默认jar,可选属性为war、zip compile group:‘b‘,name:‘b‘,version:‘1.1‘,ext:‘war‘
使用分类器(classifiers)
// 例如提供了2种包,a-1.0-dev.war, a-1.0-dev.jar compile group:‘b‘,name:‘b‘,version:‘1.1‘,classifier:‘dev‘,ext:‘war‘
替换传递依赖的版本
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 => 查看运行时依赖
Java Gradle入门指南之依赖管理(添加依赖、仓库、版本冲突)
原文:http://www.cnblogs.com/Ming8006/p/7852497.html