Android-解放双手之Gradle自动化打包实战(原创)

本文已独家授权 郭霖 ( guolin_blog ) 公众号发布!

前言:

解放双手,双击桌面快捷方式生成apk包,基于Gradle、bat文件让开发人员告别打包烦扰!

前不久有一个Unity3D研发的小仙女在羽毛球场问我关于Android Studio打apk的一些事情,她说他们运营和测试隔三差五的就坐着她旁边要她重复性的打包(估计是那群痴汉打着工作的幌子实际上干着撩妹的活惹火了这位认真敬业的小姐姐),那么有没有省力一点的办法快速打包?

一直以来,对于某些频繁进行打包工作的业务部开发人员来说,打包工作不仅繁琐冗余而且费时费力。如何快速、高效的解决频繁出包以及提高生产效率解放生产力是我们一直在思考的问题。有没有一种办法比如我只想要双击桌面快捷方式然后就打包成APK 接着在保存到自定义盘符路径?  答案是有的。我们知道Android Studio是基于Gradle来进行快速构建项目,Gradle本质是一个基于Apache Ant和Apache Maven概念的项目自动化构建工具。 由于一些论坛上的文章是基于Android2.X版本来进行解释说明但是笔者通过这几天的实战(Android Studio版本是3.0以上)发现网上的一些办法已经用不了且新版本自然而然增加了一些之前未提及的新特性,所以本文主要是针对Android Studio3.0版本以上以及Gradle进行一些基本的内容介绍以及如何通过组合技巧实现快速打包;以及针对某一些特定的开发场景如何通过 Java + Gradle去思考并解决问题)。

PS:文章使用到的源码请见末尾。

首先是笔者个人开发环境:

    JDK:1.8.0_71

    Android Studio:3.0

    PC系统:Win7

由于我们这里是基于Gradle进行后面的操作,所以我们首先需集成下Gradle的环境变量(前提是需要配置好JDK)如何配置Gradle环境?由于Android Studio里面内置了Gradle,这里我就快速提供Gradle环境配置方案(当然也可以自行谷歌或者百度):

1:找到自己Android Studio目录下的gradle文件。这是笔者的Android Studio目录下的gradle文件路径:  C:\Program Files\Android\Android Studio\gradle\gradle-4.1\bin  找到这个目录以后,按照配置JDK那样首先将其编辑到系统变量 GRADLE_HOME

GRADLE_HOME

2:步骤一完成以后将 GRADLE_HOME 添加到系统变量,如下图

添加系统变量

3:上面两个步骤执行完毕以后。我们可以测试下Gradle环境是否安装成功。首先打开cmd命令窗口  输入 gradle (第一次会比较慢)出现以下信息即为成功。或者在命令窗口 输入 gradle -version 如果可以显示版本信息即为环境配置成功

测试环境配置

环境配置好以后,我们先回到Android Studio上面。使用Android Studio新建一个项目的时候,(将工具视图切换成Android 也就是下面的红色矩形)系统会为我们自动生成2个build.gradle文件。

Android Studio生成的gradle

Android开发一般将图上的绿色矩形描述为 项目的gradle,将黄色矩形称为app.gradle。首先我们看下项目的gradle:

Project.gradle

首先,这里的两段英文注释写的非常好,翻译过来就是:( Top-level build file ......)顶级构建文件,可以在所有子项目/模块中添加常见的配置选项;(NOTE: Do not place ......)注意:不要将你的应用程序依赖项放在这里;它们属于单独的模块构建 .gradle文件。

我们知道Project.gradle文件主要是全局的gradle构建脚本,这里的jcenter()、google()代码,表示的是引用托管仓库的名称;这里的classpath主要是申明插件的版本号(这里的版本号就是3.0.0)。总体来说项目的gradle文件是顶层的配置文件,部分依赖使用也会在这里进行对应的配置。

看完了最顶层的gradle文件在来看看app的gradle文件,这个文件是我们经常打交道的地方,配置签名信息,渠道信息,配置各种第三方库以及依赖等等。比如这个文件有我们最大的android { }标签以及配置依赖的dependencies{ }标签。dependencies标签里面就是应用内使用到的各种依赖比如我们的OkHttp、Glide等等;关于android{ }的配置因为内容较多,下面是在网上收集到的该标签内的一些标签资料:

              defaultConfig{ } 默认配置,是ProductFlavor类型。它共享给其他ProductFlavor使用

    sourceSets{ } 源文件目录设置,是AndroidSourceSet类型。

    buildTypes{ } BuildType类型

    signingConfigs{ } 签名配置,SigningConfig类型

    productFlavors{ } 产品风格配置,ProductFlavor类型

    testOptions{ } 测试配置,TestOptions类型

    aaptOptions{ } aapt配置,AaptOptions类型

    lintOptions{ } lint配置,LintOptions类型

    dexOptions{ } dex配置,DexOptions类型

    compileOptions{ } 编译配置,CompileOptions类型

    packagingOptions{ } PackagingOptions类型

    jacoco{ } JacocoExtension类型。 用于设定 jacoco版本

    splits{ } Splits类型

下面就是开始Gradle文件的常用配置:

A:占位符

在使用友盟进行渠道统计常用的做法是 使用占位符,比如我们可以在AndroidManifest.xml文件使用meta-data进行信息的配置。

占位符

然后使用的话,如下图:

占位符使用

B:签名

签名,是android标签内大家经常使用到的,由于Android 7.0加入了新的签名机制(也就是V2签名)针对这个问题的解决方式可以参考这篇文章 Android-V1、V2签名,因此我们可以直接在debug和release标签中加入v1SigningEnabled true 、v2SigningEnabled true 规避使用风险

下面是加入新签名机制以及原来大家比较熟悉的写法:

sign - 1

这里还给大家提供一种关于签名信息的写法(拓展性比第一种较强),首先,我们在app文件的根目录下定义一个文件 signing.properties ,然后写上具体的属性值 (具体的说明如代码截图)

签名配置文件

由于Gradle是一门脚本,既然是脚本那么它肯定内置了一些函数(注意:Gradle的函数是在app gradle文件内置的标签外 进行编写)给我们操作调用。因为将签名信息写到了这里的配置文件,所以可以通过Gradle去读取信息 然后进行赋值,代码如下:

读取签名文件函数

有了读取签名文件的函数,我们就可以进行Alias、password的赋值。

签名函数使用

C:多渠道包配置

Android Studio给我们提供的多渠道打包方案是使用productFlavors标签配置渠道信息,但是新版本下直接使用这个productFlavors标签会报错,工具要求我们在defaultConfig标签下新增flavorDimensions,如果不使用flavorDimensions关键字,编译会报错:

新特性

D:自定义apk输出路径

传统的打包操作流程执行编译以及签名后生成的apk默认是 项目 \build\outputs\apk 这个路径下面,那现在我想指定apk输出的文件位置(比如我现在想让这个apk输出到 c盘下面的out_apk文件夹下)该如何操作?

自定义apk输出路径

其中这里的红色矩形是对上面签名第二种方法的补充说明,这里的buildTypes标签需要写在signingConfigs标签后面,否则很容易编译错误,这个是笔者遇到的问题;蓝色矩形的代码块主要是首先判断是debug还是release版本,如果是release版本就将apk输入到这个指定盘符。

好了,说了这么多gradle文件的配置,下面就开始我们的打包工作。

首先是我们的传统打签名包:

点击Android Studio 顶部Tab , Build  —— Generate Sign Apk 然后出现下面的界面:

传统方式

配置好基本信息以后,点击next,勾选V1、V2等一些配置即可完成签名打包。

第二种:在Android Studio 底部Tab的 Terminal窗口 输入 gradle a 命令本质就是dos操作),来帮助我们打包

gradle a打包

以上两种打包方式都是传统的打包方式,那么有没有更简单的操作?这种简单的操作类似我 在PC上面点击一个快捷方式就给我生成apk包?答案在开头已经说了是有的。

A:首先,我们在项目根目录下创建一个指定的文件夹(用于编译跑脚本用),这个文件一般定义为 .config文件(记住:前面有个 . )

B:然后,在这个文件夹内创建 build.bat文件。可能你会问什么是bat文件?bat文件是dos下的批处理文件。批处理文件是无格式的文本文件,它包含一条或多条命令。当我们双击bat文件的时候,系统就会调用cmd.exe按照该文件中各个命令出现的顺序来逐个运行它们。所以,我们只需要在这个bat文件里面写下相应的命令进行操作即可

C:既然现在我们需要在bat文件里面写命令,那么gradle里面有那些可以执行的打包命令?下面是收集到的一些资料,命令如下:

1:编译所有productFlavor及对应所有buildType的apk:

    gradle assemble  //仅仅执行项目打包所必须的任务集

    gradle build          //执行项目打包所必须的任务集,以及执行自动化测试,所以会较慢

如果当前Project包含多个Module,在Project根目录执行gradle assemble会编译所有的Module

2:编译指定productFlavor及buildType的apk

    gradle assemble[productFlavor][buildType]  //如果缺失某参数,则会把该参数的所有配置都进行编译,即如果运行gradle assembleflavor,则会编译出flavor所有buildType的apk

       例如:

          gradle assemble

          gradle assembleflavorRelease

          gradle assembleflavorDebug

        注意:gradle支持命令缩写,上面两个命令也可以写成如下格式

          $gradle a

          $gradle ass

          $gradle aR

          $gradle assflavorR

          $gradle aD

                    $gradle assflavorD

D:既然dos命令确定了,我们就可以写bat文件进行测试了:

E:接下来我们就可以将这个build.bat文件,设置为桌面快捷方式,然后双击,双击以后会弹出cmd窗口进行打包然后去指定的文件夹拿到apk即可。

以上步骤的前提是你需要配置好Gradle运行环境、熟悉Gradle的基本命令以及必要的耐心和不怕失败的勇气。

一些思考:

既然通过这种方式可以完成快速打包,那我们也可以通过Java的Swing首先写个窗口,然后通过点击去调用相应的bat文件进行后续的操作,也就是一个迷你的小型打包工具(产品和运营可能会觉得,这个工具好厉害哟,那你兼项去做ios吧)。当然也有一些开发人员将这种打包方式集成在别的工具上面。

项目源码

如果这篇文章对您有开发or学习上的些许帮助,希望各位看官留下宝贵的star,谢谢。

Ps:著作权归作者所有,转载请注明作者, 商业转载请联系作者获得授权,非商业转载请注明出处(开头或结尾请添加转载出处,添加原文url地址),文章请勿滥用、开源项目仅供学习交流、也希望大家尊重笔者的劳动成果,谢谢。

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

推荐阅读更多精彩内容