Gradle DSL
在android{}块中可以包含以下直接配置项:
defaultConfig{} 默认配置,是ProductFlavor类型。它共享给其他ProductFlavor使用
sourceSets{ } 源文件目录设置,是AndroidSourceSet类型。
buildTypes{ } BuildType类型
signingConfigs{ } 签名配置,SigningConfig类型
productFlavors{ } 产品风格配置,ProductFlavor类型
testOptions{ } 测试配置,TestOptions类型
aaptOptions{ } aapt配置,AaptOptions类型
lintOptions{ } lint配置,LintOptions类型
dexOptions{ } dex配置,DexOptions类型
compileOptions{ } 编译配置,CompileOptions类型
packagingOptions{ } PackagingOptions类型
jacoco{ } JacocoExtension类型。 用于设定 jacoco版本
splits{ } Splits类型。
在DSL文档中,以上每个类型都有它的详细配置选项
工程里有几个gradle文件,一般为build.gradle。不要觉得他语法挺奇怪的,他不属于标记性语言(conf或者xml等),他是标准的groovy语言。他一转换成标准java代码。以下解释经过优化,更便于理解!
有几个概念要先理解一下:project,task,afterEvaluate周期,gradle的依赖(不是项目依赖,classpath环境),gradle插件简介
project
介绍project之前先熟悉一下gradle风格项目的目录结构。首先根目录:
- app
- build.gradle
- gradlew
- gradlew.bat
- settings.gradle
- App下面就就是主工程。
- build.gradle是管理所有工程的的脚本,以及管理gradle编译的依赖(classpath)。
- gradlew和gradlew.bat初始化环境变量,他就是项目构建执行的入口。
- setting.gradle用来注册所有模块。
以上目录成为rootProject。在build.gradle里边使用project使用,它代表rootProject。但是,如果在app下边的build.gradle使用project的时候,就代表app工程。(以上project皆代表变量,这个变量拥有当前模块的一切信息,可以在build.gradle中任何地方使用它,只需要注意project指向问题)
afterEvaluate周期
afterEvaluate 这个回调需要了解一下,首先我们把gradle编译项目分为两步:构建项目使用的gradle脚本和构建项目。举个例子:人吃饭需要饭,饭需要制作。那么做饭是第一步,吃饭时第二步。如果把做饭比作构建gradle脚本,那么构建项目就是吃饭。afterEvaluate这个回调,就是吃饭的回调。告诉你饭熟了,接着该吃饭了。
在Gradle项目中,我们会注册很多个ext参数或者android参数,这些东西在饭熟之前是拿不到的。
task
项目构建是一步一步完成的,比如有一个影响深远的哲学问题,把大象放进冰箱分为几步,先什么什么在什么什么。task就是这个步骤,android打包步骤这里不赘述,只需要明白它是由一个一个task串并联起来的。
:app:preSitDebugBuild UP-TO-DATE
:app:compileSitDebugAidl UP-TO-DATE
:app:compileSitDebugRenderscript UP-TO-DATE
:courierMain:generateDebugRFile UP-TO-DATE
:app:checkSitDebugManifest
:courierMain:generateDebugSources UP-TO-DATE
:app:checkSitDebugManifest UP-TO-DATE
:app:generateSitDebugBuildConfig UP-TO-DATE
:app:rpGenerateSitDebugHostConfig
:app:generateSitDebugResources UP-TO-DATE
:app:mergeSitDebugResources UP-TO-DATE
:app:processSitDebugManifest UP-TO-DATE
:app:processSitDebugResources UP-TO-DATE
:app:generateSitDebugSources UP-TO-DATE
其中:app代表在app下,:理解为/就可以了,整句就是执行根目录下app下的什么什么task。UP-TO-DATE 使用缓存构建,代表跳过。
在build.gradle中声明一个task很容易。
task {
// code block1
doFirst {
// code block2
}
doLast {
// code block3
}
}
在饭熟之前,系统会自动回调code block1和code block2的内容。只有写在doLast里边的会在手动出发之后执行,这一点需要注意。
Task之间可以使用 dependOn进行依赖,这样就可以把一个一个task串联起来,用来构建项目。一个task同时对两个task进行依赖的时候,使用mustRunAfter进行排序。task之间的依赖就不要搞得太复杂了。更多使用见官方文档,这里只是了解。
classpath
Gradle构建也需要有依赖,类似我们项目的dependencies。只不过它通常使用classpath声明一个依赖。在rootProject的build.gradle中buildscript可以找到。
buildscript {
repositories {
flatDir name: 'localRepository', dir: "ma/repos"
maven {
url "http://nexus.sf-express.com/nexus/content/groups/public/"
}
}
configurations.all {
resolutionStrategy.cacheDynamicVersionsFor 0, 'seconds'
resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}
dependencies {
//声明依赖
classpath 'com.android.tools.build:gradle:3.1.3'
classpath 'com.sf.replugin:replugin-host-gradle:2.2.3.2462.311'
classpath 'com.jakewharton:butterknife-gradle-plugin:8.4.0'
classpath "io.lecon.moduleassistant:ma-lib:0.0.4.dev-SNAPSHOT"
}
}
这个gradle构建工程使用了四个依赖,谷歌的android依赖,插件化的依赖,butterknife以及ma。他们都是为构建gradle而服务的,原则上不涉及到我们要写代码的工程,只是更好的为我们写代码服务(做饭过程)。
所以你可以明白buildscript-> repositories-> maven和allprojects->repositories->maven虽然写的一样,但他们代表的意义确实不同的,一个服务于gradle构建脚本(做饭),一个服务于所有子项目的依赖(吃饭)。
gradle插件
这个话题如果详细说的话,需要很打的篇幅,这里只是简单介绍一下。介绍一下能做到哪些东西。
Gradle的插件非常开放:
可以动态增删改查classpath,以及项目的dependencies,
动态创建task,修改你build.gradle中的dsl。
以及实现动态增加或者更改代码(transform代码扫描更改技术),butterknife中findviewbyid的生成和Replugin插件的生成(代码生成技术和代码插装技术)
获取项目中的所有路径,包括代码(sourceSets),资源路径,AndroidMainfest,以及Apk输出路径,甚至你可以干扰这些过程(task的doLast和dependOn)。
使用这个,你甚至可以写一个小型的Jvm程序,但别忘了,你要写的代码的是辅助项目开发。
在编写代码的时候,需要注意gradle的生命周期,明确他是在做饭还是吃饭时期,否则有些变量无法获取。
网友评论