史上最全Android build.gradle配置详解(小结)

// top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {//这里是gradle脚本执行所需依赖，分别是对应的maven库和插件

  repositories {
    google()//从android studio3.0后新增了google()配置，可以引用google上的开源项目
    jcenter()//是一个类似于github的代码托管仓库，声明了jcenter()配置，可以轻松引用 jcenter上的开源项目
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:3.0.0'////此处是android的插件gradle，gradle是一个强大的项目构建工具

    // note: do not place your application dependencies here; they belong
    // in the individual module build.gradle files
  }
}

allprojects {//这里是项目本身需要的依赖，比如项目所需的maven库
  repositories {
    google()
    jcenter()
  }
}

// 运行gradle clean时，执行此处定义的task任务。
// 该任务继承自delete，删除根目录中的build目录。
// 相当于执行delete.delete(rootproject.builddir)。
// gradle使用groovy语言，调用method时可以不用加（）。
task clean(type: delete) {
  delete rootproject.builddir
}

// 声明是android程序，
//com.android.application 表示这是一个应用程序模块
//com.android.library 标识这是一个库模块
//而这区别：前者可以直接运行，后着是依附别的应用程序运行
apply plugin: 'com.android.application'

 signingconfigs {// 自动化打包配置
    release {// 线上环境
      keyalias 'test'
      keypassword '123456'
      storefile file('test.keystore')
      storepassword '123456'
    }
    debug {// 开发环境
      keyalias 'test'
      keypassword '123456'
      storefile file('test.keystore')
      storepassword '123456'
    }
  }

  compilesdkversion 27//设置编译时用的android版本
  defaultconfig {
    applicationid "com.billy.myapplication"//项目的包名
    minsdkversion 16//项目最低兼容的版本
    targetsdkversion 27//项目的目标版本
    versioncode 1//版本号
    versionname "1.0"//版本名称
    testinstrumentationrunner "android.support.test.runner.androidjunitrunner"//表明要使用androidjunitrunner进行单元测试
  }

buildtypes {// 生产/测试环境配置
    release {// 生产环境
      buildconfigfield("boolean", "log_debug", "false")//配置log日志
      buildconfigfield("string", "url_perfix", "\"https://release.cn/\"")// 配置url前缀
      minifyenabled false//是否对代码进行混淆
      proguardfiles getdefaultproguardfile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
      signingconfig signingconfigs.release//设置签名信息
      pseudolocalesenabled false//是否在apk中生成伪语言环境，帮助国际化的东西，一般使用的不多
      zipalignenabled true//是否对apk包执行zip对齐优化，减小zip体积，增加运行效率
      applicationidsuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
      versionnamesuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
    }
    debug {// 测试环境
      buildconfigfield("boolean", "log_debug", "true")//配置log日志
      buildconfigfield("string", "url_perfix", "\"https://test.com/\"")// 配置url前缀
      minifyenabled false//是否对代码进行混淆
      proguardfiles getdefaultproguardfile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
      signingconfig signingconfigs.debug//设置签名信息
      debuggable false//是否支持断点调试
      jnidebuggable false//是否可以调试ndk代码
      renderscriptdebuggable false//是否开启渲染脚本就是一些c写的渲染方法
      zipalignenabled true//是否对apk包执行zip对齐优化，减小zip体积，增加运行效率
      pseudolocalesenabled false//是否在apk中生成伪语言环境，帮助国际化的东西，一般使用的不多
      applicationidsuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
      versionnamesuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
    }
  }

 sourcesets {//目录指向配置
    main {
      jnilibs.srcdirs = ['libs']//指定lib库目录
    }
  }

  packagingoptions{
    //pickfirsts做用是 当有重复文件时 打包会报错 这样配置会使用第一个匹配的文件打包进入apk
    // 表示当apk中有重复的meta-inf目录下有重复的license文件时 只用第一个 这样打包就不会报错
    pickfirsts = ['meta-inf/license']

    //merges何必 当出现重复文件时 合并重复的文件 然后打包入apk
    //这个是有默认值得 merges = [] 这样会把默默认值去掉 所以我们用下面这种方式 在默认值后添加
    merge 'meta-inf/license'

    //这个是在同时使用butterknife、dagger2做的一个处理。同理，遇到类似的问题，只要根据gradle的提示，做类似处理即可。
    exclude 'meta-inf/services/javax.annotation.processing.processor'
  }

android { 
  productflavors {
    wandoujia {
      //豌豆荚渠道包配置
      manifestplaceholders = [umeng_channel_value: "wandoujia"]
      //manifestplaceholders的使用在后续章节（androidmanifest里的占位符）中介绍
    }
    xiaomi {
      manifestplaceholders = [umeng_channel_value: "xiaomi"]
      applicationid "com.wiky.gradle.xiaomi" //配置包名

    }
    _360 {
      manifestplaceholders = [umeng_channel_value: "_360"]
    }
    //...
  } 
}

android { 
  productflavors {
    wandoujia {}
    xiaomi {}
    _360 {}
    //...
  } 

  productflavors.all { 
    //批量修改，类似一个循序遍历
    flavor -> flavor.manifestplaceholders = [umeng_channel_value: name] 
  }
}

defaultconfig {

targetsdkversion：***

minsdkversion ：***

versioncode：***

versionname ：***

//版本名后面添加一句话，意思就是flavor dimension 它的维度就是该版本号，这样维度就是都是统一的了

flavordimensions "versioncode"

}

 //程序在编译的时候会检查lint，有任何错误提示会停止build，我们可以关闭这个开关
  lintoptions {
    abortonerror false //即使报错也不会停止打包
    checkreleasebuilds false //打包release版本的时候进行检测
  }

dependencies {//项目的依赖关系
  implementation filetree(include: ['*.jar'], dir: 'libs')//本地jar包依赖
  implementation 'com.android.support:appcompat-v7:27.1.1'//远程依赖
  implementation 'com.android.support.constraint:constraint-layout:1.1.2'
  testimplementation 'junit:junit:4.12'//声明测试用例库
  androidtestimplementation 'com.android.support.test:runner:1.0.2'
  androidtestimplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

// 声明是android程序，
//com.android.application 表示这是一个应用程序模块
//com.android.library 标识这是一个库模块
//而这区别：前者可以直接运行，后着是依附别的应用程序运行
apply plugin: 'com.android.application'

android {
  signingconfigs {// 自动化打包配置
    release {// 线上环境
      keyalias 'test'
      keypassword '123456'
      storefile file('test.jks')
      storepassword '123456'
    }
    debug {// 开发环境
      keyalias 'test'
      keypassword '123456'
      storefile file('test.jks')
      storepassword '123456'
    }
  }
  compilesdkversion 27//设置编译时用的android版本
  defaultconfig {
    applicationid "com.billy.myapplication"//项目的包名
    minsdkversion 16//项目最低兼容的版本
    targetsdkversion 27//项目的目标版本
    versioncode 1//版本号
    versionname "1.0"//版本名称
    flavordimensions "versioncode"
    testinstrumentationrunner "android.support.test.runner.androidjunitrunner"//表明要使用androidjunitrunner进行单元测试
  }
  buildtypes {// 生产/测试环境配置
    release {// 生产环境
      buildconfigfield("boolean", "log_debug", "false")//配置log日志
      buildconfigfield("string", "url_perfix", "\"https://release.cn/\"")// 配置url前缀
      minifyenabled false//是否对代码进行混淆
      proguardfiles getdefaultproguardfile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
      signingconfig signingconfigs.release//设置签名信息
      pseudolocalesenabled false//是否在apk中生成伪语言环境，帮助国际化的东西，一般使用的不多
      zipalignenabled true//是否对apk包执行zip对齐优化，减小zip体积，增加运行效率
      applicationidsuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
      versionnamesuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
    }
    debug {// 测试环境
      buildconfigfield("boolean", "log_debug", "true")//配置log日志
      buildconfigfield("string", "url_perfix", "\"https://test.com/\"")// 配置url前缀
      minifyenabled false//是否对代码进行混淆
      proguardfiles getdefaultproguardfile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
      signingconfig signingconfigs.debug//设置签名信息
      debuggable false//是否支持断点调试
      jnidebuggable false//是否可以调试ndk代码
      renderscriptdebuggable false//是否开启渲染脚本就是一些c写的渲染方法
      zipalignenabled true//是否对apk包执行zip对齐优化，减小zip体积，增加运行效率
      pseudolocalesenabled false//是否在apk中生成伪语言环境，帮助国际化的东西，一般使用的不多
      applicationidsuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
      versionnamesuffix 'test'//在applicationid 中添加了一个后缀，一般使用的不多
    }
  }

  sourcesets {//目录指向配置
    main {
      jnilibs.srcdirs = ['libs']//指定lib库目录
    }
  }

  packagingoptions{//打包时的相关配置
    //pickfirsts做用是 当有重复文件时 打包会报错 这样配置会使用第一个匹配的文件打包进入apk
    // 表示当apk中有重复的meta-inf目录下有重复的license文件时 只用第一个 这样打包就不会报错
    pickfirsts = ['meta-inf/license']

    //merges何必 当出现重复文件时 合并重复的文件 然后打包入apk
    //这个是有默认值得 merges = [] 这样会把默默认值去掉 所以我们用下面这种方式 在默认值后添加
    merge 'meta-inf/license'

    //这个是在同时使用butterknife、dagger2做的一个处理。同理，遇到类似的问题，只要根据gradle的提示，做类似处理即可。
    exclude 'meta-inf/services/javax.annotation.processing.processor'
  }

  productflavors {
    wandoujia {}
    xiaomi {}
    _360 {}
  }

  productflavors.all {
      //批量修改，类似一个循序遍历
    flavor -> flavor.manifestplaceholders = [iflytek_channel: name]
  }

  //程序在编译的时候会检查lint，有任何错误提示会停止build，我们可以关闭这个开关
  lintoptions {
    abortonerror false
    //即使报错也不会停止打包
    checkreleasebuilds false
    //打包release版本的时候进行检测
  }

}

dependencies {
  //项目的依赖关系
  implementation filetree(include: ['*.jar'], dir: 'libs')
  //本地jar包依赖
  implementation 'com.android.support:appcompat-v7:27.1.1'
  //远程依赖
  implementation 'com.android.support.constraint:constraint-layout:1.1.2'
  testimplementation 'junit:junit:4.12'
  //声明测试用例库
  androidtestimplementation 'com.android.support.test:runner:1.0.2'
  androidtestimplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}