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

本文为作者原创，转载请注明出处：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
时间： 2024-11-01 06:20:14

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

4.Maven概念模型，maven的生命周期，Maven坐标，依赖管理（依赖范围，依赖声明），仓库管理，私服概念

 1 maven概念模型 2 maven的生命周期,项目构建过程 Maven生命周期就是为了对所有的构建过程进行抽象和统一 包括项目清理,初始化,编译,打包,测试,部署等几乎所有构建步骤   Maven有"三套"相互独立的生命周期,而且相互独立,这三套生命周期分别是: Maven三大生命周期 clean:清理项目的 在进行真正的构建之前进行一些清理工作. default:构建项目的 构建的核心部分,编译,测试,打包,部署等等. site:生成项目站点的 生成项目报告,站点,发布站点

Apache Camel的Java编程入门指南_java

 Apache Camel是一个非常实用的规则引擎库,能够用来处理来自于不同源的事件和信息.你可以在使用不同的协议比如VM,HTTP,FTP,JMS甚至是文件系统中来传递消息,并且让你的操作逻辑和传递逻辑保持分离,这能够让你更专注于消息的内容. 在这篇文章中,我将提供一个Java语言(非Groovy)的Apache Camel入门演示. 首先创建一个Maven项目的pom.xml.   <?xml version="1.0" encoding="UTF-8"?

NetBeans IDE 6.0 Java快速入门指南

欢迎使用 NetBeans IDE! 本教程提供 NetBeans IDE 工作流程的简单介绍和快速指南.我们将指导大家创建一个简单的 "Hello World" Java 控制台应用程序.完成此教程之后,您将具备如何在 IDE 中创建.编译和运行应 用程序的基本知识. 本教程可在 10 分钟之内完成. 完成本教程之后,您可以继续学习 NetBeans IDE 的 在线文档中心.该部分提供的教程全面介绍了众 多 IDE 特性和编程技巧,可应用于各种应用程序类型.如果对 "He

Java刚入门，请教一个Menu添加弹出事件问题

问题描述 我定义了一个菜单如:importcom.extjs.gxt.ui.client.widget.menu.Menu;MenumOpState=newMenu();我想为Menu添加一个菜单弹出时发生的事件或者是鼠标移过的事件,该怎么写?谢谢各位帮帮忙 解决方案 本帖最后由 WellSwift2009 于 2009-06-25 10:15:57 编辑

针对初学者的jQuery入门指南_jquery

 jQuery 是什么,它能为我们做什么?如果你是一名 Web 开发人员,写过 JavaScript 程序,那么你很可能正在使用 jQuery,即使没有试用过,至少也听说过,事实上 jQuery 可以说是现阶段最流行的 JavaScript 库.据有关部门统计,全球网站上面,约有 28% 的网站在使用 jQuery,这个数字可能有些夸张,但足见 jQuery 受欢迎的程度.本文仅对 jQuery 的使用方法作简单介绍,且作为一个入门教程吧.下载 jQuery 代码,并在页面中载入 首先需要从jQ

gradle-android依赖和测试依赖冲突

问题描述 android依赖和测试依赖冲突 我是andorid新手,使用android studio 2.0.0写了一个hello world程序. 现在想写一个android测试,加入了测试框架依赖以后,出现了版本冲突,错误如下 Error:Conflict with dependency 'com.android.support:support-annotations'. Resolved versions for app (23.3.0) and test app (22.2.0) dif

漫谈依赖管理工具：从Maven,Gradle到Go

为什么要有依赖管理工具? 谈依赖管理之前,我们先谈谈为什么要有依赖管理工具这东西. 我们学了一种编程语言,然后写了个"Hello World",然后宣称自己学了一门语言,这时候确实不需要关心依赖问题. 然而,当你要写一个稍微复杂点的应用,那怕就是留言板这样的,需要读写数据库,就需要依赖数据库驱动,就会遇到依赖管理的问题了. 再进一步,你写了一个库,想共享给别人使用,更需要了解依赖管理的问题. 当然,如果项目足够简单,你可以直接将依赖方的源码放置在自己的项目中,或者将依赖库的二进制文件(

Gradle for Android 第三篇( 依赖管理 )

Gradle for Android 第三篇( 依赖管理 ) 依赖管理是Gradle最闪耀的地方,最好的情景是,你仅仅只需添加一行代码在你的build文件,Gradle会自动从远程仓库为你下载相关的jar包,并且保证你能够正确使用它们.Gradle甚至可以为你做的更多,包括当你在你的工程里添加了多个相同的依赖,gradle会为你排除掉相同的jar包. 作者:佚名来源:Android开发中文站|2017-04-10 17:35  移动端  收藏   分享 依赖管理 依赖管理是Gradle最闪耀的地

Asp.Net MVC4入门指南（2）：添加一个控制器

MVC代表: 模型-视图-控制器 .MVC是一个架构良好并且易于测试和易于维护的开发模式.基于MVC模式的应用程序包含: · Models: 表示该应用程序的数据并使用验证逻辑来强制实施业务规则的数据类. · Views: 应用程序动态生成 HTML所使用的模板文件. · Controllers: 处理浏览器的请求,取得数据模型,然后指定要响应浏览器请求的视图模板. 本系列教程,我们将覆盖所有这些概念,并告诉您如何使用它们来构建应用程序. 首先,让我们创建一个控制器类.在解决方案资源管理器中,用