gradle在Android中的使用

参考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工程配置的唯一入口。下面列举一下主要的配置项。

1. compileSdkVersion 是编译所依赖的Android SDK的版本，这里是API Level。
2. buildToolsVersion 是构建该Android工程所用构建工具的版本。
3. 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中使用

4. sourceSets 源代码集合，是Java插件用来描述和管理源代码及资源的一个抽象概念，是一个Java源代码文件和资源文件的集合，我们可以通过sourceSets更改源集的Java目录或者资源目录等。
5. 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文件中

6. signingConfigs 签名配置。一个app只有在签名之后才能被发布、安装、使用，签名是保护app的方式，标记该app的唯一性。

       storeFile: 签名文件
       storePassword: 签名证书文件的密码
       storeType: 签名证书类型
       keyAlias: 签名证书中秘钥别名
       keyPassword: 签名证书中改密钥的密码

7. 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

8. 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内使用