gradle编译-基础知识

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'

你可能感兴趣的:(gradle编译-基础知识)