gradle项目的依赖类型
依赖API
上图是项目、依赖处理器、依赖 的类图表示
- gradle项目有一个DependencyHandler实例,通过getDependencies()方法来取得引用。
- 声明依赖需要通过dependencies配置块中的依赖处理器方法来声明
- 每个依赖都是一个Dependency类型的一个实例,group、name、version、classifier属性明确的标识了一个依赖。
外部模块依赖
gradle中,外部类库通常以JAR文件的形式存在,被称为外部模块依赖。这种类型依赖的特点是在仓库中能够通过属性明确地标识。
依赖属性
- group:通常用来标识一个组织、公司、或项目。group可以用点标记法,但非强制,如org.hibernate。
- name:一个工件的名称,唯一描述了依赖。
- version:一个工件可以有不同版本
- classifier:有时一个工件会定义这个属性,来区分具有相同group、name、version属性的工件,但他需要进一步规范,比如说根据运行时环境来定义。
依赖标记
- 依赖声明语法
dependencies{
configurationName dependencyNotation1,dependencyNotation2,...
}
- dependencyNotation的格式
- group:groupString, name:nameString, version:versionString
- "groupString:nameString:versionString"
使用外部模块依赖需要在repositories配置快中添加仓库。
依赖检查报告
使用gradle dependencies
运行dependencies help task时,会显示出当前项目完整的依赖树,依赖树显示了在构建脚本中声明的顶层依赖以及它们的传递性依赖。
- 标有*号的依赖表示被排除
- 针对版本冲突Gradle默认的解决策略是获取最新的版本。
排除传递性依赖
Gradle可以完全控制传递性依赖。
- 排除一个依赖,可以通过快捷或map标记来声明排除依赖。比如:
dependencies {
cargo(\'org.codehaus.cargo:cargo-ant;1.3.1\'){
exclude group: \'xml-apis\' , module: \'xml-apis\'
}
}
- 排除虽有传递性依赖
dependencies {
cargo(\'org.codehaus.cargo:cargo-ant;1.3.1\'){
transitive = false
}
}
动态声明版本
在声明依赖时将版本号写为1.+,就会获取依赖类库的最新的1.X版本
文件依赖
依赖于文件系统上的文件,无需声明仓库
语法如下
dependencies {
compile fileTree(dir:dirString , include: \'*.jar\')
}
这样便可依赖dirString目录下的一系列jar。