Gradle实战读书笔记之三 依赖管理

2019年6月9日 314次阅读

1. 依赖管理概述

一个项目，必然会使用到很多第三方类库，比如：解析JSON，用到了gson，数据库操作，greenDao等等，这些类库，其本身也在不断的维护，升级；我们需要管理好这些依赖；

开发中一些依赖管理手段：

  1. 手动copy jar 包：刚开始接触Java开发的时候，还记得那个msql的驱动jar包吧；
  2. android 开发中，copy aar集成；类似于copy jar 一样；
  3. 后面就是Maven、gradle，来实现自动化依赖；

1.1 自动化依赖管理

我们需要知道类库的确切版本和传递性依赖，比如：gson的版本；比如：jar之间的依赖；

2. 依赖管理

在项目中，依赖管理是通过 dependencies 和 repositories 2个DSL配置块来配置的；配置块的名称直接映射到 Project接口的名称，方法调用的意思；
在build.gradle文件中通过Gradle的DSL提供的依赖定义；在依赖管理器运行时执行这个配置，从仓库中下载所需要的工件，并存在本地缓存仓库中；

插件可引入配置来定义依赖的作用域；Java插件引入了各种标准配置来定义java构建生命周期应用的依赖，如 compile 源码所要的依赖；

我们需要理解配置信息是如何存储、配置和访问的，Gradle 的API有相关负责的接口，如下：

2.1 依赖配置

配置可以直接在项目的根级别添加和访问；每个项目都有一个ConfigurationContainer类的容器来管理相应的配置；
配置在行为方面可以控制依赖解决方案中是否包含传递性依赖，定义解决策略（如：解决工件版本冲突），也可以配置扩展；

《Gradle实战读书笔记之三 依赖管理》 相关接口与方法

Java 插件提供了6个现成的配置：compile、runtime、testCompile、testRuntime、archivers与default；

2.2 自定义配置

创建一个名为better的配置

// 自定义配置
configurations {
    better {        // 新的配置名称
        description = ">>>> 自定义配置测试"
        visible = false
    }
}

3. 声明依赖

DSL 配置块 dependenies用来将一个或多个依赖指定给配置；
首先，看看 外部模块依赖和文件依赖；

3.1 理解依赖API表示

每个Gradle项目依赖处理器实例，由DepecndencyHandler接口来表现；通过使用项目中的 getDependencies()来获得对依赖处理器的引用；每一个依赖都是 Dependency类型的一个实例；
group、name、version、classifier属性标志了一个依赖；

《Gradle实战读书笔记之三 依赖管理》 项目、依赖处理器与真实依赖之间的关系

3.2 外部模块依赖

在Gradle中，外部类库，通常以jar，android 更多是aar文件形式存在；他们代码依赖的模块在项目结构之外；

依赖属性
如：group、name 等，解释，这里不写了；

依赖标记
项目中使用语法：

dependencies {
    configurationName dependencyNotations1, ...
}

如：
dependencies {
    compile "org.jetbrains.kotlin:kotlin-stdlib-jre7:$kotlin_version"
}

使用map形式给出属性名称与其值，用冒号分隔每一个属性，上面的例子省略了属性名称; 等价于：

 compile group: 'org.jetbrains.kotlin' , name: 'kotlin-stdlib-jre7' ,
version:$kotlin_version

我们可以使用下，上面自定义的配置

 better group:"hello", name:"core-better", version: 1.0

当然了，运行会报错的；

我们可通过 gradle dependencies task 来查看依赖树，依赖树会展示顶层依赖与传递依赖；

《Gradle实战读书笔记之三 依赖管理》 依赖树

通过上图，可以看到有些依赖带有 星号 (*)，这些依赖是被排除的；
依赖管理器选择的是相同的或者另一个版本的类库；针对版本冲突的依赖，gradle默认选择最新版本；

排除传递性依赖
Gradle可以让我们完成控制传递性依赖，因此可以排除所有的传递性依赖或者有选择性的排除；
使用exclude 来排除传递性依赖；

androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })

注意：排除属性与常用的依赖标记有所不同，可以使用group和module属性，但不允许只排除某个特定版本的依赖，所以Version属性不可用；
使用 transivive=false可排除所有的传递性依赖；

动态版本声明
这是一个特定的语法，如果想使用最新版本的依赖，使用占位符lastest.integration，如：testCompile 'junit:junit:latest-integration'
或者声明版本属性，通过 + 号：testCompile 'junit:junit:4.+

最好不要用此属性，而应该是确切的版本；

3.3 文件依赖

可以设置不从线上导入包，而改成从文件中导入；如：

dependencies {
       compile fileTree(dir: 'libs', include: ['*.jar'])
}

4 使用和配置仓库

4.1 仓库API

项目中仓库定义使用的是 RepositoryHandler接口，提供了添加各种类型仓库的方法；配置块为：repositories
图不画了；
RepositoryHandler接口提供2个方法允许预配置Maven仓库，mavenCetral()，用来表示中央仓库，mavenLocal()方法用来管理本地maven仓库；

添加预配置的 Maven 仓库
不需要声明仓库url（http://repo1.maven.org/maven2）,可直接调用mavenCentral()方法，如：

repositories {
    mavenCentral()
    // 预定义本地maven就是
   mavenLocal()   、、 
}

添加自定义的maven仓库
Gradle API 支持2种方式来配置一个自定义仓库：maven() 和 mavenRepo();

repositories {
        jcenter()
        maven {    // 自定义的maven仓库，name可选
            name 'custom maven'
            url 'http://www.google.com/maven'
        }
    }

本地依赖缓存

打印所有 ‘compile’依赖的连接文件路径

task printlnDependencies << {
    configurations.getByName('compile').each {
        dependency -> println dependency
    }
}

输出：

《Gradle实战读书笔记之三 依赖管理》 依赖路径输出

刷新Compile缓存

configurations.compile.resolutionStrategy {
     cacheChangingModulesFor 0, 'seconds'
}

// 或者刷新所有
configurations.all {
  resolutionStrategy.cacheChangingModulesFor  0, 'seconds'
}
点赞