Gradle for Android 系列:初识 Gradle 文件

读完本文你将了解到:

settinggradle

主目录下的 buildgradle

模块下的 buildgradle

备注

注意 applicationId 和 package name 其实不是一个东西

总结

我们用 Android Studio 新创建一个项目时,会自动生成 3 个 Gradle 文件:

接下来介绍这三个文件的作用。

1. setting.gradle

上篇文章:为什么 Gradle 这么火 中介绍了,

一个 Gradle 构建通常包括三个阶段:初始化,配置,和执行。

setting.gradle 文件在 初始化过程中被执行,构建器通过 setting.gradle 文件中的内容了解哪些模块将被 build,下面的内容表明当前项目中除了 app 模块还有另外一个叫做 “shixinlibrary” 的依赖模块:

include ‘:app’, ‘:shixinlibrary’

注意:单模块项目不一定需要有 setting 文件,但一旦有多个模块,必须要有 setting 文件,同时也要写明所有要构建的模块,否则 gradle 不会 build 不包括的模块。

2.主目录下的 build.gradle

看 gradle 文件中的注释:

Top-level build file where you can configuration options common to all sub-projects/modules.

主目录下的 build.gradle 文件是最顶层的构建文件,这里配置所有模块通用的配置信息。

默认的顶层 build.gradle 文件中包括两个代码块 (buildscript 和 allprojects):

buildscript 

从名字就可以看出来,buildscript 是所有项目的构建脚本配置,主要包括依赖的仓库和依赖的 gradle 版本。

上图中 repositories 代码块将 jcenter 配置为一个仓库,JCenter 是一个很有名的 Maven 仓库。确定了依赖的仓库后,我们就可以在 dependencies 代码块中添加依赖的、在 jcenter 仓库中的包了。

dependencies 代码块用于配置构建过程中的依赖包,注意,这里是用于构建过程,因此你不能讲你的应用模块中需要依赖的库添加到这里。

默认情况下唯一被用于构建过程中的依赖包是 Gradle for Android 的插件。我们还可以添加一些其他用于构建的插件,比如 retrolambda, apt, freeline 等等。

allprojects 

allprojects 代码块用来声明将被用于所有模块的属性,注意是所有模块。常见的就是配置仓库地址(jcenter, 自定义 maven 仓库等),你还可以在 allprojects 中创建 tasks,这些 tasks 最终会运用到所有模块中,

官方建议尽量少添加用于所有模块的属性,因为这意味着强耦合,一旦没有构建主项目,你的子模块很有可能因为缺少所有模块的属性导致构建失败。

3.模块下的 build.gradle

模块下的 build.gradle 文件只应用于当前模块,你可以覆盖主目录下的 build.gradle 的内容。

以我的练习项目为例介绍: 

上图中主要分三个模块:apply plugin , android, dependencies。

apply plugin 

apply plugin 声明了接下来要用到哪些插件的内容,上图表明使用了 androd 插件,这里之所以能用 android 插件,是因为主目录中声明了 Gradle for Android 的依赖,这里才能使用。

因此当我们需要使用其他插件,比如 retrolambda 时,首先需要在主目录 build.gradle 文件中添加依赖,然后在模块 build.gradle 中声明使用 retrolambda 插件。

备注:默认的 android 插件是由 Google 官方维护的,为我们提供了构建、测试、打包 Android 应用的能力。除此之外我们还可以自定义插件。在逐渐加深对 Gradle 的了解后,我们将尝试自己写个 Gradle 插件。

android 

在声明了 android 插件后,我们就可以使用 android 插件提供的内容进行构建配置。

android 构建配置中必须要有的是两个版本:

compileSdkVersion : 编译应用的 Android API 版本

buildToolsVersion : 构建工具版本 

构建工具包括 aapt, zipalign, renderscript 等

用于在打包时生成各种中间产物,可以从 SDK Manager 中下载构建工具

defaultConfig 代码块用于配置应用的默认属性,可以覆盖 AndroidManifest.xml 中的属性,比如:

applicationId : 覆盖了 AndroidManifest 中的 package name

minSdkVersion : 覆盖了 AndroidManifest 中的属性,配置运行应用的最小 API

targetSdkVersion : 一样,用于通知系统当前应用已经被这个版本测试过,和之前的 compileSdkVersion 没有关系

versionCode : 一样,应用的版本号

versionName : 版本名称

defaultConfig 还可以添加签名,占位符等等,这里只列这些。

buildTypes 用来定义如何构建和打包不同类型的应用,常见的就是测试和生产。具体内容后序介绍。

android 中还可以配置其他信息,比如 签名、渠道等,你可以在 Project Structure 面板中直观的查看,添加,也可以使用代码添加,这些内容我们后续详细介绍: 

dependencies 

上图中可以看到 依赖配置 在 android 代码块的外边,事实上依赖配置是 Gradle 配置的基础功能,也就是说除了 Android,其他类型的项目(比如 JavaEE )也可以这么用。

我们可以在依赖配置中,添加要使用的库,当然也可以添加本地的 jar 包。具体依赖配置内容我们后续深入介绍。

备注

注意: applicationId 和 package name 其实不是一个东西。

在使用 Gradle 构建以前,package name 其实有两个作用:

在 R 文件中用作报名

应用的唯一标示

我们知道,一个安卓手机上相同包名的 app 只能有一个。但是当我们想要同时安装一个应用的不同的版本,比如一种测试一种生产,这时,就需要修改 package name 了,但是资源代码和 R 文件要求使用的包名不能改变,否则你的所有源文件都会随着构建版本而改变。怎么办呢?

Gradle 出现后,Android 工具团队解耦了 package name 的两种不同用法,提出了 applicationId 的概念:

定义在 Manifest 文件中的 package,继续用于源代码和 R 文件的标示

而 applicationId 则用作设备和 Google Play 的唯一标识

也就是说 applicationId 覆盖了 package name 的一部分职责。

总结

这篇文章概览了一个 Android 项目中的 Gradle 文件作用及内容,引申出许多细节,比如 自定义构建、依赖管理、多种类型构建的配置等等。接下来我们将深入学习这些内容。

相关阅读:

Gradle for Android 系列:为什么 Gradle 这么火

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,856评论 25 707
  • 上一章我们学习了Gralde的使用,创建和转换Android工程。本章我们将深入了解构建文件,学习一些有用的tas...
    sollian阅读 1,369评论 0 3
  • UiView的一些代理 一.<NSCoding> 我们会在以下这些场合用到NSCoding: 1. XIB/Sto...
    爱笑的猫mi阅读 1,162评论 0 1
  • 马不停蹄地忙了一周,基本上到了周六挤出的就是最后一丝精气神。坏情绪基本上没有,因为干不完的活填满了所有的时间,忙里...
    绿川阅读 301评论 0 1
  • 有志者事竟成。锲而不舍,金石可镂。成大事不在于力量的大小,而在于能坚持多久。 上面的话从小就开始听,我们却从来没当...
    葵酱阅读 580评论 0 0