系列介绍:
此系列文章大部分翻译自【Gradle for Android】,一些地方加入了自己的理解,不准请大家指正。
推荐文章系列:
- Android官网关于在Android上使用Gradle介绍Gradle Plugin User Guide,有个托管在GitBook上的中文翻译版可以参考
- 对Android DSL深入了解Android Plugin DSL Reference
- gradle基础系列可以选择stormzhang的系列文章
- 邓老师的深入理解Android之Gradle
章节主题:
- 了解Android Studio新建工程目录结构
- 了解Gradle基础知识
一,了解Android Studio新建工程目录结构
1.目录结构介绍
- .gradle
gradle项目产生的文件夹。
2).idea
开发工具产生的文件夹
3)app
主module,
4)两个build
构建产出物文件夹
5)两个.gitignore
版本控制需要忽略的文件
6).iml文件
开发工具生成的项目文件
7)gradle
gradle wrapper文件夹
8)gradle-wrapper.properties
gradle-wrapper配置文件
9)build.gradle
构建脚本
10)gradle.properties
gradle运行环境配置文件
11)gradlew和gradlew.bat
gradlew是linux mac环境的脚本,gradlew.bat是windows 环境的脚本,配合gradle 文件夹使用。 - local.properties
可以指定Android SDK NDK 环境路径的配置文件 - setting.gradle
声明project包含module的文件
14)proguard-rules.pro
混淆规则
2.忽略文件的规则
在版本控制时,应该忽略其他人不需要或者自己机器独有的配置项。所以按照此规则应该忽略:
.gradle文件夹;.idea文件夹;build文件夹;.iml;local.properties
二,了解Gradle基础知识
重要概念:
1.build script ,build.gradle
使用Gradle来构建Android项目,需要一个构建脚本。这个脚本就是build.gradle。
2.domain-specific language (DSL) based on Groovy
Gradle脚本抛弃了传统的XML来编写脚本,使用了基于Groovy的内部领域语言(行话),Groovy是一种动态的JVM语言。这种动态语言在程序化的控制上比XML更具有优势。
3.Project ,task
每个构建至少由一个project组成,一个project包含一个或多个task,一个build.gradle代表了一个project,在构建脚本里定义task。在构建初始化构阶段,Gradle会根据构建文件来组装Project和Task对象。
Task对象由按照执行顺序排列的Action对象列表组成, Action对象是一个可执行的代码块,与Java中的方法类似。
4.The build lifecycle
Gradle有3个阶段:
- Initialization:初始化:这是创建项目实例的位置。如果有多个模块,每个都有自己的build.gradle文件,将会创建多个项目。(执行settings.gradle)
- Configuration:配置:在此阶段,执行构建脚本,为每个project对象创建和配置所有task。peoject内部task被组装到一个有向图里,来描述task之间的关系。(task执行顺序,task最后类似被组装成一条流水线上,依次执行),没有和其他task有依赖关系的task先执行。
- Execution:执行:这是Gradle决定执行哪些任务的阶段。
5,了解Gradle Wrapper
Gradle是一个不断发展的项目,使用Gradle Wrapper对gradle进行一层封装,可以让我们忽略gradle的具体版本和细节实现。为了能运行各种gradle版本构建的project,在本地可能会有很多gradle的版本。Gradle Wrapper就对每个版本的gradle进行了包装或者是抽象,让我们不用关心gradle的具体版本,用一样的gradlew命令都能操作各个gradle版本。在gradle-wrapper.properties文件中distributionUrl属性指定了远程gradle版本的地址,当本地没有gradle时,会去下载gradle,这是第一次进入AS或者导入其他项目一直卡住的一个原因,解决办法是翻墙或者去下载一个指定版本的Gradle放到本地。运行 Gradle Wrapper和直接运行Gradle没有什么区别,在 Linux and Mac OS X 会执行gradlew,在windows上会执行gradlew.bat。