本文首发：http://yuweiguocn.github.io/
本文介绍了Android Studio中Gradle 构建依赖配置说明及如何查看依赖树等。
《白帝下江陵》
朝辞白帝彩云间，千里江陵一日还。
两岸猿声啼不住，轻舟已过万重山。
-唐，李白
依赖类型
1.本地module类库依赖
compile project(':mylibrary')
2.本地二进制依赖
//添加libs文件夹下所有jar包作为依赖
compile fileTree(dir: 'libs', include: ['*.jar'])
//指定jar包作为依赖
compile files('libs/foo.jar', 'libs/bar.jar')
3.远程二进制依赖
compile 'com.example.android:app-magic:12.3'
//or
compile group: 'com.example.android', name: 'app-magic', version: '12.3'
注意远程依赖需要添加合适的远程仓库。
类库依赖配置
在依赖区域块你可以使用不同的依赖配置声明类库依赖。
- compile：gradle添加依赖到编译路径并打包到APK。
- apk：gradle添加依赖只打包到APK（不会添加到编译路径）。
- provided：gradle添加依赖到编译路径（不会打包到APK）。
注意：在app module中，不能使用
provided添加AAR依赖，只能添加JAR包。在library module中，你可以使用它添加AAR和JAR依赖。
上面的配置应用到工程的main源码集，会被应用到所有的构建变种。如果你只想给指定的构建变种源码集或测试源码集声明依赖，你需要使用配置名和构建变种或测试源码集的名字作为前缀。
例如，你只想添加compile依赖到“free”产品flavor上：
dependencies {
freeCompile 'com.google.firebase:firebase-ads:9.8.0'
}
如果你想给产品flavor和构建类型的变种添加一个依赖，你需要在configurations块初始化配置名称。下面的例子说明了添加一个apk依赖到“freeDebug”构建变种上：
configurations {
// Initializes a placeholder for the freeDebugApk dependency configuration.
freeDebugApk {}
}
dependencies {
freeDebugApk fileTree(dir: 'libs', include: ['*.jar'])
}
为本地测试和设备测试添加compile依赖：
dependencies {
// Adds a remote binary dependency only for local tests.
testCompile 'junit:junit:4.12'
// Adds a remote binary dependency only for the instrumented test APK.
androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2'
}
如果你的类库module提供多个变种，你可以添加不同的类库变种到不同的app变种：
dependencies {
// Adds the 'debug' varaint of the library to the debug varaint of the app
debugCompile project(path: ':my-library-module', configuration: 'debug')
// Adds the 'release' varaint of the library to the release varaint of the app
releaseCompile project(path: ':my-library-module', configuration: 'release')
}
远程仓库
默认情况下Android Studio在工程根目录下的build.gradle文件中声明JCenter作为仓库位置：
allprojects {
repositories {
jcenter()
}
}
添加mavenCentral、mavenLocal或指定的Maven仓库：
allprojects {
repositories {
jcenter()
mavenCentral()
mavenLocal()
maven {
url "https://repo.example.com/maven2"
}
maven {
url "file://local/repo/"
}
ivy {
url "https://repo.example.com/ivy"
}
}
}
谷歌的Maven仓库
下面的Android类库最新版本可以从Google的Maven仓库中获取：
- Android Support Library
- Architecture Components Library
- Constraint Layout Library
- Android Test Support Library
- Databinding Library
- Android Instant App Library
添加google的Maven仓库到module下的build.gradle文件中：
repositories {
maven {
url 'https://maven.google.com'
// 另外一个可用的URL是 'https://dl.google.com/dl/android/maven2/'
}
}
然后添加你想要的类库到dependencies块：
dependencies {
compile 'com.android.support:appcompat-v7:26.0.0-beta2'
}
注意：如果你添加类库的老版本并且依赖失败了，那说明Maven仓库中不可用只能从离线仓库（SDK Manager）中获取。
依赖顺序
在dependencies列表中的依赖顺序表示每个的优先级，第一个优先级最高，然后依次排之。类库的依赖顺序关系到资源合并和清单文件元素的合并。
例如：添加了LIB_A和LIB_B依赖，LIB_A依赖于LIB_C和LIB_D，LIB_B依赖于LIB_C，那么依赖顺序将会是：
1.LIB_A
2.LIB_D
3.LIB_B
4.LIB_C
这会确保LIB_A和LIB_B都可以覆盖LIB_C，LIB_D比LIB_B的优先级高因为LIB_A比LIB_B优先级高。
查看依赖树
一些直接依赖可能有它们自己的依赖。这称为依赖传递。我们可以通过从任务列表找到androidDependencies双击执行。
1.选择View > Tool Windows > Gradle。
2.展开 AppName > Tasks > android 并且双击androidDependencies。
3.查看报告，选择 View > Tool Windows > Gradle Console。
下面为debug构建变种依赖树示例，包括本地module依赖和远程依赖：
Executing tasks: [androidDependencies]
:app:androidDependencies
debug
/**
* Both the library module dependency and remote binary dependency are listed
* with their transitive dependencies.
*/
+--- MyApp:mylibrary:unspecified
| \--- com.android.support:appcompat-v7:25.4.0
| +--- com.android.support:animated-vector-drawable:25.4.0
| | \--- com.android.support:support-vector-drawable:25.4.0
| | \--- com.android.support:support-v4:25.4.0
| | \--- LOCAL: internal_impl-25.4.0.jar
| +--- com.android.support:support-v4:25.4.0
| | \--- LOCAL: internal_impl-25.4.0.jar
| \--- com.android.support:support-vector-drawable:25.4.0
| \--- com.android.support:support-v4:25.4.0
| \--- LOCAL: internal_impl-25.4.0.jar
\--- com.android.support:appcompat-v7:25.4.0
+--- com.android.support:animated-vector-drawable:25.4.0
| \--- com.android.support:support-vector-drawable:25.4.0
| \--- com.android.support:support-v4:25.4.0
| \--- LOCAL: internal_impl-25.4.0.jar
+--- com.android.support:support-v4:25.4.0
| \--- LOCAL: internal_impl-25.4.0.jar
\--- com.android.support:support-vector-drawable:25.4.0
\--- com.android.support:support-v4:25.4.0
\--- LOCAL: internal_impl-25.4.0.jar
...
