标签:
本文为作者原创,转载请注明出处: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) 一类是项目中所需要的库,包括本地/仓库中的文件和其他项目文件(例如一个多项目工程,一个项目依赖于另一个项目)
(2) 一类是实现自动化编译、部署等所需的库,包含Gradle的API和Groovy编写的Task、Plugin等,这一类依赖在前2篇随笔有提到和使用
|
1
2
3
|
dependencies {<configuration name> <dependencies>} |
在这里,我们以构建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‘){// ... 额外配置} |
gson,点击对应版本,例如2.6.2‘com.google.code.gson:gson:2.6.2‘|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
// sourceCompatibility = 1.8为java版本,默认为当前JVM版本apply plugin: ‘java‘sourceCompatibility = 1.8version = ‘1.0‘repositories {mavenCentral()}dependencies {compile ‘org.springframework:spring-context:4.2.1.RELEASE‘compile ‘log4j:log4j:1.2.17‘} |
你可能会疑惑,声明了这些依赖,这些依赖是在哪里找到的呢?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的回答|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
repositories {mavenLocal()/* 指定本地仓库地址 *//* 指定的远程仓库 *//** 公司仓库,可能需要验证* 不推荐直接将用户名密码写在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‘ }} |
transitive实现,编译时报错,你就可以知道进一步需添加哪些库。|
1
2
3
4
|
dependencies {// transitive 属性默认为 truecompile 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可选}} |
|
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} |
|
1
2
3
4
5
6
|
dependencies {/* 选择1以上任意一个版本,这使发生版本冲突的几率变小*/compile group:‘b‘,name:‘b‘,version:‘1.+‘/* 选择最新的版本,避免直接指定版本号 */compile group:‘a‘,name:‘a‘,version:‘latest.integration‘} |
|
1
2
|
// ext 默认jar,可选属性为war、zipcompile group:‘b‘,name:‘b‘,version:‘1.1‘,ext:‘war‘ |
|
1
2
|
// 例如提供了2种包,a-1.0-dev.war, a-1.0-dev.jarcompile 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
Java Gradle入门指南之依赖管理(添加依赖、仓库、版本冲突) (转)
标签:
原文地址:http://www.cnblogs.com/softidea/p/5297001.html