给 Android 初学者的 Gradle 知识普及

1 
前言

前一段时间有人在我的邪教群里问「刚学 Android 不久，对 Gradle 不懂，看了很多资料依然一知半解，希望张哥给讲讲 Gradle 」，没想到群里很多人都响应，表示同感，有人在群里推荐了一本书，说看这本书就行了。说实在的，我不反对看书，但是我反对的是为了弄懂一个知识点就需要看一本书那效率也太低了，于是我良心张就随口说了句「要不我在群里开个讲座给你们普及下 Gradle 基本概念吧？」没想到平时潜水的人全都出来了，然后纷纷回复「666…」，讲真，刚说过我就后悔了，主要没有那么多时间，但是毕竟已经放开话了，当晚加班回到家，没有一点准备就在群里给他们开始了长达一个多小时的普及工作，事后，出乎意料的大家一致反映效果很好，而且听课的全都很认真，有很多有心的人把我在群里一字一句打的聊天记录整理成了笔记分享在群里，我觉得这个主题可能对我的很多读者也都很有帮助，所以我在群里整理的笔记的基础上做了点补充与改进，希望这篇文章对你们有帮助！

2 
什么是构建工具？

我们大家都知道 Gradle 是一种构建工具，那么什么是构建工具呢？

网上一大堆的文字解释我觉得很难理解，这里我以咱们 android 开发来举个例子吧。

我们以前开发都是用 Eclipse ，而 Eclipse 大家都知道是一种 IDE （集成开发环境），最初是用来做 Java 开发的，而 Android 是基于 Java 语言的，所以最初 Google 还是希望 Android 能在 Eclipse 上进行开发，为了满足这个需求，Google 开发了一个叫 ADT （Android Developer Tools）的东西，相信以前从 Eclipse 时代过来的对 ADT 应该都不陌生，正是因为有了 ADT ，从此我们只需要码好代码，然后直接在 Eclipse 上进行编译、运行、签名、打包等一系列流程，而这背后的工作都是 ADT 的功劳。某种意义上 ADT 就是我们的构建工具。

而自 Google 推出 Android Studio 以来，就宣布默认使用 Gradle 来作为构建工具，并且之后放弃更新 ADT ，从此 Gradle 走入 Android 开发者的视野，而我也是在 AS 的 Beta 版开始接触并学习 Gradle。

一般来说，构建工具除了以上提到的编译、运行、签名、打包等，还具备依赖管理的功能，什么是依赖管理呢？还是拿 Eclipse 来说，我们以前在 Eclipse 上开发 Android ，如果需要用到第三方库的时候一般都是先下载 jar 文件，然后把 jar 文件添加到 libs 目录，然后项目中就可以引用了。但是你不觉得这种管理方式很麻烦么？假设第三方库有更新，需要下载最新的 Jar 文件，然后替换掉原来的，引用的库少还好，一旦引用的第三方库多，那简直麻烦死，可以说这种方式只有依赖，而没有管理。

现在大家不陌生的 Gradle 引用第三方库方式是这样的：

compile ‘com.android.support:support-v4:24.0.1’

类似这样的依赖方式，是不是很方便？而且很直观，直接可以看到源地址，升级的话直接改下版本号就可以了，这就是所谓的依赖管理。

所以构建工具就是对你的项目进行编译、运行、签名、打包、依赖管理等一系列功能的合集，传统的构建工具有 Make、Ant、Maven、Ivy等，而 Gradle 是新一代的自动化构建工具。

3 
什么是 Gradle ？

上面说了，Gradle 是新一代的自动化构建工具，它是一个独立的项目，跟 AS、Android 无关，官方网站：https://gradle.org/ , 类似 Ant、Maven这类构建工具都是基于 xml 来进行描述的，很臃肿，而 Gradle 采用的是一种叫做 Groovy 的语言，语法跟 Java 语法很像，但是是一种动态语言，而且在 Java 基础上做了不少改进，用起来更加简洁、灵活，而且 Gradle 完全兼容 Maven、Ivy，这点基本上宣布了 Maven、Ivy 可以被抛弃了，Gradle 的推出主要以 Java 应用为主，当然目前还支持 Android、C、C++。

4 
Gradle 与 Android Studio 的关系

上面也提到，Gradle 跟 Android Studio 其实没有关系，但是 Gradle 官方还是很看重 Android 开发的，Google 在推出 AS 的时候选中了 Gradle 作为构建工具，为了支持 Gradle 能在 AS 上使用，Google 做了个 AS 的插件叫 Android Gradle Plugin ，所以我们能在 AS 上使用 Gradle 完全是因为这个插件的原因。在项目的根目录有个 build.gradle 文件，里面有这么一句代码：

classpath ‘com.android.tools.build:gradle:2.1.2’

这个就是依赖 gradle 插件的代码，后面的版本号代表的是 android gradle plugin 的版本，而不是 Gradle 的版本，这个是 Google 定的，跟 Gradle 官方没关系。关于 android gradle plugin 的更多信息可以到这里查看，这里列举了 android gradle plugin 每个版本的具体变化与具体功能：

http://tools.android.com/tech-docs/new-build-system

友情提示，需要科学上网！

5 
Gradle Wrapper

现在默认新建一个项目，然后点击 AS 上的运行，默认就会直接帮你安装 Gradle ，我们不需要额外的安装 Gradle 了，但是其实这个 Gradle 不是真正的 Gradle ，他叫 Gradle Wrapper ，意为 Gradle 的包装，什么意思呢？假设我们本地有多个项目，一个是比较老的项目，还用着 Gradle 1.0 的版本，一个是比较新的项目用了 Gradle 2.0 的版本，但是你两个项目肯定都想要同时运行的，如果你只装了 Gradle 1.0 的话那肯定不行，所以为了解决这个问题，Google 推出了 Gradle Wrapper 的概念，就是他在你每个项目都配置了一个指定版本的 Gradle ，你可以理解为每个 Android 项目本地都有一个小型的 Gradle ，通过这个每个项目你可以支持用不同的 Gradle 版本来构建项目。

理解了 Gradle Wrapper 的概念就好办了，以下的所有操作都是基于 Gradle Wrapper 的。

默认我们在 AS 上第一次创建项目会自动下载 Gradle 的，这个过程很漫长，出奇的慢，但是第一次之后就ok了，接下来就是教大家用命令行测试下，请大家在终端或者 AS 带的终端上切换到所在项目的目录，然后输入 ./gradlew -v (win用户直接输入 gradlew -v) ，即可以查看当前项目所用的 gradle 的版本，gradlew 即为 gradle wrapper 的缩写，如果你是第一次执行命令行，那么会出现一个下载的提示，紧接着会打印一个个的点，这个过程很漫长，依赖你的网速，时间几分钟到几十分钟不等。

有人有疑问，我 AS 上明明已经可以正常运行该项目的，说明 Gradle 已经下载过了，为什么命令行还要再下载一次？我也一直有这个疑问，理论上是不该再下载的，但是事实他就是要重新下载一次，我猜测可能是bug吧。

如果下载完成输入 ./gradlew -v 出现如下结果，证明你的项目是ok的，否则就是你的项目配置有问题了。

6 
Android 项目包含的 Gradle 配置文件

这里姑且以我很早在 GitHub 开源的 9GAG 项目为例，来稍微介绍下一个完整的 Android 项目包含的基本 Gradle 相关的配置文件：

红色标记部分从上到下咱们来一步步分析：

9GAG/app/build.gradle 
这个文件是 app 文件夹下这个 Module 的 gradle 配置文件，也可以算是整个项目最主要的 gradle 配置文件，具体里面的配置以后再介绍。

9GAG/extras/ShimmerAndroid/build.gradle 
每一个 Module 都需要有一个 gradle 配置文件，语法都是一样，唯一不同的是开头声明的是 
apply plugin: ‘com.android.library’

9GAG/gradle 
这个目录下有个 wrapper 文件夹，里面可以看到有两个文件，我们主要看下 gradle-wrapper.properties 这个文件的内容：

可以看到里面声明了 gradle 的目录与下载路径以及当前项目使用的 gradle 版本，这些默认的路径我们一般不会更改的，这个文件里指明的 gradle 版本不对也是很多导包不成功的原因之一。

9GAG/build.gradle 
这个文件是整个项目的 gradle 基础配置文件，默认的内容就是声明了 android gradle plugin 的版本。

9GAG/settings.gradle 
这个文件是全局的项目配置文件，里面主要声明一些需要加入 gradle 的 module，我们来看看 9GAG 该文件的内容：

7 
如何正确导入下载的开源项目？

我们经常会在 GitHub 发现一些优秀的开源项目，然后想要下载学习，然而第一步一般都是把源码导入到 AS 里，然后运行起来看下效果，但是经常会运行失败，这里我来给大家说下导入开源项目的正确姿势：

下载一个Demo，先打开每个 module下的 gradle 文件，即 app 目录下的 build.gradle 以及各个 library 下的 build.gradle ,首先查看 compileSdkVersion 和 buildToolsVersion，因为有些时候你本地的版本和下载的版本不一致，那么就会导致失败。 
然后就是检查 gradle-wrapper ，Google 有些时候要求不同的 AS 支持不同的 gradle 版本。比如 AS 1.0 的时候要求必须使用 gradle 1.x 的版本，等到 AS 2.0 的时候，Google 不支持 gradle1.x 的版本，这个时候你必须手动更新下 android gradle plugin 的版本，然后重新同步下。

检查以上两个地方基本就可以导入并运行了，如果还有其他问题，那可能就是环境或者项目本身的问题了。

8 
认识下几个命令

上面提到了，假设我们没有 IDE ，只有类似 Sublime、Atom、Vim这种轻量编辑器怎么办？那我们就没法开发 Android 了么？然而只要有构建工具，不需要 IDE 我们一样有办法开发，这个时候我们就需要用到几个有用的 Gradle 命令了：

./gradlew -v 版本号

./gradlew clean 清除9GAG/app目录下的build文件夹

./gradlew build 检查依赖并编译打包

这里注意的是 ./gradlew build 命令把 debug、release 环境的包都打出来，如果正式发布只需要打 Release 的包，该怎么办呢，下面介绍一个很有用的命令 assemble , 如

./gradlew assembleDebug 编译并打Debug包

./gradlew assembleRelease 编译并打Release的包

值得注意的是，以上所有命令都是在终端里执行，并且必须要切换到所在项目的根目录下执行，win系统直接执行 gradlew 。

9 
总结

以上就是今天给大家普及的 Android 中用到的 Gradle 基础知识，相信大家看完之后就大概理解了 Android 项目中的 Gradle 作用以及一些基本用法，关于 Gradle 的具体配置以及更多的介绍以后有时间再跟大家补充吧，我在很早的博客里的 AS 系列文章里其实有写过几篇关于 Gradle 的，感兴趣的不妨点击「阅读原文」去阅读拓展下。

PS：细心的朋友们已经发现我头像换了，哈哈，这个头像是我托一位非常牛的设计师朋友画的，之前那个头像是我网上找的，这次我让她帮我手绘了一个专属我的头像，还加了我的水印，全球只此一张，绝无雷同，你们喜欢么？不喜欢也没用，反正我很喜欢就行！哈哈…最后觉得这篇文章对你有帮助，那么请赞赏、转发、点赞支持我，你们的支持是我继续坚持原创分享的最大动力！

 

 

 

 

 

 

 

Gradle 是个啥，一开始我也没弄清，官方解释是： 
Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具 
那么Apache Ant和Apache Maven又是个啥？这个先忽略，那自动化建构工具呢？ 
我个人狭义的理解就是软件环境部署和打包的工具，那么.net 也有CruiseControl.Net持续集成 WIX生成安装包，这是类似的东西，只是Gradle这个工具是google的亲儿子，微软在这方面就不怎么给力了，功能强大一点的都是第三方工具。但是微软有一个依赖管理工具不错，就是NuGet,这个跟Gradle的依赖管理可以媲美。

在知乎上，我找到一个解释的特别好的文章，这里贴出来，以防以后链接失效原链接

Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具。它使用一种基于Groovy的特定领域语言来声明项目设置，而不是传统的XML。当前其支持的语言限于Java、Groovy和Scala，计划未来将支持更多的语言。上面是维基上对Gradle的解释,相信一个没有接触过构建的人是不大能看明白的,当初我也是.下面是我对Gradle通俗的理解: 软件开发讲究代码复用,通过复用可以使工程更易维护,代码量更少….. 开发者可以通过继承,组合,函数模块等实现不同程度上的代码复用.但不知你有没有想过,软件开发也是一种工程作业,绝不仅仅是写代码,还涉及到工程的各种管理(依赖,打包,部署,发布,各种渠道的差异管理…..),你每天都在build,clean,签名,打包,发布,有没有想过这种过程,也可以像代码一样被描述出来, 也可以被复用.举个例子我是做Android开发的,你可知道国内有n个android市场,n个手机品牌,n个手机尺寸……,一般公司都会针对不同的市场单独发包用来统计不同渠道的下载量等情况,可能需要针对不同(品牌,尺寸等各种硬件信息)的手机做一些特殊的处理,这个时候你可以针对不同的情况单独建一个工程,或者更好一点你可以通过一些变量来控制,像这样:if(isMoto){do something} 
else if(isHuawei){do something} 
… 
差异管理但这两种解决方法都有自己的缺点,特别是前一种有极大的代码重复.后一种稍微好一点,但这种方式的差异是运行时的,不是静态的,对于moto手机上的处理逻辑对华为手机来说一点作用也没有,但这一段针对moto手机的处理逻辑也被装到了华为手机上了,通过gradle的productFlavor与buildtype可以实现静态级的差异控制可以参考如何通过Gradle实现一套代码开发不同特性的APK · ByGhui 说到前面的多渠道问题,不同的渠道一般会对应不同的渠道号,你当然可以通过修改一次打一个包这种纯手工的方式来生成你的多渠道包,但据听说国内某团购网站的Android App有100多个渠道.这里出现了什么?重复,反复的去打包而且这些包之前的差异很小(只是渠道号不同),和写代码一样我们应该复用,通过Gradle可以实现一个命令打出所有的渠道包,一个命令打出指定的渠道包.再复杂一点,你可能需要不同的渠道对应不同的签名文件,不同的icon,不同的服务器地址…这些都可以通过Gradle来方便的实现.依赖管理:做软件开发你可能需要依赖各种不同的jar,library.你当然可以通过将.jar/library工程下载到本地再copy到你的工程中,但不知你是否听说过国外有个叫中央仓库的东西,在这个仓库里你可以找到所有你能想到以及你从来没听说过的jar,aar…The Central Repository Search Engine 这里可以找到所有你需要的依赖,而你需要的只是指定一个坐标,如下:剩下的依赖的寻找,下载,添加到classpath等你都不需要去关心,通过这种方式来维护依赖的好处有以下几点:剩下的依赖的寻找,下载,添加到classpath等你都不需要去关心,通过这种方式来维护依赖的好处有以下几点:依赖不会进入到你的版本控制仓库中(默认会缓存到~/.gradle/下)方便卸载装载依赖(只是一条坐标依赖,不需要删除即可)方便的版本管理,如上图中的2.3.3既是picasso的版本号,若改为+就表示从中央仓库中下载最新的版本不同工程的相同依赖不会存在重复副本(只在~/.gradle下存在一份)项目部署这方面我没怎么接触过,但据我所知通过一些插件,可以实现自动将你的输出(.jar,.apk,.war…)上传到指定仓库,自动部署…罗哩罗嗦说了这么多,不知大家有没有理解总结一下:Gradle是一种构建工具,它可以帮你管理项目中的差异,依赖,编译,打包,部署……,你可以定义满足自己需要的构建逻辑,写入到build.gradle中供日后复用.Gradle不是一种编程语言,它不能帮你实现软件中的任何实际功能通俗的解释肯定是不严谨的解释,不妥之处欢迎讨论.###赞同过百,放出之前相关分享的幻灯片###截止到现在(1432311622353)共收到342个赞同与感谢,再次感谢大家的支持!如果你觉得我的分享对你有帮助,请关注我! 以后我会分享更多更优质的内容给大家.说好的幻灯片在这里(是之前在letv时一次内部分享的幻灯片,内容有删减(涉及到公司具体项目的部分),此幻灯片参考了很多其它的资料,内部的链接很值得大家打开看看)

AS其实就是Intellij IDEA的安卓开发环境特供版（谷歌定制版），Intellij IDEA是有收费版本的IDE。Ant和Maven都是基于XML的构建工具，Gradle是用Groovy编写的构建工具，Groovy是JVM衍生的与JAVA语法高度兼容的动态强类型语言。Gradle通过编写一个名为build.g…

AS其实就是Intellij IDEA的安卓开发环境特供版（谷歌定制版），Intellij IDEA是有收费版本的IDE。Ant和Maven都是基于XML的构建工具，Gradle是用Groovy编写的构建工具，Groovy是JVM衍生的与JAVA语法高度兼容的动态强类型语言。Gradle通过编写一个名为build.gradle的脚本文件对项目进行设置，再根据这个脚本对项目进行构建（复杂的项目也有其他文件）Gradle 脚本本质上就是Groovy脚本，只不过高度利用了groovy的语法糖，例如省略方法参数括号和省略句尾分号等，让代码看起来像DSL。所以几乎所有java和groovy支持的语法，它的脚本都支持。（使用JAVA和GROOVY的SDK应该也是没问题的）Gradle支持基于惯例的构建，并有丰富的适合不同情景下的插件库，光有官方用户手册支持的就有20多种，方便构建。Gradle里有两个基本概念：项目(projects)和任务(tasks)。项目由多个任务组成，一个项目可以理解为提供给不同设备的构建版本，如桌面版、网页版、安卓版、iOS版等等，也可以理解为一种行为，例如部署应用到生产环境。任务相当于Ant的target，可以理解成一个构建中原子性的工作，例如编译、打包、执行等。需要注意的是，Ant中他自己的命令例如javac、copy等也叫做task，但Ant的task远没有Gradle的task那么自由。Gradle的构建分两个阶段，第一阶段是设置阶段(configuration phase)，分析构建脚本，处理依赖关系和执行顺序等，脚本本身也需要依赖来完成自身的分析。第二阶段是执行阶段(execution phase)，此阶段真正构建项目并执行项目下的各个任务。Ant与Maven对于Gradle，前者编写容易，但功能有限，需要人工操作的过程也多；后者依托于庞大的依赖仓库，因此有着强大的外部依赖管理，但添加本地依赖并不方便，且项目不能灵活修改。而Gradle能很好地结合Ant与Maven各自的优点，可以随意的编写任务并组合成项目，直接利用Maven仓库，并且能很好的支持传递依赖和内部依赖。（本部分为个人主观意见，可能与大多数人的意见并不相同）（其实也都是别人的个人主观意见，来源于我当初搜索的Gradle相关文章内容）通俗一点类比成吃饭的话，大致就是：Ant是自己买菜洗菜烧水做饭，Maven是去饭店点餐，Gradle是3D打印食物。

你都说了要通俗的理解，那就用不着学习什么理论了，通俗着来就是了。通俗的说：gradle是打包用的。你觉得解决你的问题了吗？如果没解决，那是你的问题提得不够好。比如我猜你应该提：为什么要打包发布，打包发布有几种常见方法，为什么这些常见方法中要选gr…

你都说了要通俗的理解，那就用不着学习什么理论了，通俗着来就是了。通俗的说：gradle是打包用的。你觉得解决你的问题了吗？如果没解决，那是你的问题提得不够好。比如我猜你应该提：为什么要打包发布，打包发布有几种常见方法，为什么这些常见方法中要选gradle，等等。针对我猜的这些内容，通俗的讲是这样的：以在eclipse里面写java程序为例为什么需要打包：最初写完了，直接右键run就可以了。但是程序写完了毕竟是要发布到服务器上或者给别人用的，你第一不可能让所有要运行的人都装个eclipse，第二不可能把源代码公布给所有人。所以你需要把你的代码发布成二进制形式，让其它环境方便运行，这就是打包。为什么用ant打包的时候要做很多事，比如说配置文件中的用户名和密码，你本地开发和程序实际运行时的内容肯定不一致，所以需要有两个文件，开发的时候用一个，实际运行的时候用一个。这样每次打包的时候都要重复的做这些事，ant可以让你用xml的形式把这些事情写成脚本，然后自动运行。为什么用maven你的项目要用很多jar包，比如你写日志要用个log4j吧，连数据库要用个connector吧。这年头写程序不用个spring都不好意思出门，下载下来的spring包打开一看，密密麻麻的好几十个jar，不知道用哪个不用哪个。而且，即便是你一狠心把这些jar包都放进来，很大可能性还是不能运行，因为还要依赖其它的jar包。哪天想升级个spring小版本，所有jar包都要重来一遍，你也不记得哪些是由于spring引进来的jar包了。所以有了maven，你只要配置一下说我要用spring 3，所有jar包都给你下载好了，你直接运行就行了。赶明儿想升级版本，直接把3改成4，新的jar包也给你下载好了。然后？用了maven，jar包是方便了，但我打包的时候还是有好多事要做啊，然后你会发现maven实在是不知道怎么做这些事，于是开始怀念ant。gradle就是又能干maven的活，又能干ant的活，用groove语言写脚本，表达能力还更强。就这意思。===我也是这两天才看了两眼gradle，了解不深。简化版如下：ant可以自动化打包逻辑。maven也可以自动化打包，相比于ant，它多做的事是帮你下载jar包。但是maven的打包逻辑太死板，定制起来太麻烦，不如ant好用。gradle就是又能自动下jar包，又能自己写脚本，并且脚本写起来还比ant好用的这么个东西。

gradle是一个工程构建工具，java代码，和资源文件需要经过sdk里的一些程序如aapt等处理，才能形成apk包。gradle就是把那些步骤变得简单化。相当于eclipse中的ant吧！

一句话概括就是：依赖管理和任务执行。像Ruby里面的bundler+rake,像ios中的cocoapods,像node中的npm+grunt.通俗的讲就是：你的项目需要哪些第三方库，它帮你把它们都下载下来，并且编译好放到指定的位置，你就直接可以import后用了。它本身是基于Apache的an…

一句话概括就是：依赖管理和任务执行。像Ruby里面的bundler+rake,像iOS中的cocoapods,像node中的npm+grunt.通俗的讲就是：你的项目需要哪些第三方库，它帮你把它们都下载下来，并且编译好放到指定的位置，你就直接可以import后用了。它本身是基于Apache的ant和maven的，但都不是特别好用，要引入一个库，还得写好多行的XML，麻烦死了。而且他们在任务执行上都比较弱，所以gradle就逐渐发展壮大了并被Google所推崇了。

 

http://www.cnblogs.com/laughingQing/p/5855774.html