Android 开发之 Gradle那些事儿（一）

一.用Gradle编译的项目结构

1. 根目录会有一个settings.gradle、一个项目的build.gradle。
2. 每个module下会有一个本模块的build.gradle。
   

settings.gradle

settings.gradle 文件定义了哪些module 应该被加入到编译过程，通过include语句包含需要加入编译的模块。 例子如下：

include ‘:app’, ‘:module2’, ‘:module3’, ‘:module3’, ‘:module4’, ‘:module5’

settings.gradle中可以定义方法；settings.gradle的代码在编译初始阶段就会被执行。例子如下：

def String getTimeWhenStartBuild() {
    return new Date().format("yyyy/MM/dd HH:mm:ss")
}

println("开始构建的时间是：" + getTimeWhenStartBuild())

include ':app', ':module2', ':module3', ':module3', ':module4', ':module5', ':mylibrary'

项目的build.gradle

项目的build.gradle文件用来配置整个项目公共的一些东西，如仓库配置、编译工具类路径配置、依赖项配置、第三方插件配置等。一个包含了公共配置、额外task(含自定义task)和额外属性的例子如下：

/**
 * buildscript 中的声明是 "gradle脚本自身需要使用的资源"
 * 包括依赖项、第三方插件、仓库地址等
 **/
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.3.1'
    }
}

/**
 * allprojects 在多模块项目中，用于声明 "各模块公共使用的仓库地址"
 * 一般各模块在自身模块内的build.gradle内配置自身依赖的插件和库，模块内的配置会替换掉此处的公共配置
 **/
allprojects {
    repositories {
        jcenter()
        mavenCentral()
        maven { url "https://jitpack.io" }
        maven {url 'https://dl.bintray.com/calvinning/maven'}
    }
}

/**
 * task的type由Gradle本身提供有Copy、Delete、Sync等
 * Copy与Sync区别在于目标目录每次执行任务时是否保留原文件：Copy保留，Sync不保留
 */
task clean(type : Delete) {
    delete rootProject.buildDir
}

//输出本项目的一些信息：versionCode versionName minSdkVersion
task printProjInfo(type : getProjInfoTask)

//自定义的task需要继承自DefaultTask
class getProjInfoTask extends DefaultTask
{
    // @TaskAction 表示该Task要执行的动作,即在调用该Task时，printInfo()方法将被执行
    @TaskAction
    def printInfo()
    {
        if (project.hasProperty("minSdkVersion")) {
            println "最低支持到APILevel："+project.properties.get("minSdkVersion")
        }
        if (project.hasProperty("versionCode")) {
            println "比较版本号versionCode："+project.properties.get("versionCode")
        }
        if (project.hasProperty("versionName")) {
            println "显示版本号versionName："+project.properties.get("versionName")
        }

    }
}

/**
 * ext前缀 标识一组外置属性参数 ，可供其他.gradle存取
 */

ext {
    compileSdkVersion = 25
    buildToolsVersion = "25.0.3"
    minSdkVersion = 14
    targetSdkVersion = 22

    //发布(release)时修改此处的版本号
    versionCode = 100
    versionName = "1.0.0"
}

比较常用的一些命令：
gradlew task1 task2 […] 执行tasks

延伸：有四个基本的 task, Android 继承他们分别进行了自己的实现： assemble：对所有的 buildType 生成 apk
包。 clean:移除所有的编译输出文件，比如apk。 check:执行lint检测编译。
build:同时执行assemble和check命令 gradlew build 执行构建 gradlew
assembleRelease 打出Release包集合 gradlew assembleDebug 打出Debug包集合 gradlew
clean 执行清理
好了，关于根目录的Gradle就先写到这里，现在是北京时间 2017年10月17日00:56:48。写文章总是没有撸代码来的精神，下次再写吧，撸代码去也……

谢谢大家。完结撒花