Gradle 作为Android studio指定的自动化管理构建程序的工具,每个Android 程序员都应该对其有最基本的了解,但是平时Android studio 已经帮我们完成了大多数Gradle的配置,所以大多数人对Gradle理解的并不多,接下来就让我们进入Gradle的世界。
构建流程(摘自https://developer.android.com/studio/build/)
如图 所示,典型 Android 应用模块的构建流程通常依循下列步骤:
- 编译器将您的源代码转换成 DEX(Dalvik Executable) 文件(其中包括运行在 Android 设备上的字节码),将所有其他内容转换成已编译资源。
- APK 打包器将 DEX 文件和已编译资源合并成单个 APK。不过,必须先签署 APK,才能将应用安装并部署到 Android 设备上。
- APK 打包器使用调试或发布密钥库签署您的 APK:
- 如果您构建的是调试版本的应用(即专用于测试和分析的应用),打包器会使用调试密钥库签署您的应用。Android Studio 自动使用调试密钥库配置新项目。
- 如果您构建的是打算向外发布的发布版本应用,打包器会使用发布密钥库签署您的应用。要创建发布密钥库,请阅读在 Android Studio 中签署您的应用。
- 在生成最终 APK 之前,打包器会使用 zipalign 工具对应用进行优化,减少其在设备上运行时的内存占用。
构建流程结束时,您将获得可用来进行部署、测试的调试 APK,或者可用来发布给外部用户的发布 APK。
目录结构
Android项目中最重要的就是 build.gradle, setting.gradle
setting.gradle
setting.gradle 是Gradle 的设置文件,位于项目的根目录,用于指示 Gradle 在构建应用时应将哪些模块包括在内。对大多数项目而言,该文件很简单,只包括以下内容:
include ':app'
如果有多个module项目的话
include ':app', ':app2'
顶级根目录build.gradle
顶级 build.gradle 文件位于项目根目录,用于定义适用于项目中所有模块的构建配置。默认情况下,这个顶级构建文件使用 buildscript {} 代码块来定义项目中所有模块共用的 Gradle 存储区和依赖项。
/**
buildscript{}是基础配置,构建开始的时候,所有子模块都会读取这个里面的内容
*/
buildscript {
repositories { // 告诉Gradle 下载第三方库的地址
jcenter() // 代表 https://bintray.com/bintray/jcenter
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
}
}
//配置所有模块的共同使用内容
allprojects {
repositories {
jcenter() //让所有子模块都从jcenter 获取第三方包
}
}
Gradle 插件和Gradle版本的关系
如上图所示我们设置的是Gradle插件的版本号,并不是Gradle的版本,最后的序号就是插件的版本号,注意插件不是gradle,插件是根据gradle特性编写为完成需求的jar包,插件依赖于gradle,下图是插件和Gradle版本对应的关系,也就是说,如果我们用3.1.0的插件,就必须使用Gradle4.4以上的版本。
https://developer.android.google.cn/studio/releases/gradle-plugin#updating-plugin
在该文件里可以查看Gradle的版本信息
模块级 build.gradle
build.gradle 文件位于每个 <project>/<module>/ 目录,用于配置适用于其所在模块的构建设置。您可以通过配置这些构建设置来提供自定义打包选项(例如附加构建类型和产品风味),以及替换 main/ 应用清单或顶级 build.gradle 文件中的设置。
以下这个示例 Android 应用模块 build.gradle 文件概述了您应该了解的部分基本 DSL 元素和设置。google提供的dsl查询手册
/**
告诉Gradle这个module的构建类型,application 或者library
*/
apply plugin: 'com.android.application'
/**
Android 构建的参数
*/
android {
compileSdkVersion 28
buildToolsVersion "28.0.3"
defaultConfig {
applicationId 'com.example.myapp'
// Defines the minimum API level required to run the app.
minSdkVersion 15
// Specifies the API level used to test the app.
targetSdkVersion 28
// Defies the version number of your app.
versionCode 1
// Defines a user-friendly version name for your app.
versionName "1.0"
}
buildTypes {
release {
minifyEnabled true // Enables code shrinking for the release build type.
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
productFlavors {
free {
applicationId 'com.example.myapp.free'
}
paid {
applicationId 'com.example.myapp.paid'
}
}
splits {
// Screen density split settings
density {
// Enable or disable the density split mechanism
enable false
// Exclude these densities from splits
exclude "ldpi", "tvdpi", "xxxhdpi", "400dpi", "560dpi"
}
}
}
/**
* The dependencies {} block in the module-level build configuration file
* only specifies dependencies required to build the module itself.
*/
dependencies {
compile project(":lib")
compile 'com.android.support:appcompat-v7:28.0.0'
compile fileTree(dir: 'libs', include: ['*.jar'])
}
Gradle 还包括两个属性文件,位于项目根目录,可用于指定适用于 Gradle 构建工具包本身的设置:
gradle.properties
您可以在其中配置项目范围 Gradle 设置,例如 Gradle 后台进程的最大堆大小。如需了解详细信息,请参阅构建环境
local.properties
为构建系统配置本地环境属性,例如 SDK 安装路径。由于该文件的内容由 Android Studio 自动生成并且专用于本地开发者环境,因此您不应手动修改该文件,或将其纳入您的版本控制系统。
Gradle 在执行的时候大概进行了如下几步操作:
1 初始化构建
2 配置构建
3 执行构建
4 完成构建或者失败
在项目初始化构建的时候,去读取项目的setting.gradle,判断需要构建的项目,并在初始化的时候生成一个Gradle对象,我们可以在官网查到这个对象的的api和属性。
初始化完成后,Gradle读取到需要构建的各个项目,便开始配置构建工作,去读取每个项目的build.gradle,并生成一个project对象,这个project对象对应这个这个build.gradle。project的文档,我们可以在build.gradle 文件里调用project对象。
每个项目也就是build.gradle里都有一个个task,执行构建的工作就是执行这些task,在执行这些task的过程,Gradle会把这个task任务的依赖任务也一个个执行。我们可以在Android studio的Gradle 视图里看到这些task
Android studio的安装应用按钮,clean其实都是在帮我们执行这些相应的task 命令。