Gradle学习笔记(二)自定义构建基础

一、配置Manifest文件

我们可以直接通过构建文件而不是manifest文件来配置applicationId、minSdkVersion、targetSdkVersion、versionCode和versionName。另外,下面一些属性也是我们可以操控的:

  • testApplicationId: 针对 instrument测试APK的applicationId
  • testInstrumentationRunner: JUnit测试运行器的名称,被用来运行测试
  • signingConfig:
  • proguardFiles

二、BuildConfig类

自SDK工具版本升级到17之后,构建工具都会生成一个叫作BuildConfig的类,该类包含一个按照构建类型设置值的DEBUG常量。如果有一部分代码你只想在debugging时期运行,比如logging,那么DEBUG会非常有用。你可以通过Gradle来扩展该文件,这样在debug和release时,就可以拥有不同的常量:

   buildTypes {
        debug {
           buildConfigField  "String",  "API_ URL", "\"http:// test. example. com/ api\""              
           buildConfigField "boolean", "LOG_ HTTP_ CALLS", "true"
           minifyEnabled false
           proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        release {
            buildConfigField  "String",  "API_ URL", "\"http:// test. example. com/ api\""              
            buildConfigField "boolean", "LOG_ HTTP_ CALLS", "false"
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

字符串值必须用转义双引号括起来,这样才会生成实际意义上的字符串。在添加buildConfigField行后,你可以在你的Java代码中使用BuildConfig.API_URL和BuildConfig.LOG_HTTP_ CALLS。

最近,Android工具开发小组还增加了类似的方式来配置资源值:

   buildTypes {
        debug {
            resValue "string", "app_name", "ExampleDEBUG"
        }
        release {
           resValue "string", "app_name", "Example"
        }
    }

这里可以不加转义双引号,因为资源值通常默认被包装成value=""。

三、项目配置的范围

看这段代码:

allprojects {
      apply plugin:'com.android.application'
      android {
        compileSdkVersion  27
        buildToolsVersion  "27.0.1"
      }
}

该段代码只有在你的所有模块都是Androidapp项目的时候才有效,因为你需要运用Android插件来获取Android特有的设置。

实现这种行为的更好方式是在顶层构建文件中定义值,然后将它们应用到模块中。Gradle允许在Project对象上添加额外属性。这意味着任何build.gradle文件都能定义额外的属性,添加额外属性需要通过ext代码块。

你可以给顶层构建文件添加一个含有自定义属性的ext代码块:

project.ext {
    android = [
            compileSdkVersion   : 27,
            buildToolsVersion   : "27.0.1",

            minSdkVersion       : 16,
            targetSdkVersion    : 27,
            versionCode         : 1,
            versionName         : "1.0.0"
    ]
}

该段代码使得模块层的构建文件可以使用rootProject来获取属性:

android {
    compileSdkVersion rootProject.ext.android["compileSdkVersion"]
    buildToolsVersion rootProject.ext.android["buildToolsVersion"]

    defaultConfig {
        minSdkVersion rootProject.ext.android["minSdkVersion"]
        targetSdkVersion rootProject.ext.android["targetSdkVersion"]
        versionCode rootProject.ext.android["versionCode"]
        versionName rootProject.ext.android["versionName"]
    }
}

四、项目属性

前面例子的ext代码块是定义额外属性的一种方式。你可以使用属性来动态定制构建过程。定义属性的方式有很多种,这里我们只介绍三种常用的:

  • ext代码块
  • gradle.properties文件
  • -P命令行参数
ext {
    local='Hello from build.gradle'
}

task printProperties  {
     println local // Local extra property
     println propertiesFile // Property from file
     if (project. hasProperty(' cmd')) { 
        println cmd // Command line property
     }
 }

gradle.properties文件的实现(相同文件夹下):

propertiesFile = Hello from gradle.properties

我们可以同时在顶层构建文件和模块构建文件中定义属性。如果一个模块定义了一个在顶层文件中早已存在的属性时,那么新属性将会直接覆盖原来的属性。

五、默认任务

如果没有指定任何任务而运行Gradle的话,其会运行help任务,它会打印一些如何使用Gradle工作的信息。help任务被设置为默认的任务,在每次运行没有明确指定任务的Gradle时,可以覆写默认的任务,添加一个常用的任务,甚至是多个任务。

在顶层build.gradle文件中加入一行,可用来指定默认的任务:

defaultTasks 'clean', 'assembleDebug'

现在,当你运行没有任何参数的GradleWrapper时,它会运行clean和assembleDebug。通过运行tasks任务和格式化输出,可以清晰地看到哪些任务被设置为默认任务。

$ gradlew tasks | grep "Default tasks" 

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

推荐阅读更多精彩内容

  • 这一章主要针对项目中可以用到的一些实用功能来介绍Android Gradle,比如如何隐藏我们的证书文件,降低风险...
    acc8226阅读 7,580评论 3 25
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,646评论 18 139
  • 上一章我们学习了Gralde的使用,创建和转换Android工程。本章我们将深入了解构建文件,学习一些有用的tas...
    sollian阅读 1,370评论 0 3
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,970评论 25 707
  • 前些天,公司举行新员工培训,要求我们给新员工分享一些个人心得或者是对新员工想说的话。自己反复考虑了很多,不知道应该...
    尹晓丽阅读 224评论 0 0