参考https://www.jianshu.com/p/8b8a550246bd,整理为自己需要的方便查看
App
settings.gradle
配置Project和module
include ':app' , ':module1',':module2'
build.gradle
buildscript
gradle自身所使用的资源。可以声明的资源包括依赖项、第三方插件、仓库地址等
repositories
仓库 jcenter()、maven()和google()等
dependencies
配置依赖 classpath:'group:name:version'
ext
自定义属性
- 只在当前配置文件使用的,在当前文件定义
ext.xxx_name='xxx'
,使用的时候$xxx_name
获取值 - 通用自定义配置,单独定义文件
ext{xxx_1='xxx'}
在需要使用的文件中apply from: '文件名'
,使用${xxx_1}
获取值
allprojects
为所有项目提供共同所需依赖包
task
task clean(type: Delete) {
delete rootProject.buildDir
}
运行gradle clean时,执行此处定义的task,删除根目录中的build目录
Module
每个module都有一个build.gradle文件
build.gradle
这里主要就是dependencies,和一些plugin。主要介绍下plugin,以'com.android.application'插件为例
plugin
apply plugin:'×××'
: 二进制插件,一般都是被打包在一个jar里独立发布的
apply from:'×××'
:应用脚本插件,其实就是把这个脚本加载进来
插件的作用
- 添加一些task,帮助完成一些工作
- 添加一些依赖
- 给现有对象添加一些扩展,android{}这个配置块就是Android Gradle插件为Project对象添加的一个扩展
- 对项目进行一些约定,比如应用Java插 件之后,约定src/main/java目录下是我们的源代码存放位置
com.android.application插件
android{} 是Android插件提供的一个扩展类型,可以让我们自定义Android Gradle工程,是Android Gradle工程配置的唯一入口。下面列举一下主要的配置项。
- compileSdkVersion 是编译所依赖的Android SDK的版本,这里是API Level。
- buildToolsVersion 是构建该Android工程所用构建工具的版本。
- defaultConfig{} 它是一个ProductFlavor的默认的配置,后面会介绍ProductFlavor
1. applicationId 包名,app的唯一标识。跟AndroidManifest里面的package是可以不同的。package指的是代码目录下路径;applicationId指的是app对外发布的唯一标识,会在签名、申请第三方库、发布时候用到。
2. minSdkVersion 是支持的Android系统的api level
3. targetSdkVersion 基于哪个Android版本开发的
4. versionCode app应用内部版本号,一般用于控制app升级
5. versionName app应用的版本名称,一般是发布的时候写在app上告诉用户的
6. multiDexEnabled 是否启用自动拆分多个Dex的功能
7. ndk{} 多平台编译,生成有so包的时候使用,包括四个平台'armeabi', 'x86', 'armeabi-v7a', 'mips'
8. flavorDimensions 定义需要定制化的字段,然后在productFlavors中使用
- sourceSets 源代码集合,是Java插件用来描述和管理源代码及资源的一个抽象概念,是一个Java源代码文件和资源文件的集合,我们可以通过sourceSets更改源集的Java目录或者资源目录等。
- buildTypes 构建类型,内置了debug和release两个构建类型,一般用在代码混淆
name:build type的名字
applicationIdSuffix:应用id后缀
versionNameSuffix:版本名称后缀
debuggable:是否生成一个debug的apk
minifyEnabled:是否混淆
proguardFiles:混淆文件
signingConfig:签名配置
manifestPlaceholders:清单占位符
shrinkResources:是否去除未利用的资源,默认false,表示不去除。
zipAlignEnable:是否使用zipalign工具压缩。
multiDexEnabled:是否拆成多个Dex
multiDexKeepFile:指定文本文件编译进主Dex文件中
multiDexKeepProguard:指定混淆文件编译进主Dex文件中
- signingConfigs 签名配置。一个app只有在签名之后才能被发布、安装、使用,签名是保护app的方式,标记该app的唯一性。
storeFile: 签名文件
storePassword: 签名证书文件的密码
storeType: 签名证书类型
keyAlias: 签名证书中秘钥别名
keyPassword: 签名证书中改密钥的密码
- productFlavors Gradle的多渠道打包,你可以在不同的包定义不同的变量,实现自己的定制化版本的需求。
defaultConfig 中定义的 flavorDimensions
manifestPlaceholders 占位符,我们可以通过它动态配置AndroidManifest文件一些内容,譬如app的名字
buildConfigField 是BuildConfig文件的一个函数,而BuildConfig这个类是Android Gradle构建脚本在编译后生成的,而buildConfigField就是其中的自定义函数变量
定义常量 buildConfigField "boolean","isTest","true"
就会在BuildConfig类中添加一个变量 public static final boolean isTest = true
然后我们就可以在代码中使用 BuildConfig.isTest
-
dexOptions{} dx命令只是一个脚本,它调用的还是Java编写的dx.jar库,是Java程序处理的,所以当内存不足的时候,就会内存溢出。给dx分配的内存是一个G,给它增加内存分配来解决这个问题。
dexOptions { javaMaxHeapSize "2g" incremental = true }
dependencies{}
- compile fileTree(include: ['.jar'], dir: 'libs')* 依赖本地libs文件夹下的扩展名为jar
- compile project('×××') 引入某个本地module
- compile group:name:version
gradle 3.0中依赖implementation、api的区别
- api跟以前的compile没什么区别,指令依赖会传递,只需要引入一次,其它module不用再次引入
- implementation指令依赖是不会传递的,也就是说当前引用的第三方库仅限于本module内使用