【实战】Android工程gradle详解

版本的统一管理

当我们的工程中有许多module的时候,分开管理编译版本,minsdk将会是一件很麻烦的事,因为一个library的改动,可能会影响到其他module。这时我们就需要对所有的版本进行统一的管理,管理的方式有两种:

rootProject

我们可以把一些需要用的字段都放在project的build.gradle(注意是project的不是module的)中:


这样,在module的build.gradle中可以进行读取:


gradle.properties

找到工程目录下的gradle.properties文件,如果没有也可以自己创建:


然后在各个module的build.gradle中可以引用:


需要注意的是在gradle.properties中声明的格式都是string类型,如果如要转化成int类型,可以用as int 进行强制转化。

程序中对buildTypes的区分

buildTypes是对不同build类型的处理

当你点击运行按钮的时候会根据build Variant进行对应的方式编译。
build Variant可以在这里进行选择:


Paste_Image.png

library的buildTypes

默认情况下被依赖工程会使用release模式,与上层依赖的app工程选择的模式无关
需要在build.gradle中进行设置:


新增buildTypes

你可以在buildTypes,根据需要新增一个类型,如下代码所示:


不同模式字符不同

根据上面的代码,在不同的buildTypes中,TEXT这个变量是不一样的,而且根据代码可以看出,这个变量是一个String类型,那么我们在程序文件中可以这样通过BuildConfig引用:

t2.setText(BuildConfig.TEXT);

Variant

gradle插件允许最终生成的包以多个维度进行组合
例如我们可以设定一下几个维度:


每个维度中可以设置这个版本的最小sdk限制,以及targetsdkversion

假设我们设置的维度有red blue yellow但是结合之前讲过的buildType(假设只有debug和release)
那么将会出现以下构建:
blueDebug和blueRelease
yellowDebug和yellowRelease
redDebug和redRelease
Gradle会为每一个Variant创建一个任务
对应如下:
gradle assembleBlue 会生成debug和release两个版本
gradle assembleDebug 会生成blue yellow red三个版本
gradle assembleBlueDebug 会生成bluedebug一个版本
这里还有一个用处需要提一下:
Gradle在打包android应用之前会将所有的代码,资源文件,包括manifest进行结合,当然library也会提供额外的资源,这些也会进行合并。

字符串读取

如果我们在创建一些设置时,需要动态的去更改内容,可以设置一个变量,然后从本地文件或者打包的命令行读取,我们这里就拿上面提到过的BuildConfig做例子,希望程序中引用的字符串是从本地读取的或从命令行读取的

从本地文件中读取

首先需要在最开始的地方设置一个变量aaa:


Paste_Image.png

然后在buildTypes的debug模式中修改对应的代码:


然后在工程目录下创建一个本地文件test.properties,并添加内容:


Paste_Image.png

然后回到你刚才定义字符串的build.gradle中,添加:


即可读取到你本地文件的字符串

从命令行读取

如果是从命令行读入就更加简单,只需要将上面读取文件的代码改为:

aaa = new String(System.console().readLine("请输入字符串:"))

编译命令

首先想看一个工程包含了多少task,需要切到这个工程目录下:

gradle tasks

会列出所有的tasks:


Paste_Image.png


当然篇幅有限,这里不贴出所有的任务了,我们只需要知道编译命令即可,如图可以看到,如果想编译debug版本,使用:

assembleDebug

其它同理即可。
如果使用build则回编译出所有的版本

冲突问题


Paste_Image.png


在执行打包的时候很有可能会出现如上问题,这是由于依赖的jar冲突问题,我们可以分析一下工程结构。
我现在的结构是:


Paste_Image.png

现在调整一下结构:


Paste_Image.png

把jar以module的形式提供就不会出现冲突。

编译流程



Paste_Image.png

Task任务

执行顺序

例如我们新建一个任务:


他的执行如下:


Paste_Image.png


它并不是在执行任务的时候执行的,而是在执行任务之前就打印了。
这是由于gradle构建有三个阶段:
初始化阶段,配置阶段,执行阶段。
上面的例子实际是打印在了配置阶段,换句话说,你不执行这个任务,执行这个工程别的任务也会打印。
例如我再写一个任务:


这次执行这个任务:


Paste_Image.png


你会发现也打印aaaa这说明这不是在真正的执行阶段执行的,为了保证任务的可控性,可以像上面umengtestaa那样写加一个<<符号
这样就可以保证了任务的可控性:


Paste_Image.png


或者使用:


打包任务

有了上面的基础,下面就可以说一下打包的任务了,根据我们之前的工程,我们有一个app的module和四个library module,我需要打印出一个apk和四个jar,明确了任务,现在可以开始实施了。
打开工程的build.gradle


这时,我们再去找一下工程的build文件夹下可以发现:


Paste_Image.png

打包不同内容的module

打包不同内容的module可以利用之前讲过的variant或这个buildtypes来控制,这里就不说了,不明白的,可以回头再去看一下结合上面的打包脚本没有什么难度,然而还有一种需求,不是某个变量或者包名的更改,而是两个版本中两个文件的不同,我们可以试一下修改variant的方式来实现,在app的build.gradle中:


修改结构目录:


Paste_Image.png


这样编译出来就会有两个不同类型的apk了

防止打包错误

在这里已经说完了所有与打包相关的东西了,在最后仍然加这一个标题是交给大家如何防止项目开发者打包出错,或者上传包出错后定位问题。
方法就是在打包的时候,生成一个记录文件,在这个包中记录打包时间,和当前git的版本号:


以上工程中所用到的所有代码,已经上传github
地址如下:
https://github.com/mymdeep/AndroidGradle
如有对groovy语法不清楚的看官,请看一下我的上一篇文章,groovy基础知识:
//www.greatytc.com/p/b58b254d8f6e



最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,222评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,455评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,720评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,568评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,696评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,879评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,028评论 3 409
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,773评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,220评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,360评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,002评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2 350

推荐阅读更多精彩内容