1. 依赖管理概述
一个项目,必然会使用到很多第三方类库,比如:解析JSON,用到了gson,数据库操作,greenDao等等,这些类库,其本身也在不断的维护,升级;我们需要管理好这些依赖;
开发中一些依赖管理手段:
- 手动copy jar 包:刚开始接触Java开发的时候,还记得那个msql的驱动jar包吧;
- android 开发中,copy aar集成;类似于copy jar 一样;
- 后面就是Maven、gradle,来实现自动化依赖;
1.1 自动化依赖管理
我们需要知道类库的确切版本和传递性依赖,比如:gson的版本;比如:jar之间的依赖;
2. 依赖管理
在项目中,依赖管理是通过 dependencies
和 repositories
2个DSL配置块来配置的;配置块的名称直接映射到 Project
接口的名称,方法调用的意思;
在build.gradle文件中通过Gradle的DSL提供的依赖定义;在依赖管理器运行时执行这个配置,从仓库中下载所需要的工件,并存在本地缓存仓库中;
插件可引入配置来定义依赖的作用域;Java插件引入了各种标准配置来定义java构建生命周期应用的依赖,如 compile 源码所要的依赖;
我们需要理解配置信息是如何存储、配置和访问的,Gradle 的API有相关负责的接口,如下:
2.1 依赖配置
配置可以直接在项目的根级别添加和访问;每个项目都有一个ConfigurationContainer
类的容器来管理相应的配置;
配置在行为方面可以控制依赖解决方案中是否包含传递性依赖,定义解决策略(如:解决工件版本冲突),也可以配置扩展;
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属性标志了一个依赖;
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可以让我们完成控制传递性依赖,因此可以排除所有的传递性依赖或者有选择性的排除;
使用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
}
}
输出:
刷新Compile缓存
configurations.compile.resolutionStrategy {
cacheChangingModulesFor 0, 'seconds'
}
// 或者刷新所有
configurations.all {
resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}