给 Android 初学者的 Gradle 知识普及

转载自:StormZhang个人网站。

http://stormzhang.com/android/2016/07/02/gradle-for-android-beginners/

PPPS:对于基础使用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 的,感兴趣的不妨看这里去阅读拓展下:

http://stormzhang.com/devtools/2015/06/17/android-studio-all/

时间: 2024-10-18 18:06:12

给 Android 初学者的 Gradle 知识普及的相关文章

android studio学习----gradle基础

Gradle是一种依赖管理工具,基于Groovy语言,面向Java应用为主,它抛弃了基于XML的各种繁琐配置,取而代之的是一种基于Groovy的内部领域特定(DSL)语言. 安装Gradle 在Android Studio系列教程一--下载与安装中新建项目成功后会下载Gradle,貌似这个过程不FQ也是可以下载,但是访问特别慢,建议FQ下载.那么下载的Gradle到什么地方呢? Mac上会默认下载到 /Users/<用户名>/.gradle/wrapper/dists 目录 Win平台会默认下

Android Studio之Gradle文件解析

本文转载自stormzhang的博客 什么是Gradle? Gradle是一种依赖管理工具,基于Groovy语言,面向Java应用为主,它抛弃了基于XML的各种繁琐配置,取而代之的是一种基于Groovy的内部领域特定(DSL)语言. Gradle 基本概念 下面就以我的开源项目 9GAG 来详细讲解下和Gradle相关的知识, 和Gradle相关的几个文件一般有如下几个: 红色标记部分从上到下咱们来一步步分析: 1. 9GAG/app/build.gradle 这个文件是app文件夹下这个Mod

Android Studio之gradle的配置与介绍

1.gradle的简单介绍 Gradle是可以用于Android开发的新一代的Build System,也是Android Studio默认的build工具.其实Gradle脚本是基于一种JVM语言- Groovy,再加上DSL组成的.由于Groovy是JVM语言,所以可以使用大部分的Java语言库.所谓DSL就是专门针对Android开发的插件,比如标准Gradle之外的一些新的方法(Method).闭包(Closure)等等.通过我们简单的了解知道Gradle的语法足够简洁和简单,而且可以使

com.android.tools.build:gradle:X.XX.XX:gradle.jar

在使用Android Studio 这个IDE时,出现com.android.tools.build:gradle:X.XX.XX:gradle.jar 插件无法下载问题 可能的原因就是网速不好或者依赖仓库的下载网址被墙了,可以配置代理试试.比如,android studio 定义的默人依赖仓库为jcenter()仓库.如下 打开项目下的 build.gradle文件,不是Module下 allprojects { repositories { jcenter() } } 网上搜索到一些方法如下

Error:Could not find com.android.tools.build:gradle:2.14.1.

你只要一步把Android Plugin Version改为最新的:2.2.0-beta3(这是目前最新的).直接在Project Structru->Project->Android Plugin Version 中改了就好! 查看最新的Android Plugin Version:https://jcenter.bintray.com/com/android/tools/build/gradle/ 查看最新的Gradle:Gradle Distributions.

【Android Studio】Gradle DSL method not found:&#39;android()&#39;

如图所示: 参考:http://www.jianshu.com/p/d370d41fb7da 又遇到了这个问题: 参考:http://stackoverflow.com/questions/24204436/error1-0-plugin-with-id-android-not-found 然后是这个问题: 我也是醉了…… [Android Studio]Gradle DSL method not found:'android()'

PMP认证知识普及:PMP考试介绍

1 PMP简介 PMP(Project Management Professional)指项目管理专业人士(人事)资格认证.美国项目管理协会(PMI)举办的项目管理专业人员(PMP)认证考试在全球190多个国家和地区推广,是目前项目管理领域含金量最高的认证.获取PMP证书,不仅提升项目经理的项目管理水平,也直接体现项目经理的个人竞争力,是项目管理专业人士身份的象征. 国内自1999年开始推行PMP认证,由国际监考机构普尔文进行监考及考试组织! PMP作为项目管理资格认证考试,已在国际上树立了其权

PMP认证知识普及:PMP认证有哪些价值?

一.目前拥有PMP较多的公司 1.跨国公司(只罗列部分公司,排名不分先后)IBM . Microsoft .Oracle Corp . SAP.GE . Siemens .KPMG .DELL.Hewlett Packard . EDS . ATT .Accenture .Blue Cross Blue Shield  .SAIC .NOKIA.Alcatel/Lucent .Computer Sciences Corp .Ericsson .Satyam Computer Services .

PMP认证知识普及:PMBOK中主要讲解哪些内容?

目前PMP考试是以美国项目管理协会编写的<项目管理知识体系指南 >PMBOK2012版本为依据,教材主要内容框架如下: 领域 启动过程组 规划过程组 执行过程组 监控过程组 收尾过程组 项目整合管理 4.1制定项目章程 4.2 制定项目管理计划 4.3指导与管理项目工作 4.4监控项目工作 4.6结束项目或阶段 4.5实施整体变更 项目范围管理 5.1 规划范围管理 5.5确认范围 5.2收集需求 5.6控制范围 5.3 定义范围 5.4创建WBS 项目进度管理 6.1 规划进度管理 6.7控