在 Gradle 里, 依赖可以组合成configurations(配置). 一个配置简单地说就是一系列的依赖. 我 们称它们为(dependency configuration)依赖配置. 你可以使用它们声明项目的外部依赖. 正如 我们将在后面看到, 它们也被用来声明项目的发布.
Java 插件定义了许多标准的配置. 下面列出了一些, 你也可以在Table 23.5, “Java 插件 - 依赖 管理”里发现更多具体的信息.
compile
用来编译项目源代码的依赖.
runtime
在运行时被生成的类使用的依赖. 默认的, 也包含了编译时的依赖.
testCompile
编译测试代码的依赖. 默认的, 包含生成的类运行所需的依赖和编译源代码的依赖.
testRuntime
运行测试所需要的依赖. 默认的, 包含上面三个依赖.
各种各样的插件加入许多标准的配置. 你也可以定义你自己的配置. 参考 Section 52.3, “配置依 赖”可以找到更加具体的定义和定制一个自己的依赖配置.
依赖配置
外部的依赖
你可以声明许多种依赖. 其中一种是external dependency(外部依赖). 这是一种在当前构建之 外的一种依赖, 它被存放在远程或本地的仓库里, 比如 Maven 的库, 或者 Ivy 库, 甚至是一个本 地的目录.
下面的例子讲展示如何加入外部依赖 例子 8.2. 定义一个外部依赖
build.gradle
dependencies {
compile group: 'org.hibernate', name: 'hibernate-core', version: '3.6.7.Final' }
引用一个外部依赖需要使用 group, name 和 version 属性. 根据你想要使用的库, group 和 version 可能会有所差别.
有一种简写形式, 只使用一串字符串 "group:name:version" . 例子 8.3. 外部依赖的简写形式
build.gradle
dependencies {
compile 'org.hibernate:hibernate-core:3.6.7.Final' }
要了解跟多关于定义并使用依赖工作的信息,参见Section 52.4,"How to declare you dependencies".
外部的依赖
53
仓库
Gradle 是怎样找到那些外部依赖的文件的呢? Gradle 会在一个repository(仓库)里找这些文件.
仓库其实就是文件的集合, 通过 group , name 和 version 整理分类. Gradle 能解析好几种不 同的仓库形式, 比如 Maven 和 Ivy, 同时可以理解各种进入仓库的方法, 比如使用本地文件系统 或者 HTTP.
默认地, Gradle 不提前定义任何仓库. 在使用外部依赖之前, 你需要自己至少定义一个库. 比如 使用下面例子中的 Maven central 仓库:
例子 8.4. Maven central 仓库 build.gradle
repositories { mavenCentral() }
或者使用一个远程的 Maven 仓库:
例子 8.5. 使用远程的 Maven 仓库 build.gradle
repositories { maven {
url "http://repo.mycompany.com/maven2"
} }
或者一个远程的 Ivy 仓库:
例子 8.6. 使用远程的 Ivy 仓库 build.gradle
repositories { ivy {
url "http://repo.mycompany.com/repo"
} }
你也可以使用本地的文件系统里的库. Maven 和 Ivy 都支持下载的本地.
仓库
例子 8.7. 使用本地的 Ivy 目录 build.gradle
repositories { ivy {
// URL can refer to a local directory url "../local-repo"
} }
一个项目可以有好几个库. Gradle 会根据依赖定义的顺序在各个库里寻找它们, 在第一个库里 找到了就不会再在第二个库里找它了.
可以在Section 50.6 章, “仓库”里找到更详细的信息.
仓库
55