Gradle常见配置总结

1、理解根目录下的build.gradle

在使用Android Studio创建工程时，会在根目录创建类似如下的build.gradle。本文将从初学者的角度来解释每一行的意思，具体的细节还需查看gradle的API文档。

如果要学习gradle，推荐一篇写得很好的blog深入理解Android之Gradle。个人认为最重要的一点是不要把build.gradle简单地看作配置文件，而是要把它看作一种编程框架，使用其API或者Groovy编程语言来完成编译、打包、测试等工作。

以下的注释为每一行代码的意思，希望对理解build.gradle有所帮助。

// Top-level build file where you can add configuration options common to all sub-projects/modules.
// Gradle中可以使用“//”或“/**/”来添加注释，与Java类似。
// 根目录下的build.gradle用于添加子工程或模块共用的配置项。

// "buildscript"的类型为script block，而且是最上层的script block，用于配置Gradle的Project实例。其API文档为https://docs.gradle.org/current/dsl/org.gradle.api.Project.html#org.gradle.api.Project:buildscript(groovy.lang.Closure)
// 其余的根script block有"allprojects", "dependencies", "configurations"等，更多的可见https://docs.gradle.org/current/dsl/的“Build script structure”一节。
// Script Block是一种method的调用，传入的参数为configuration closure。执行后会对Project的属性进行配置。
// 此处的"buildscript"用于配置Project的build script的classpath。
buildscript {
    // 如果需要的话，从https://jcenter.bintray.com/下载code reposities。
    repositories {
        jcenter()
    }
    // 定义classpath，gradle会从“repositories”中下载对应版本的Gradle。如果使用gradle wrapper的话，感觉这个配置会被忽略。Wrapper会自己去下载所使用的gradle版本。
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

// 该配置会被应用到所有的子工程。
allprojects {
    repositories {
        jcenter()
    }
}

// 运行gradle clean时，执行此处定义的task。
// 该任务继承自Delete，删除根目录中的build目录。
// 相当于执行Delete.delete(rootProject.buildDir)。
// gradle使用groovy语言，调用method时可以不用加（）。
task clean(type: Delete) {
    delete rootProject.buildDir
}

2、Android Studio gradle 文件中 ${supportLibVersion} 用法

一般我们在项目中的gradle会添加如下库文件：

dependencies {  
    compile 'com.android.support:appcompat-v7:23.1.0'  
    compile 'com.android.support:design:23.1.0'  
    compile 'com.android.support:pallete-v7:23.1.0'  
    compile 'com.android.support:cardview-v7:23.1.0'  
    compile 'com.android.support:recyclerview-v7:23.1.0'  
}

所以每次升级的时候都要修改后面的23.1.0版本号，Android开发小组的Chris Banes想出了这样的一个方法，不用每次修改每个版本，而只需要修改一次就行了，如下：

ext {  
    supportLibVersion = "23.1.1"  
}  

dependencies {  
    compile "com.android.support:appcompat-v7:${supportLibVersion}"  
    compile "com.android.support:design:${supportLibVersion}"  
    compile "com.android.support:recyclerview-v7:${supportLibVersion}"  
    compile "com.android.support:cardview-v7:${supportLibVersion}"  
}

错误的写法：

compile 'com.android.support:appcompat-v7:${supportLibVersion}'

正确的写法：

compile "com.android.support:appcompat-v7:${supportLibVersion}"

3、依赖包冲突解决办法

项目中使用的library版本是23，但是项目引用的包引用的library版本是24，这样就会出现冲突，报错如下：

解决办法，使用exclude，排除冲突的依赖包：

 compile ('com.bat:apploginsdk:1.0.1') {
        // exclude module : 'okhttp'
        // exclude module : 'com.android.support'
        exclude group: 'com.android.support', module: 'recyclerview-v7'
        exclude group: 'com.android.support', module: 'support-v4'
        exclude group: 'com.android.support', module: 'design'
        exclude group: 'com.android.support', module: 'appcompat-v7'
    }