1.构建配置文件
在根目录/模块模块目录下执行:gradle init > basic > Groovy
生成的文件包括(以根目录为例):
|----bulid.gradle
|----gradle
|--------wrapper
|------------gradle-wrapper.jar
|------------gradle-wrapper.properties
|----gradlew
|----gradlew.bat
|----settings.gradle
Gradle 设置文件
settings.gradle 文件位于项目的根目录下,用于指示 Gradle 在构建应用时应将哪些模块包含在内。
顶层构建文件
顶层 build.gradle 文件位于项目的根目录下,用于定义适用于项目中所有模块的构建配置。
默认情况下,顶层构建文件使用 buildscript 代码块定义项目中所有模块共用的 Gradle 代码库和依赖项。
对于包含多个模块的 Android 项目,可以将模块之间共享的属性添加到顶层 build.gradle 文件内的 ext 代码块中。
模块级构建文件
模块级 build.gradle 文件位于每个 project/module/ 目录下,用于为其所在的特定模块配置构建设置。
可以通过配置这些构建设置提供自定义打包选项(如额外的构建类型和产品变种),以及替换 main/ 应用清单或顶层 build.gradle 文件中的设置。
buildscript与allprojects
buildscript:声明gardle脚本自身所需要使用的资源,包括依赖项、maven仓库地址、第三方插件等。
allprojects:用于多项目构建,为模块提供共同所需依赖包。
gradle-wrapper.properties
GRADLE_USER_HOME 默认值是 USER_HOME/.gradle。
distributionUrl 指定gradle版本。
2.配置文件语法
apply plugin
apply是 Gradle project 中提供的方法,接收一个Map类型的参数,用于配置项目中的插件。
Gradle有两种类型插件:脚本插件和二进制插件。
脚本插件是其他构建脚本,可以进一步配置构建,并通常采用声明式方法来操纵构建。
二进制插件通过实现Plugin接口以编程方式编写,或使用Gradle的DSL语言以声明方式编写。
其中 Android Gradle 插件由 Google Android 开发团队开发,主要分为3类:
类别 | 作用 | 插件id |
---|---|---|
App 应用工程 | 可生成可运行的 apk | com.android.application |
Library 库工程 | 可生成 aar 供其他 App 应用工程使用 | com.android.library |
Test 测试工程 | 用于 App 应用工程或 Library 工程进行测试 | com.android.test |
android{}:Configuration blocks
由 Android Gradle 插件提供的方法,用于配置项目构建的各种属性。
闭包 | 描述 |
---|---|
aaptOptions { } | AAPT |
adbOptions { } | ADB |
buildTypes { } | 编译类型,默认有debug和release |
compileOptions { } | Java编译器选项 |
dataBinding { } | 数据绑定库 |
defaultConfig { } | 所有构建版本的属性默认值 |
dexOptions { } | Dex工具 |
externalNativeBuild { } | 使用CMake或ndk-build |
jacoco { } | 离线检测和代码覆盖率 |
lintOptions { } | 代码扫描分析 |
packagingOptions { } | 指定打包文件和规则 |
productFlavors { } | 多渠道配置 |
signingConfigs { } | 签名配置 |
sourceSets { } | 源集合,用来指定资源路径 |
splits { } | 构建多个APK或APK拆分 |
testOptions { } | 测试 |
新版本新增 BuildFeatures{} ,可配置 buildConfig = false 禁止生成 BuildConfig.class。
repositories
Repositories 就是代码仓库,添加的 dependency 就是从这里找的。
Gradle 支持三种类型的仓库:Maven,Ivy和静态文件或者文件夹。
在编译的执行阶段,gradle 将会从仓库中取出对应需要的依赖文件。
dependencies:依赖项配置
新配置 | 已弃用配置 | 行为 |
---|---|---|
implementation | compile | 编译时,依赖项仅对当前模块可见。运行时,依赖项对所有模块可见。可提升编译速度。 |
api | compile | 编译和运行时,依赖项对所有模块均可见。 |
compileOnly | provided | 只参与编译,不参与打包。 |
runtimeOnly | apk | 不参与编译,只参与打包。 |
annotationProcessor | compile | 配置注解处理器路径。 |
lintChecks | 构建时执行lint检查。 | |
lintPublish |
在引用库的时候,每个库名称包含三个元素:组名:库名称:版本号。
例如:implementation 'com.android.support:multidex:1.0.0'