Android之项目中如何用好构建神器Gradle?
Gradle虽为构建神器,但感觉学习曲线比较陡峭。Gradle User Guide内容很多,但有点太多了,多的你看不完,Gradle Plugin User Guide一篇文章主要讲了Android相关的配置,看完可能感觉马马虎虎会用,但到了修改一些构建流程的时候还是不知所措。经过一段时间的摸索,我觉得在Android项目中用好Gradle,你要做到以下三点:
- 了解
Groovy
基本语法。 - 粗读
Gradle User Guide
和Gradle Plugin User Guide
。 - 实战,实战,再实战。(三遍,你懂的)
涉及到的知识点和内容比较多,我不会一一讲解,本文主要会解答自己学习过程中的一些疑问,讲解一些相关概念和实战经验,过程中也会推荐一些有质量的博客文章。
Groovy语言
Gradle基于Groovy语言,虽然接触Gradle比较久,甚至写过一点Groovy语句,但对语言本身并不了解。为什么用Groovy呢?Groovy运行在JVM上,在Java语言的基础上,借鉴了脚本语言的诸多特性,相比Java代码量更少,Groovy兼容Java,可以使用Groovy和Java混合编程,可以直接使用各种Java类库。
Groovy语法的学习,推荐官方文章Differences with Java和IBM developerWorks的精通Groovy。了解了基本语法,对读写gradle脚本都会有帮助,比如随便举下面几个例子:
比如为何在gradle脚本中使用InputStream不用import包,而使用ZipFile需要import包?因为groovy默认import了下面的包和类,无需再import.
java.io.* java.lang.* java.math.BigDecimal java.math.BigInteger java.net.* java.util.* groovy.lang.* groovy.util.*
2、经常看到${var1}的用法是怎么回事? 这是Groovy中的GString,可以在双引号中直接使用,用于字符串叠加非常方便。
def dx = tasks.findByName("dex${variant.name.capitalize()}")
下面的代码你真的能看懂吗?
//apply是一个方法,plugin是参数,值为'com.android.application' apply plugin: 'com.android.application'/** *buildscript,repositories和dependencies本身是方法名。 *后面跟的大括号部分,都是一个闭包,作为方法的参数。 *闭包可以简单的理解为一个代码块或方法指针。 */ buildscript {repositories {jcenter()}dependencies {classpath 'com.android.tools.build:gradle:1.2.3'} }//groovy遍历的一种写法 each后面是闭包 android.applicationVariants.each { variant -> }
Gradle概念
下面讲几个Gradle相关的概念,几个比较重要的吧,更多的东西还是要自己去看Gradle User Guide
。
生命周期
Gradle构建系统有自己的生命周期,初始化、配置和运行三个阶段。
- 初始化阶段,会去读取根工程中setting.gradle中的include信息,决定有哪几个工程加入构建,创建project实例,比如下面有三个工程:
include ':app', ':lib1', ':lib2'
- 配置阶段,会去执行所有工程的build.gradle脚本,配置project对象,一个对象由多个任务组成,此阶段也会去创建、配置task及相关信息。
- 运行阶段,根据gradle命令传递过来的task名称,执行相关依赖任务。
任务创建
很多文章都会告诉你,任务创建要这样:
task hello {doLast {println "hello"} }
或者用<<
替换doLast,那我就很纳闷,定义个任务怎么这么麻烦,还要加什么doLast,我直接这样不行吗?
task hello {println "hello" }
上面的这种写法,“hello” 是在gradle的配置阶段打印出来的,而前面的写法是在gradle的运行阶段打印出来的,所以怎么写要看你的需求了。
另外task中有一个action list,task运行时会顺序执行action list中的action,doLast或者doFirst后面跟的闭包就是一个action,doLast是把action插入到list的最后面,而doFirst是把action插入到list的最前面。
任务依赖
当我们在Android工程中执行./gradlew build的时候,会有很多任务运行,因为build任务依赖了很多任务,要先执行依赖任务才能运行当前任务。任务依赖主要使用dependsOn方法,如下所示:
task A << {println 'Hello from A'} task B << {println 'Hello from B'} task C << {println 'Hello from C'} B.dependsOn A C.dependsOn B
了解更多,可以看一下侦跃翻译的Gradle tip #3-Task顺序。
增量构建
你在执行gradle命令的时候,是不是经常看到有些任务后面跟着[UP-TO-DATE],这是怎么回事?
在Gradle中,每一个task都有inputs和outputs,如果在执行一个Task时,如果它的输入和输出与前一次执行时没有发生变化,那么Gradle便会认为该Task是最新的,因此Gradle将不予执行,这就是增量构建的概念。
一个task的inputs和outputs可以是一个或多个文件,可以是文件夹,还可以是project的某个property,甚至可以是某个闭包所定义的条件。自定义task默认每次执行,但通过指定inputs和outputs,可以达到增量构建的效果。
依赖传递
Gradle默认支持传递性依赖,比如当前工程依赖包A,包A依赖包B,那么当前工程会自动依赖包B。同时,Gradle支持排除和关闭依赖性传递。
之前引入远程AAR,一般会这样写:
compile 'com.somepackage:LIBRARY_NAME:1.0.0@aar'
上面的写法会关闭依赖性传递,所以有时候可能就会出问题,为什么呢?本来以为@aar是指定下载的格式,但其实不然,远程仓库文件下载格式应该是由pom文件中packaging属性决定的,@符号的真正作用是Artifact only notation,也就是只下载文件本身,不下载依赖,相当于变相的关闭了依赖传递,可以看一下sf的这个问题,通过添加transitive=true可以解决。但其实如果远程仓库有pom文件存在,compile后面根本不需要加"@aar",也就不会遇到这个问题了。
Android Gradle实战
下面讲讲在Android Gradle实战中遇到的一些问题和经验,感觉还是蛮多干货的。
productFlavors
这个东西基本上已经烂大街了,gradle的项目一般都会使用Product Flavor,看完美团的文章,你应该就懂了。
美团Android自动化之旅—适配渠道包
buildTypes
很多App有内测版和正式版,怎么让他们同时安装在一个手机上?同时安装在一个手机上,要求packageName不同的,用productFlavors可以解决,但可能不够优雅,alpha版本还要来个debug和release版本岂不是很蛋疼?可以用buildTypes来解决,淘宝资深架构师朱鸿的文章有比较详细的讲解,但有些内容可能有些过时了,需要更改脚本。
依赖更新
项目依赖的远程包如果有更新,会有提醒或者自动更新吗? 不会的,需要你手动设置changing标记为true,这样gradle会每24小时检查更新,通过更改resolutionStrategy可以修改检查周期。
configurations.all {// check for updates every buildresolutionStrategy.cacheChangingModulesFor 0, 'seconds' } dependencies {compile group: "group", name: "projectA", version: "1.1-SNAPSHOT", changing: true }
之前上传aar同一版本到maven仓库,但依赖却没有更新,该怎么办呢?可以直接删除本地缓存,缓存在~/.gradle/caches
目录下,删除缓存后,下次运行就会自动重新下载远程依赖了。
上传aar到Maven仓库
在工程的build.gradle中添加如下脚本:
apply plugin: 'maven' uploadArchives {repositories {mavenDeployer {pom.groupId = GROUP_IDpom.artifactId = ARTIFACT_IDpom.version = VERSIONrepository(url: RELEASE_REPOSITORY_URL) {authentication(userName: USERNAME, password: PASSWORD)}}} }
在build.gradle同目录下添加gradle.properties文件,配置如下:
GROUP_ID=dianping.android.nova.thirdparty ARTIFACT_ID=zxing VERSION=1.0 RELEASE_REPOSITORY_URL=http://mvn.dp.com/nova USERNAME=hello PASSWORD=hello
gradle.properties的属性会被build.gradle读取用来上传aar,最后执行./gradlew :Zxing:uploadArchives
即可。
更多配置,可参考建立企业内部maven服务器并使用Android Studio发布公共项目。
取消任务
项目构建过程中那么多任务,有些test相关的任务可能根本不需要,可以直接关掉,在build.gradle中加入如下脚本:
tasks.whenTaskAdded { task ->if (task.name.contains('AndroidTest')) {task.enabled = false} }
tasks会获取当前project中所有的task,enabled属性控制任务开关,whenTaskAdded后面的闭包会在gradle配置阶段完成。
加入任务
任务可以取消了,但还不尽兴啊,想加入任务怎么搞?前面讲了dependsOn的方法,那就拿过来用啊,但是原有任务的依赖关系你又不是很清楚,甚至任务名称都不知道,怎么搞?
比如我想在执行dex打包之前,加入一个hello任务,可以这么写:
afterEvaluate {android.applicationVariants.each { variant ->def dx = tasks.findByName("dex${variant.name.capitalize()}")def hello = "hello${variant.name.capitalize()}"task(hello) << {println "hello"}tasks.findByName(hello).dependsOn dx.taskDependencies.getDependencies(dx)dx.dependsOn tasks.findByName(hello)} }
afterEvaluate是什么鸟?你可以理解为在配置阶段要结束,项目评估完会走到这一步。
variant呢?variant = productFlavors+ buildTypes,所以dex打包的任务可能就是dexCommonDebug。
你怎么知道dex任务的具体名称?Android Studio中的Gradle Console在执行gradle任务的时候会有输出,可以仔细观察一下。
hello任务定义的这么复杂干啥?我直接就叫hello不行吗?不行,each就是遍历variants,如果每个都叫hello,多个variant都一样,岂不是傻傻分不清楚,加上variant的name做后缀,才有任务的区分。
关键来了,dx.taskDependencies.getDependencies(dx)会获取dx任务的所有依赖,让hello任务依赖dx任务的所有依赖,再让dx任务依赖hello任务,这样就可以加入某个任务到构建流程了,是不是感觉非常灵活。
我突然想到,用doFirst的方式加入一个action到dx任务中,应该也可以达到上面效果。
gradle加速
gradle加速可以看看这位朋友写的加速Android Studio/Gradle构建,我就不多嘴了。并行编译,常驻内存,还有离线模式这些思路对gradle的加速感觉还是比较有限。
想要更快,可以尝试下Facebook出品的Buck,可以看一下Vine团队适配Buck的技术文章,我们的架构师也有适配Buck,加速效果在10倍左右,但有两个缺点,不支持Windows系统,不支持远程依赖。
任务监听
你想知道每个执行任务的运行时间吗?你想知道每个执行任务都是干嘛的吗?把下面这段脚本加入build.gradle中即可:
class TimingsListener implements TaskExecutionListener, BuildListener {private Clock clockprivate timings = []@Overridevoid beforeExecute(Task task) {clock = new org.gradle.util.Clock()}@Overridevoid afterExecute(Task task, TaskState taskState) {def ms = clock.timeInMstimings.add([ms, task.path])task.project.logger.warn "${task.path} took ${ms}ms"}@Overridevoid buildFinished(BuildResult result) {println "Task timings:"for (timing in timings) {if (timing[0] >= 50) {printf "%7sms %s\n", timing}}}@Overridevoid buildStarted(Gradle gradle) {}@Overridevoid projectsEvaluated(Gradle gradle) {}@Overridevoid projectsLoaded(Gradle gradle) {}@Overridevoid settingsEvaluated(Settings settings) {} }gradle.addListener new TimingsListener()
上面是对每个任务计时的一个例子,想要了解每个任务的作用,你可以修改上面的脚本,打印出每个任务的inputs和outputs。比如assembleDebug那么多依赖任务,每个都是干什么的,一会compile,一会generate,有什么区别?看到每个task的输入输出,就可以大体看出它的作用。如果对assemble的每个任务监听,你会发现改一行代码build的时间主要花费在了dex上,buck牛逼的地方就是对这个地方进行了优化,大大减少了增量编译运行的时间。
buildscript方法
Android项目中,根工程默认的build.gradle应该是这样的:
// Top-level build file where you can add configuration options common to all sub-projects/modules.buildscript {repositories {jcenter()}dependencies {classpath 'com.android.tools.build:gradle:1.2.3'} }allprojects {repositories {jcenter()} }
一会一个jcenter()这是在干什么?buildscript方法的作用是配置脚本的依赖,而我们平常用的compile是配置project的依赖。repositories的意思就是需要包的时候到哥这里来找,然后你以为com.android.tools.build:gradle:1.2.3
会从jcenter那里下载了是吧,图样图森破,不信加入下面这段脚本看看输出:
buildscript {repositories {jcenter()}repositories.each {println it.getUrl()}dependencies {classpath 'com.android.tools.build:gradle:1.2.3'} }
结果是这样的:
file:/Applications/Android%20Studio.app/Contents/gradle/m2repository/ https://jcenter.bintray.com/
我靠,仓库竟然直接在Android Studio应用内部,所以说你去掉buildscript的jcenter()完全没有关系啊,下面还有更爽的,我们知道有依赖传递,上面classpath 中的gradle
依赖gradle-core
,gradle-core
依赖lint
,lint
依赖lint-checks
,lint-checks
最后依赖到了asm
,并且这个根目录中的依赖配置会传到所有工程的配置文件,所以如果你要引用asm相关的类,不用设置classpath,直接import就可以了。你怎么知道前面的依赖关系的?看上面m2repository目录中对应的pom文件就可以了。
为什么讲到ASM呢?ASM又是个比较刁的东西,可以直接用来操纵Java字节码,达到动态更改class文件的效果。可以用ASM面向切面编程,达到解耦效果。Android DEX自动拆包及动态加载简介中提到的class依赖分析和R常量替换的脚本都可以用ASM来搞。
引入脚本
脚本写多了,都挤在一个build.gradle里也不好,人长大了总要自己出去住,那可以把部分脚本抽出去吗?当然可以,新建一个other.gradle把脚本抽离,然后在build.gradle中添加apply from 'other.gradle'
即可,抽出去以后你会发现本来可以直接import的asm包找不到了,怎么回事?根工程中配置的buildscript会传递到所有工程,但只会传到build.gradle脚本中,其他脚本可不管,所以你要在other.gradle中重新配置buildscript,并且other.gradle中的repositories不再包含m2repository目录,自己配置jcenter()又会导致依赖重新下载到~/.gradle/caches
目录。如果不想额外下载,也可以在other.gradle中这么搞:
buildscript {repositories {maven {url rootProject.buildscript.repositories[0].getUrl()}}dependencies {classpath 'com.android.tools.build:gradle:1.2.3'} }
获取AndroidManifest文件
ApplicationId versus PackageName提到,gradle中的applicationid用来区分应用,manifest中packageName用来指定R文件包名,并且各个productFlavor 的manifest中的packageName应该一致。applicationid只是gradle脚本中的定义,其实最后生成的apk中的manifest文件的packageName还是会被applicationid替换掉。
那获取R文件的包名怎么搞?要获取AndroidManifest中package属性,并且这个manifest要是起始的文件,因为最终文件中的package属性会被applicationid冲掉,由于各个manifest中的package属性一样,并且非主manifest可以没有package属性,所以只有获取主manifest的package属性才是最准确的。
def manifestFile = android.sourceSets.main.manifest.srcFile def packageName = new XmlParser().parse(manifestFile).attribute('package')
Android之项目中如何用好构建神器Gradle?相关推荐
- Android项目中如何用好构建神器Gradle?
摘要:本文作者贾吉鑫为大众点评Android工程师,在进行团队并行开发时,分库遇到的问题很多都要通过Gradle脚本解决.Gradle虽为构建神器,但学习曲线比较陡峭,要想在Android项目中用好G ...
- Android:Android NDK项目中C++文件中打印日志
Android NDK项目中C++文件中打印日志 工作需要,在NDK项目中的C++文件中打印日志,还是费了点劲查找 才达到自己 想要的效果了. 步骤 添加头文件 添加头文件 定义宏函数 #includ ...
- android 不同项目代码合并在一块,android - 是否可以将两个(正在积极开发中的)Android应用程序模块合并到同一个Android Studio项目中? - 堆栈内存溢出...
我有两个工作正常的Android应用程序模块A和B,与同一个Android Studio项目相同. 它们每个都可以单独构建和运行. 但是如果我通过指定将模块A添加为"模块依赖项" ...
- android导入库项目,如何在android studio项目中导入开源库?
导入Jar文件 这种可能很常见,可以下载到别人搞好的jar包,这样可以直接在自己的主module下创建libs文件夹(我这里这样,只是为了兼容eclipse方式),然后把jar文件放进去,然后在mod ...
- android内嵌套cocos2dx,Cocos2dx项目嵌入到Android原生项目中
最近开始有一些需求.非常像游戏.互动特别的强.现在的版本有人用native来实现的. 可是需求越来越多.用native真的是心累.而且体验生硬.故打算在app里嵌入Cocos2dx 首先需要安装And ...
- android studio 自动提示jni代码,如何将JNI(C/C++本机代码)添加到现有的Android Studio项目中...
从现有项目中执行以下步骤: 1.修改build.gradle(模块应用程序)看起来像这样(很多变化!): apply plugin: 'com.android.model.application' m ...
- MVP模式在Android实际项目中的应用和优化
注:本文阅读需要对MVP模式有基本了解. MVP模式已经出现有很长一段时间了,但是火起来是这两年的事情. 关于MVP的概览,介绍,乃至于教程,Demo,实例,网上都有很多,我也有一篇文章专门收录了一些 ...
- android项目中有哪几种依赖关系,Android Studio项目中三种依赖的添加方式
通常一个AS项目中的依赖关系有三种,一是本地依赖(主要是对本地的jar包),二是模块依赖,三是远程依赖:添加这些依赖的目的在于上我们想要在项目的某一个模块中使用其中的功能,比如okttp这个网络框架库 ...
- 如何在安卓(Android studio)项目中导入模块、jar包、和aar包
安卓(Android studio)编程中,我们常需要引用"别人写的功能",以扩展app的功能,"别人写的功能"主要有模块.jar包.和aar包三种方式. 下面 ...
最新文章
- 【翻译】Ext JS最新技巧——2014-8-13
- 中芯高层震荡未停:蒋尚义离职,梁孟松退出董事会,「台积电灵魂」加盟不足一年...
- zabbix 监控mysql5.7_使用zabbix对mysql5.7主从进行监控
- 请求接口返回的是一个html_搜狗美图 API 接口请求调用
- GDCM:DataElementValue作为SQ的测试程序
- 编写自己的Arduino库
- offline .net3.5
- 指针系统学习5-对使用字符指针变量和字符数组的讨论
- 【springBoot】springBoot返回json的一个问题
- Fiddler之文件代理
- python 金融可视化_Python数据分析:金融数据可视化
- docker 删除镜像
- csdner: china_jeffery, C++默认构造函数; csdner: thief thief, 什么情况下C++编译器会生成默认的构造函数
- DRM GEM 驱动程序开发(dumb)
- 全国大学生“高教杯“成图大赛:关于齿轮的快速建模研究
- @Autowired vs @PersistenceContext for EntityManager bean
- CentOS7.2时间不正确
- 360网站卫士推出免费风云加速
- 虚拟机ubuntu主机板子三者ping通
- 微电子电路——反相器网表详解
热门文章
- 阿星Plus:基于abp vNext开源一个博客网站
- 回顾 | 进击吧! Blazor !第三期 信息交互
- 5种避免C#.NET中因事件造成内存泄漏的技术
- 【译】Visual Studio 2019 中 WPF UWP 的 XAML 开发工具新特性
- .NET Conf 2019日程(北京时间)
- asp.net core系列 71 Web架构分层指南
- 书籍推荐:《More Effective C#》
- 从阿里中台战略看企业IT架构转型之道(下)
- 【深圳(活动)】70多场干货分享!价值899元的2018中国开源年会门票等你认领
- 深刻理解:C#中的委托、事件