gradle打包简介

一、gradle特点

ANT是最早的构建工具，基于idea,好象是2000年有的，当时是最流行java构建工具，不过它的XML脚本编写格式让XML文件特别大。对工程构建过程中的过程控制特别好。
Maven它是用来给Ant补坑的，Maven第一次支持了从网络上下载的功能，仍然采用xml作为配置文件格式，它的问题是不能很好的相同库文件的版本冲突。Maven专注的是依赖管理，构建神马的并不擅长。
Gradle属于结合以上两个的优点，它继承了Ant的灵活和Maven的生命周期管理，它实际上是Maven+Ant的一套更加用户友好的界面。不考虑IDE辅助的情况下，基于Groovy的DSL相比XML配置文件可以少写不少代码。此外因为是基于Groovy的DSL，可以更细致地控制编译过程。比如，Ant要做if-else条件选择特别麻烦，换做gradle的话可以直接套用java的编程风格 if(){}else{}。
总之，gralde 简单，高效，灵活

二、gradle 配置

（app/build.gradle）

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "gradlecomple.ndh.com.gradlecomplie"
        minSdkVersion 9
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.1.1'
}

我们都知道一个app工程下build.gradle第一句：apply plugin: ‘com.android.application’ 表示我们需要使用该插件的一些功能。弱弱问一句：
1、你怎么知道这里引用的插件是com.android.application？
2、android 下的各种配置是什么意思？
3、android下还有些什么配置?
一开始我也是一头雾水，完全搞不明白，需要用什么功能网上一顿乱搜，完全使用别人的经验，直到我访问了以下网址：
http://tools.android.com/tech-docs/new-build-system/user-guide#TOC-Build-Tasks

页面上有一句让你链接到android gradle 详细的DSL（domain specific language/领域专用语言）

Please see the [Android Plugin DSL Reference](http://google.github.io/android-gradle-dsl/current/) for a complete list of build properties that can be configured and their default values.

进入到页面你会看到：

这里就告诉你android用的有三种插件。
点开AppExtension瞧瞧：

这些就是android下可以配置的属性。
比如说你想看defaultConfig里面还有些什么配置：
点击defalutConfig一项：

再次点开ProductFlavor:

看看这些是不是你想要的？

三、gradle打包
需求：打包一个sdk（带布局文件），并将jar包命名为mylib.jar，并将生成的文件拷贝到app工程
步骤分析：
1 打包资源文件生成R.java文件
2 依赖生成的R.java 打包java源码
3 拷贝资源文件和jar包到app工程
打包资源文件使用aapt命令，然而我没有找到对应的taskType，因此只好使用命令行方式。

1.1打资源包
（mylibrary/build.gradle）

#定义一个变量baseDir，表示当前目录
def basedir = rootDir.getAbsolutePath()
#定义编译资源的task
task compileRes() {
    doLast {
    #这里表示 执行命令行
        exec {
            commandLine gradle.aapt,
                    'package',
                    '-f',
                    '-m',
                    '-J',
                    "${basedir}/mylibrary/gen",
                    '-M',
                    "${basedir}/mylibrary/src/main/AndroidManifest.xml",
                    '-S',
                    "${basedir}/mylibrary/src/main/res",
                    '-A',
                    "${basedir}/mylibrary/src/main/assets",
                    '-I',
                    gradle.home,
                    '-F',
                    "${basedir}/mylibrary/gen/${resName}"
        }
    }
}

ps:taskType简介
gadle脚本中可执行的东西叫task ，gradle定义了一系列的task类型-taskType。其文档在这：https://docs.gradle.org/current/dsl/index.html#N10335
打开后可以看到：

1.2 编译class
java编译class刚好gradle有提供任务类型 JavaCompile：https://docs.gradle.org/current/dsl/org.gradle.api.tasks.compile.JavaCompile.html:
其相关可配置属性如下：

具体编译任务如下：
（mylibrary/build.gradle）

task compileLib(type: JavaCompile, dependsOn: 'compileRes') {
//保证build_new一定存在，因为生成的class文件需要放到该目录下
    doFirst {
        def file = new File("${basedir}/mylibrary/build_new")
        if (!file.exists()) {
            file.mkdir()
        }
    }
    //配置java代码
    source "${basedir}/mylibrary/src/main/java"
    //配置工程引用的R.java文件（R.java文件由任务compileRes生成到gen目录下）
    source "${basedir}/mylibrary/gen/hotfix"
    //设置编译好的class文件存放目录
    destinationDir = new File("${basedir}/mylibrary/build_new")
    //这里用到的gradle.home 配置到local.property里，具体如何引用请看下面介绍 3.2
    FileCollection fc = files(new File(gradle.home))
    //设置classpath（包括所有依赖jar）
    classpath = fc
}

1.3打jar包
通过寻找，我们看到gradle自带有jar任务类型https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Jar.html：

baseName:表示 将生成的jar重命名
encoding:表示使用的编码规则
另外在文档下方方法区里有这么一个方法：

这里配置当前Jar任务类型需要的sourcePaths
具体任务如下：
（mylibrary/build.gradle）

task compileJar(type: Jar, dependsOn: 'compileLib') {
    baseName = "${jarName}"
    encoding = "utf-8"
    from "${basedir}/mylibrary/build_new"
//    into "${basedir}/mylibrary/out"
}
执行完该任务会在build/libs下生成一个mylib.jar(系统默认是classes.jar,因为上边配置的baseName的原因更改了默认文件名)

1.4 拷贝编译的资源文件,jar包到app目录
（mylibrary/build.gradle）

//拷贝jar包到app/libs
task copyLibFile(type: Copy, dependsOn: 'compileJar') {
 copyFile("${basedir}/mylibrary/build/libs/${jarName}.jar", "${basedir}/app/libs")
}
//拷贝aapt打包的资源到app工程assets目录
task copyResFile(type: Copy, dependsOn: 'copyLibFile') {
//这里copyFile为定义在util.gradle的函数，目的就为了代码复用，外部gradle的引用请看下文TODO
    copyFile("${basedir}/mylibrary/gen/${resName}", "${basedir}/app/src/main/assets")
}

三、gradle 扩展
3.1 gradle任务的两种写法

task ma( description="开始打包",group="MA",dependsOn: 'mb'){
doLast{
printlnx "this is task ma"
}
}
task mb(){
    printlnx "this is task mb"
}
以上也可写成这样：
//<< 表示doLast
task ma<<{
    printlnx "this is task ma"
}
//可以单独为ma配置属性，（很类似js的对象属性配置）
ma{
    dependsOn "mb"//依赖mb任务
    description="开始打包"//任务描述
    group="MA"//为当前ma任务分组
}
task mb(){
    printlnx "this is task mb"
}
但请注意 以下写发错误：
task ma(description="开始打包",group="MA",dependsOn: 'mb')<<{
printlnx "this is task ma"
}
也就是<< 前面不能带（）

3.2 gradle获取配置文件属性
上文有一个属性为 gradle.home,这个home属性其实是定义在根目录下local.properties里：

解析该属性在(（mylibrary/setting.gradle):

    //通过gradle.ext 将sdk.api属性导出为api
     gradle.ext.api = properties.getProperty('sdk.api')
    gradle.ext.aapt=properties.getProperty('sdk.aapt')
    gradle.ext.home=properties.getProperty('sdk.home')
    gradle.ext.jar=properties.getProperty('jar')

在mylibrary/build.gradle中想使用这些属性先引用setting.gradle文件：

apply from: rootProject.getRootDir().getAbsolutePath() + "/mylibrary/settings.gradle"

然后直接通过gradle.api(这里不再是gradle.ext.api)就可以获取到local.properties配置的属性

3.3 引用外部gradle方法
在build.gradle中我只想做和打包相关的逻辑，其他辅助逻辑（比如文件拷贝）我想抽取到外部，一方面使各个gradle文件逻辑干净整洁，一方面也可以代码复用。上面提到mylibrary/build.gradle引用到了mylibrary/utils.gradle中的copyFile方法
copyFile在utils.gradle中定义如下：

def copyFile(srcPath, desPath) {
    def File src = file(srcPath)
    def File des = file(desPath)
    //文件拷贝到文件夹
    if (src.isFile() && des.isDirectory()) {
        def des1 = file(des.absolutePath + "/" + src.getName())
        des1.createNewFile()
        des1.withOutputStream {
            os ->
                src.withInputStream {
                    is -> os << is
                }
        }
    } 
}
//通过ext将当前文件的copyFile函数导出为copyFile函数供外部使用
ext {
    copyFile = this.&copyFile
}

解释一下这段代码
//将文件流写入到des1中
des1.withOutputStream {//这里是第一个闭包
//1 
     os ->
       src.withInputStream {//这里是第二个闭包
       //2
          is -> os << is
                          }
                    }
这段通过goovy编写，闭包是groovy中一个特别重要的概念，也是gradle构建中的基础。  闭包中的->左边表示参数，箭头右边是使用到该参数的函数
因此上边第一处箭头-> 左边的os表示第一个闭包的参数，对该参数的操作则是在第二个闭包中进行。
在第二个闭包中箭头->is是其参数，对is的操作，是在函数 os<<is中进行，这里的<<为groovy中的语法 表示流的读写（将<<右边的is 读取到左边的os中，groovy中读写就是真么叼）

在build.gradle中使用copyFile先引用utils.gradle

apply from: rootProject.getRootDir().getAbsolutePath() + "/mylibrary/utils.gradle"

然后像调用本文件方法一样使用copyFile

task copyLibFile(type: Copy, dependsOn: 'compileJar') {
 copyFile("${basedir}/mylibrary/build/libs/${jarName}.jar", "${basedir}/app/libs")
}

示例代码下载：https://github.com/killer8000/GradleSample