本文首发：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
...

参考

• https://developer.android.com/studio/build/dependencies.html