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

作者：@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的依赖管理方法，希望对大家有所帮助。
    如有错误，请不吝指出，非常感谢！如果本文对你有帮助，右下角点个推荐吧~

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 => 查看运行时依赖

转载于:https://www.cnblogs.com/lv448395223/p/5326129.html

Java Gradle入门指南之依赖管理（添加依赖、仓库、版本冲突）相关推荐

  1. Java Gradle入门指南之gretty插件（安装、命令与核心特性）

    本文为作者原创,转载请注明出处:https://www.cnblogs.com/gzdaijie/p/5267166.html 目录 1.安装gretty 2.常用命令 2.1 gradle appR ...

  2. java gradle入门_Gradle入门：我们的第一个Java项目

    java gradle入门 这篇博客文章描述了如何使用Gradle编译和打包一个简单的Java项目. 我们的Java项目只有一个要求: 我们的构建脚本必须创建一个可执行的jar文件. 换句话说,我们必 ...

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

     1 maven概念模型 2 maven的生命周期,项目构建过程 Maven生命周期就是为了对所有的构建过程进行抽象和统一 包括项目清理,初始化,编译,打包,测试,部署等几乎所有构建步骤 Mave ...

  4. gradle依赖管理_依赖管理

    gradle依赖管理 Why Bother 何必呢 Writing software is a very expensive process, and most systems we interact ...

  5. Java Gradle 入门与实践

    目录 一.Gradle初识 1.1.安装与配置 1.1.1.下载 1.1.2.解压 1.1.3.配置 1.1.4.验证 1.1.5.Idea配置 1.2.构建gradle项目 1.2.1.原始构建 1 ...

  6. 【Android Gradle 插件】Android 依赖管理 ④ ( 常用依赖配置分析 | implementation 依赖作用 | api 依赖作用 | compileOnly 依赖作用 )

    文章目录 一.compile 依赖作用 二.implementation 依赖作用 三.api 依赖作用 四.compileOnly 依赖作用 五.annotationProcessor 依赖作用 六 ...

  7. java工程加包_Java工程中添加依赖jar包不起作用问题总结

    Java工程中添加依赖jar包不起作用问题总结 此次总结两种方式的依赖问题 1 在Eclipse中添加依赖jar包不起作用问题 这种方式可能是Eclipse缓存,或者Eclipse还没有反应过来.例如 ...

  8. Maven 依赖管理与依赖标签

    原文链接 1.概述 在本教程中,我们将回顾两个重要的Maven标签--dependencyManagement 和 dependencies. 这些特性对于多模块项目特别有用. 我们将回顾这两个标签的 ...

  9. 配置所需要的依赖_Maven依赖管理之依赖传递

    1 传递依赖 2.1 什么是传递依赖 当A 依赖B.B依赖C,在A中导入B后会自动导入C,C是A的传递依赖,如果C依赖D则D也可能是A的传递依赖. 演示: web中添加struts-spring的ja ...

最新文章

  1. ldconfig及LD_LIBRARY_PATH
  2. 学习笔记99—word 如何增加底纹
  3. python变量和变量赋值的几种形式
  4. cpu 内存占用比较高的解决方案
  5. java实现dvd租赁系统_Java编写汽车租赁系统
  6. 95-40-014-生产者-KafkaProducer
  7. CentOS 7笔记yum install epel-release
  8. 单调栈：leetcode 84. 柱状图中最大的矩形/85最大矩形
  9. AdBlock广告拦截插件的实现原理
  10. 软件测试经典案例佣金问题,佣金等价划分和测试用例设计.PPT
  11. Linux系统编程学习笔记
  12. 论文常用图表一：柱状图【MATLAB】
  13. gamc网卡驱动2-----gmac收发实现
  14. AcWing 342. 道路与航线 （双端队列广搜问题，SPFA）
  15. VSCode 单文件编译 与 多文件编译（windows）
  16. 基于ASP.NET大学生校园招聘网站的设计与开发
  17. CryEngine3-CE3本地化系统入门、UI字体更换
  18. 宽屏企业网站源码中英php_网展PHP中英外贸企业网站黑色风格 v4.6
  19. 如何正确理解企业文化
  20. 设计模式 -- 桥梁模式

热门文章

  1. （2）基于Bootstrap的网页开发
  2. （转）用 Maven 部署 war 包到远程 Tomcat 服务器
  3. 初步学习pg_control文件之六
  4. Dev的多语言简单实现
  5. （9）vue.js 指令（1）
  6. 设计模式-观察者模式 发布/订阅模式
  7. webapi输出炜json_webapi转化为json格式
  8. dsd语言证书c1是什么,DSD一级德语语言证书考试在嘉兴高级中学举行
  9. jq 点击按钮跳转到微信_小程序 web-view组件跳转到小程序页面
  10. Andorid AlertDialog 点击后自动消失_不看后悔！2011年别克更换完变速箱电脑后，要如何做设定匹配...