【Gradle】简单又实用的Gradle小技巧

一直听说Gradle神乎其神,但奈何才疏学浅无法领悟其精髓。

昨天忙里偷闲扒了几篇大神博客,有点想法总结一下。

心急的同学可以直接拉到最后一个大标题 ** 一些技巧 ** ヾ(≧O≦)〃嗷~


Gradle?

大概来说,这货就是一个自动化构建工具,跟ant差不多,如果没有它的话,编译android会是件很麻烦的事情。

如果你用的是AS,那么他会帮你自动安装,不用自己操心。

在使用AS建立 Android 项目的时候,会自动帮你生成Gradle文件,简单的项目其实可以忽略这东西的存在。

图1.png

如图1所示,Progect在Android视图,每次我们新建项目的时候,会出现这三个Gradle文件,第一个是全局Gradle文件,一般不做修改,第三个是告诉编译器需要编译哪些模块,一般在Module Setting里修改之后自动更改。我们重点关注下第二个,也就是我们自己模块的Gradle文件。

ps:集成codetags的时候,官方文档要求修改全局gradle文件,我不知道这么做的必要性是什么。


几个常见配置

如果整个项目就只有一个module,那么这个Gradle文件就是最重要的一个,他关系到我们整个app的编译过程,以下是我们项目这个文件的大概样子


// 使用插件 声明是Android程序
apply plugin: 'com.android.application'

android {
    // 编译SDK的版本
    compileSdkVersion 25
    // build tools的版本
    buildToolsVersion "24.0.3"

    defaultConfig {
        // 应用包名
        applicationId "com.zx.myapplication"
        // 最小支持的sdk版本
        minSdkVersion 23
        // 目标sdk版本
        targetSdkVersion 25
        // 版本号
        versionCode 1
        // 版本名称
        versionName "1.0"
    }
    // 签名信息
    signingConfigs {
        release {
            storeFile file('D:/Java/test/test.jks')
            storePassword "test"
            keyAlias "test"
            keyPassword "test"
        }
        debug {

        }
    }

    buildTypes {
        release {
            // app名称替换
            manifestPlaceholders = [app_name:"@string/app_name"]
            //构建 release 使用 release签名
            signingConfig signingConfigs.release
            // 是否进行混淆
            minifyEnabled false
            // 混淆文件的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            // 自动判断是测试环境还是生产环境
            buildConfigField("boolean", "isRelease", "true")
        }
        debug {
            // app名称替换
            manifestPlaceholders = [app_name:"@string/app_name_debug"]
            //构建 debug 使用 debug 签名
            signingConfig signingConfigs.debug

            // 自动判断是测试环境还是生产环境
            buildConfigField("boolean", "isRelease", "false")
        }

        userdebug {
            // app名称替换
            manifestPlaceholders = [app_name:"@string/app_name_userdebug"]
            //构建 userdebug 使用 release 签名
            signingConfig signingConfigs.release
            
            // 保留debug信息
            debuggable true 
            // 自动判断是测试环境还是生产环境
            buildConfigField("boolean", "isRelease", "false")
        }
    }

    // 各种渠道,可以做一些多渠道区分
    productFlavors {
    qihu {

    }
    tengxun {

    }
}

    // 移除lint检查的error
    lintOptions {
        disable "ResourceType"
    }
}

// 依赖信息
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:25.1.0'
    testCompile 'junit:junit:4.12'
}

清单文件中被替换的部分长这个样子


<application
      ...
      android:label="${app_name}"
      ...

      <activity
      ...
      </activity>
<application

这是一个gradle文件的例子,有详细注释。

图2,通过AS更改Gradle文件.jpg

当然,gradle文件也可以通过图二几个选项快速更改。

但是需要强调的是 ** buildTypes ** 节点。
AS项目在新建之初,在Gradle文件中,buildTypes节点下会默认生成一个release节点,方便用户配置正式版本的编译信息,此时debug虽然没有写出来,但它也是默认存在的,去图三的位置可以看到存在两个节点。
在当前例子中可以注意到,我在buildTypes中配置了三个节点,release,debug,userdebug。这三个节点分别代表了不同的构建版本,发布版,测试版以及用户测试版。
而 ** productFlavors ** 节点,用来配置多渠道信息,两个节点相加,就是 BuildVariants(构建变种版本)。
点击图2中的 ** select build variant ** 选项,在 如图3 弹出窗口选择后,可以直接通过 绿色箭头,Run 'app' 得到相应版本,或者在构建签名版本的时候,在Build->Generate Signed APK,填写签名信息之后,也可以看到Flavors多了我们添加的渠道。

图3-构建变种版本.png

一些技巧

  1. 在 ** buildTypes ** 的三个节点中,都有两句代码:
buildConfigField("boolean", "isRelease", "false") 

signingConfig signingConfigs.release

第一句话的作用是在构建不同版本的时候(release/debug/userdebug),自动生成一个类型为 boolean ,变量名为 isRelease 的变量,然后在项目任意位置,可以通过 BuildConfig.isRelease 取得这个值。我会通过这个值来判断访问测试接口还是正式接口。
另外,上述判断版本也可以用其他字段实现,详见自己项目中的BuildConfig.class文件。
第二句话的作用是在构建不同版本的时候(release/debug/userdebug),使用不同的签名,比如测试签名无法调起 微信分享,必须使用正式签名。
在我的配置中,有一个 ** userdebug ** 节点,使用测试接口以及正式签名,这样就可以在测试环境下,调起微信分享。生产环境的时候使用 ** release ** 节点,可以防止由于疏忽把测试数据带入生产环境。

  1. 自定义build type节点,如** userdebug ** 节点如果需要打印输出信息,必须配置

userdebug {
        ...
        // 保留debug信息
        debuggable true 
}

debug和release为默认节点,无需配置。

  1. 如果想让测试环境的APP跟生产环境的APP同时安装在手机上,可以使用

debug {
        ...
        applicationIdSuffix ".debug"
}

这样可以改变debug包的ApplicationId,这句话的作用是在原有ApplicationId后面追加一个.debug,来达到区分APP的作用。
PS: 但是这么做的代价是依赖ApplicationId做唯一标识的三方库会无法使用,例如微信分享。在三方库管理平台上添加一次应用即可解决,添加的应用ApplicationId为 完整包名.debug


特别感谢 stormzhang 大神,看他的博客收获良多。


个人理解,难免有错误纰漏,欢迎指正。转载请注明出处。

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

推荐阅读更多精彩内容

  • 转载注明出处:http://www.jianshu.com/p/5255b100930e 0. 前言 完全由个人翻...
    王三的猫阿德阅读 2,506评论 0 4
  • 1.介绍 如果你正在查阅build.gradle文件的所有可选项,请点击这里进行查阅:DSL参考 1.1新构建系统...
    Chuckiefan阅读 12,122评论 8 72
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,637评论 18 139
  • Gradle对于很多开发者来说有一种既熟悉又陌生的感觉,他是离我们那么近,以至于我每天做项目都需要他,但是他又是离...
    阿_希爸阅读 9,574评论 10 199
  • 今天是二月十四,据说是情人节。因是情人,再而为侣,有情有侣,简称"情侣"。过情人节的人是情侣,不为情侣的人,便借以...
    23齿轮阅读 833评论 0 0