Gradle日常开发技巧总结

Gradle是Android Studio中默认的构建系统。Gradle 采用了 Groovy 语言作为主要的脚本语言。我们app项目的 build.gradle 和APP Moudle里的build.gradle文件,就是一个 Groovy 类。接下来让我就介绍下Gradle的基本功能和高级技巧。

基本用法

apply plugin: 'com.android.application'

android {
    compileSdkVersion 26
    buildToolsVersion "26.0.0"
    defaultConfig {
        applicationId "com.renny.gradletest"
        minSdkVersion 17
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:26.+'
    compile 'com.android.support.constraint:constraint-layout:1.0.2'
    testCompile 'junit:junit:4.12'
}

上面的代码就是刚建好的Android工程时,studio为我们创建的默认Module里的build.gradle ,采用的Gradle版本是2.3.3。而Gradle大部分功能配置也是在个文件里实现的。
apply plugin::用来指定用的是哪个插件,开发中常见的值有

'com.android.application':Android APP插件(打包得到的是.apk文件)
'com.android.library':Android库插件(打包得到的是.aar文件)
'java':普通的java插件(打包得到的是.jar文件)

android{}用来指定Android打包插件的相关属性,其包含如下节点

compileSdkVersion(apiLevel):设置编译时用的Android版本
buildToolsVersion(buildToolsVersionName):设置编译时使用的构建工具的版本
defaultConfig:设置一些默认属性,其可用属性是buildTypes和productFlavors之和。(productFlavors默认文件里没有,会在后面介绍)

buildTypes:配置构建类型,可打出不同类型的包,常见的有debug和release两种,当然你还可以再增加N种

productFlavors:配置不同风格的APP,在buildTypes的基础上还可以让每一个类型的APP拥有不同的风格,所以最终可以打出的APK的数量就是buildTypes乘以productFlavors。构建的变量名称是productFlavors+buildTypes。

QQ截图20170824154702.png

dependencies:配置依赖,这项可定是从eclipse换到studio后感觉最方便的一处了。各种外部依赖直接一行代码搞定,不用手动下依赖包了。
其中compile fileTree(dir: 'libs', include: ['*.jar'])的意思是依赖libs目录下全部的jar文件。

进阶用法

好了,上面的基本配置只是Gradle简单的用法,其实我们可以用Gradle玩出很多花样来。

manifest动态配置

很多第三方SDK需要在AndroidManifest.xml中配置你的一些key信息,以友盟推送为例:

<meta-data 
android:value="YOUR_APP_KEY" 
android:name="UMENG_APPKEY"/>

但是你不同测试包和正式包的key是不同的,那么就可以这么修改:

<meta-data
    android:name="UMENG_APPKEY"
    android:value="${UMENG_APPKEY}" />

然后在productFlavors中的各个版本中加上不同的信息,这样你打出的不同包采用的appkey也会不一样。

 manifestPlaceholders = [UMENG_CHANNEL: "0",
                UMENG_APPKEY : "123456789"]

不仅这些自定义元数据可以动态配置,android:iconandroid:label这些标签也可以修改,这样打出的不同包就有不同的图标了,方便做区分

Moudle动态依赖

在组件化app里面,我们可能在测试包和正式包需要依赖不同组件。比如测试环境需要调试模块,但正式环境不需要。假如productFlavors如下,调试模块名字为module-test

productFlavors {
    ceshi{
    }
    publish{
    }
}

那么在dependencies里面就可以这么依赖test模块:

 ceshiCompile project(':module-test')

同样buildTypes也是适用的,两者可以一起或单独使用:

 debugCompile project(':module-test')
 ceshidebugCompile project(':module-test')

代码中读取变量

上面的这些功能都是gradle单独配置的,但我们往往针对不同的构建包有不同的需要在代码中体现的需求:日志打印,Toast等等。
虽然BuildConfig.DEBUG字段就可以判断,但我们可以用buildConfigField向代码中传递自定义的值,比如不同构建包需要不同Host开头的api地址,不同的https证书路径等,用法为:

buildConfigField 'type', 'name', '"vaule"'

比如:

 defaultConfig {
   buildConfigField 'String', 'author', '"renny"'
}
QQ截图20170824164629.png

上面的是加在defaultConfig 中的,而加在buildTypes或productFlavors中就会在不同构建版本出现不同的值。如果再配置上不同的applicationId,那么就可以在同一个手机上同时安装不同构建版本的应用。

productFlavors {
    ceshi{
        applicationId "com.renny.test"
       buildConfigField "String", "API_TEST", "http://test.renny.com/android"
   }
    publish{
        applicationId "com.example.publish"
      buildConfigField "String", "API_PUBLISH", "http://publish.renny.com/android"
   }
}

经过上面的介绍,你可能会发现buildTypes和productFlavors定义很相似,不过他们的差别在于改变 buildType 不会改变应用程序的代码,它们只是处理的东西不同,你可以通过 buildType 来获取更多的技术细节(例如:build optimization,log level 等等),但是app的内容不会改变,相反的,使用productFlavor 配置可以改变app的内容(ps:内容可以设想成 package 理解,buildType 没法改 applicationId)。

Gradle task

Gradle task适合用来完成一些既繁琐又容易出错的重复性手工作,比如批量修改,复制,重命名文件。
比如applicationVariants.all这个task可以针对每个构建版本设置各种属性,比如修改每个构建版本生成的apk名字:

   applicationVariants.all { variant ->
        variant.outputs.each { output ->
            output.outputFile = new File(
                    output.outputFile.parent,
                    ("app-${variant.buildType.name}"+"-" + new Date().format('yyyyMMdd') + ".apk").toLowerCase())
        }
    }
QQ截图20170825120317.png

gradle会默认匹配生成每种productFlavors*buildTypes的构建版本,如果你想跳过其中的几种就可以这么做:

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,333评论 25 707
  • 转载注明出处:http://www.jianshu.com/p/5255b100930e 0. 前言 完全由个人翻...
    王三的猫阿德阅读 2,498评论 0 4
  • 1.介绍 如果你正在查阅build.gradle文件的所有可选项,请点击这里进行查阅:DSL参考 1.1新构建系统...
    Chuckiefan阅读 12,111评论 8 72
  • Gradle对于很多开发者来说有一种既熟悉又陌生的感觉,他是离我们那么近,以至于我每天做项目都需要他,但是他又是离...
    阿_希爸阅读 9,561评论 10 199
  • 赖着离阳春三月还有闲暇时间,我仍可以矫情的公开自己28岁的芳龄! 28岁的自己,虽已为人师、为人妻、为人母,但...
    梦小嘟阅读 370评论 0 4