一、统一管理依赖版本

1.1 在根目录下，新建config.gradle文件

ext {android = [compileSdkVersion: 23,buildToolsVersion: "23.0.3",applicationId: "com.example.lizejun.repogradle",minSdkVersion: 14,targetSdkVersion: 23,versionCode: 1,versionName: "1.0",testInstrumentationRunner: "android.support.test.runner.AndroidJUnitRunner"]dependencies = ["support-v4"  : 'com.android.support:support-v4:23.2.0',"support-v7"  : 'com.android.support:appcompat-v7:23.2.0']}
复制代码

android用来管理SDK版本、版本号等，dependencies用来管理依赖库的版本，它们都是一个数组，用逗号来分割，数组的每个元素都是key:value的格式。

1.2 在根目录下的build.gradle，新增：

apply from: "config.gradle"
复制代码

1.3 在根目录下的各个Module或者Library中的build.gradle文件中，引用对应的key：

android {compileSdkVersion rootProject.ext.android.compileSdkVersionbuildToolsVersion rootProject.ext.android.buildToolsVersiondefaultConfig {applicationId rootProject.ext.android.applicationIdminSdkVersion rootProject.ext.android.minSdkVersiontargetSdkVersion rootProject.ext.android.targetSdkVersionversionCode rootProject.ext.android.versionCodeversionName rootProject.ext.android.versionNametestInstrumentationRunner rootProject.ext.android.testInstrumentationRunner}
}dependencies {compile rootProject.ext.dependencies["support-v7"]
}
复制代码

二、查看依赖关系

2.1 工具查看

依赖树的查看可以通过Android Studio的插件Gradle View来查看：

重启之后，点击View -> Tool Windows -> Gradle View，之后会在最下方生成一个窗口，我们通过这个窗口就可以看到对应项目的依赖关系：

2.2 命令查看

除此之外，我们也可以使用以下的命令：

./gradlew -q app:dependencies
复制代码

同样可以获得类似的结果：

注意上图，如果标记了(*)，那么表示这个依赖被忽略了，这是因为其他顶级依赖中也依赖了这个传递的依赖，Gradle会自动分析下载最合适的依赖。

三、标识符

由于多个顶级依赖当中，可能包含了相同的子依赖，但是它们的版本不同，这时候为了选择合适的版本，那么就需要使用一些必要的操作符来管理子依赖。

3.1 Transitive

默认为true，表示gradle自动添加子依赖项，形成一个多层树形结构；设置为false，则需要手动添加每个依赖项。

3.1.1 统一指定Transitive

configurations.all {transitive = false
}dependencies {compile rootProject.ext.dependencies["support-v7"]
}
复制代码

最终得到的结果是，可以看到前面的子依赖项都没有了：

3.1.2 单独指定Transitive

dependencies {compile ('com.android.support:appcompat-v7:23.2.0') {transitive = false}
}复制代码

3.2 Force

用来表示强制设置某个模块的版本：

configurations.all {resolutionStrategy {force 'com.android.support:support-v4:23.1.0'}
}
复制代码

之后打印，发现其依赖的包版本变成了23.1.0：

3.3 exclude

该标识符用来设置不编译指定的模块

3.3.1 全局配置某个模块

configurations {all *.exclude group : 'com.android.support', module: 'support-v4'
}
复制代码

此时的依赖关系为：

当然，exclude后的参数有group和module，可以分别单独使用，会排除所有匹配项。

3.3.2 单独给某个模块exclude

    compile ('com.android.support:appcompat-v7:23.2.0') {exclude group : 'com.android.support', module: 'support-v4'}
复制代码

也会和上面获得相同的结果

四、版本冲突

4.1 相同配置下的版本冲突

同一配置下，某个模块的不同版本同时被依赖时，默认使用最新版，Gradle同步时不会报错。

五、Gradle详解

基本配置：AS中的Android项目通常至少包含两个build.gradle，一个是Project范围的，另一个是Module范围的，由于一个Project可以有多个Module，所以每个Module下都会对应一个build.gradle。

5.1 Project下的build.gradle

// Top-level build file where you can add configuration options common to all sub-projects/modules.
apply from: "config.gradle"buildscript {repositories {jcenter()}dependencies {classpath 'com.android.tools.build:gradle:1.3.1'}
}allprojects {repositories {jcenter()}
}task clean(type: Delete) {delete rootProject.buildDir
}
复制代码

• buildscript下的repositories是gradle脚本自身需要的资源，
• allprojects下的repositories是项目所有模块需要的资源。

5.2 模块的build.gradle

//声明插件,表明这是一个Android程序;如果是库,那么应当是com.android.library
apply plugin: 'com.android.application'
//Android构建过程需要配置的参数
android {//编译版本compileSdkVersion rootProject.ext.android.compileSdkVersion//buildTool版本buildToolsVersion rootProject.ext.android.buildToolsVersion//默认配置,同时应用到debug和release版本上defaultConfig {applicationId rootProject.ext.android.applicationIdminSdkVersion rootProject.ext.android.minSdkVersiontargetSdkVersion rootProject.ext.android.targetSdkVersionversionCode rootProject.ext.android.versionCodeversionName rootProject.ext.android.versionNametestInstrumentationRunner rootProject.ext.android.testInstrumentationRunner}//配置debug和release版本的一些参数,例如混淆,签名配置等buildTypes {//release版本release {minifyEnabled false //是否开启混淆proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' //混淆文件位置}}
}dependencies {compile fileTree(dir: 'libs', include: ['*.jar'])compile rootProject.ext.dependencies["support-v7"]androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {exclude group: 'com.android.support', module: 'support-annotations'})testCompile 'junit:junit:4.12'
}
复制代码

下面对Android构建过程中需要配置的参数做一些解释：

• compileSdkVersion：告诉gradle用那个Android SDK的版本编译你的应用，修改它不会改变运行时的行为，因为它不会被包含进入最终的APK中；因此，推荐使用最新的SDK编译；如果使用Suppport Library，那么compileSdkVersion必须要大于等于它的大版本号。
• minSdkVersion：应用最低可运行的要求；它必须要大于等于你所依赖的库的minSdkVersion；
• targetSdkVersion：Android提供向前兼容的重要依据。（targetSdkVersion is the main way Android provides forward compatibility） 因为随着Android系统的升级，某个api或者模块的行为有可能发生改变，但是为了保证老APK的行为和以前兼容，只要APK的targetSdkVersion不变，那么即使这个APK安装在新的Android系统上，那么行为还是保持老的系统上的行为。 系统在调用某个api或者模块的时候，会先检查调用的APK的targetSdkVersion，来决定执行什么行为。

minSdkVersion和targetSdkVersion最终会被包含进入最终的APK文件中，如果你查看生成的AndroidManifest.xml，那么会发现：

<uses-sdk android:targetSdkVersion="23" android:minSdkVersion="7" />
复制代码

所以，我们一般遵循的规则是：

minSdkVersion (lowest possible) <= targetSdkVersion == compileSdkVersion (latest SDK)
复制代码

5.3 gradle相关文件

• gradle.properties 配置文件，可以定义一些常量供build.gradle使用，比如可以配置签名相关信息，例如keystore位置、密码、keyalias等。
• settings.gradle 用来配置多模块的，如果你的项目有两个模块Browser和ScannerSDK，那么就需要：

include ':Browser'
include ':ScannerSDK'
project(':ScannerSDK').projectDir = new File(settingsDir, './ScannerSDK/')
复制代码

• gradle文件夹 里面有两个文件，gradle-wrapper.jar和gradle-wrapper.properties，后者当中指定了gradle的版本。

distributionUrl=https\://services.gradle.org/distributions/gradle-2.8-all.zip
复制代码

• gradlew和gradlew.bat 分别是Linux和windows下的批处理文件，它们的作用是根据gradle-wrapper.properties文件中的distributionUrl下载对应的gradle版本，这样即使环境没有安装gradle也可以编译。

5.4 gradle仓库

gradle有三种仓库：maven/ivy/flat本地。

maven{url  "..."
}
ivy{url  "..."
}
flatDir{dirs 'xxx'
}
复制代码

有些仓库取了别名：

repositories{mavenCentral()jcenter()mavenLocal()
}
复制代码

5.5 gradle任务

通过以下指令，可以看到支持的任务：

./gradlew tasks
复制代码

六、常见问题

6.1 导入本地Jar包

导入单个jar文件：

compile files('libs/xxx.jar')
复制代码

导入libs的多个jar文件：

compile fileTree(dir: 'libs', include: ['*.jar'])
复制代码

6.2 导入maven库

compile 'groupId:artifactId:version'
复制代码

6.3 导入Project

在导入之前，需要在settings.gradle中把模块包含进来，例如前面的ScannerSDK模块：

compile project(':ScannerSDK')
复制代码

6.4 声明第三方maven库

如果项目中需要的一些库文件不再中央仓库中，而是在某个特定地址里，那么就需要在Project中的build.gradle中的allprojects结点下或者直接配到某个模块中：

allprojects {repositories {maven {url '地址'}}
}
复制代码

6.5 依赖第三方aar

compile 'com.aaa.xxx:core:1.0.1@aar'
复制代码

6.6 将库导出为aar

首先，你的项目必须是一个库项目，之后在build.gradle中进行配置：

apply plugin : 'com.android.library'
复制代码

之后，进入到该项目中，执行gradle命令：

./gradlew assembleRelease
复制代码

生成的aar放在/build/output/aar文件当中

6.7 引用本地aar

首先，将aar文件拷贝到对应目录下，然后在该模块的build.gradle中声明flat仓库：

repositories{flatDir{dirs '以build.gradle为根目录的相对路径'}
}
复制代码

之后，在dependencies结点下依赖该aar模块：

dependencies{compile (name:'xxx',ext:'aar')
}
复制代码

七、多版本打包

在此之前，我们先了解几个基本的概念：

• buildTypes：构建类型，Android Studio的Gradle组件默认提供了debug和release两个默认配置，这里主要用于是否需要混淆，是否调试。
• productFlavors：产品渠道，在实际发布中，根据不同渠道，可能需要使用不同的包名，甚至是不同的代码。
• buildVaiants：每个buildTypes和productFlavors组成一个buildvariant。

以上我们讨论的buildTypes和productFlavors可以通过每个Module中的build.gradle的android标签来配置。

下面，我们先看一下不同的productFlavors，分别用来支持读取不同的文件和替换不同的字符串。

7.1 引用不同的代码

我们首先在app/src目录下新建两个目录，分别对应两个Flavor，再在其中建立相同名字的文件Constant.java，对里面的某个常量赋予不同的值。

• constantFlavor1：

package com.example.lizejun.repogradle;public class Constant {public static final String NAME = "flavor1";
}
复制代码

• constantFlavor2：

package com.example.lizejun.repogradle;public class Constant {public static final String NAME = "flavor2";
}
复制代码

我们的app下的build.gradle中的android标签下添加如下几行代码，让两个Flavor分别引用不同的Constant文件：

    sourceSets {constantFlavor1 {java.srcDirs =  ['src/constantFlavor1', 'src/constantFlavor1/java', 'src/constantFlavor1/java/']}constantFlavor2 {java.srcDirs =  ['src/constantFlavor2', 'src/constantFlavor2/java', 'src/constantFlavor2/java/']}}productFlavors {constantFlavor1 {}constantFlavor2 {}}
复制代码

之后我们进行打包，可以得到以下不同安装包，这两个apk如果在其中引用的了NAME，那么它会得到不同的值：

7.2 自定义buildConfig类

如果我们只需要定义一些简单的值，那么我们可以用buildConfig类：

    productFlavors {constantFlavor1 {buildConfigField "boolean", "BOOLEAN_VALUE", "true"}constantFlavor2 {buildConfigField "boolean", "BOOLEAN_VALUE", "false"}}
复制代码

7.3 占位符

    productFlavors {constantFlavor1 {buildConfigField "boolean", "BOOLEAN_VALUE", "true"manifestPlaceholders = [label:"constantFlavor1"]}constantFlavor2 {buildConfigField "boolean", "BOOLEAN_VALUE", "false"manifestPlaceholders = [label:"constantFlavor2"]}}
复制代码

之后，我们再在AndroidManifest.xml中引用它：

android:label="${label}"
复制代码

7.4 签名配置

首先是在android标签下，我们使用signingConfigs来配置不同的签名类型

    signingConfigs {eng {keyAlias 'androiddebugkey'keyPassword 'android'storeFile file('debug.keystore')storePassword 'android'}prd {keyAlias 'androiddebugkey'keyPassword 'android'storeFile file('debug.keystore')storePassword 'android'}}
复制代码

之后，再在buildTypes的各个分支中引用对应的签名配置：

    buildTypes {debug {minifyEnabled falseproguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'signingConfig signingConfigs.eng}release {minifyEnabled falseproguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'signingConfig signingConfigs.prd}}
复制代码

7.5 依赖

有时候，我们需要在不同的buildTypes下，引用不同的依赖，例如内存泄露的检测工具，我们希望在debug版本时检查内存泄露，并在发生时在桌面上生成图标，但是在release版本上我们并不希望这么做，这时候我们可以这么写：

debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5'
releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5'
复制代码

这样，release版本就不会在桌面生成内存泄露的图标。

---

更多文章，欢迎访问我的 Android 知识梳理系列：

• Android 知识梳理目录：www.jianshu.com/p/fd82d1899…
• 个人主页：lizejun.cn
• 个人知识总结目录：lizejun.cn/categories/