build.gradle 详解（一）
转：https://www.cnblogs.com/steffen/p/9212765.html
简述：
1） Java 开发中有两个大名鼎鼎的项目构建 ANT、Maven。
2） Google 推荐使用的 Android studio 是采用 Gradle 来构建项目。Gradle 是一个非常先进的项目构建工具。
Gradle 是用了一种基于 Groovy 的领域特定语言（DSL，Demain Specific Language）来声明项目设置，摒弃了 XML（如 ANT 和 Maven）的各种繁琐配置。
3） 项目中一般会出现2个或者多个 build.gradle 文件，一个在根目录下，一个在 app 目录下。
如果切换到 Android 模式下则全部在 Gradle Scripts。
1. 根目录下的 build.gradle
1） repositories 闭包，声明了 jcenter() 的配置；
2） dependencies 闭包，声明了一个 Gradle 插件。
1 buildscript {
2
3 repositories { //repositories闭包
4 google()
5 jcenter() //代码托管库：设置之后可以在项目中轻松引用jcenter上的开源项目
6 }
7 dependencies { //dependencies闭包
8 classpath 'com.android.tools.build:gradle:3.0.0' ////声明gradle插件，插件版本号为3.0.0
9 //gradle是一个强大的项目构建工具，不仅可以构建Android，还可以构建java，C++等
10 //此处引用android的插件
11 // NOTE: Do not place your application dependencies here; they belong
12 // in the individual module build.gradle files
13 }
14 }
15
16 allprojects {
17 repositories {
18 google()
19 jcenter() //代码托管库：设置之后可以在项目中轻松引用jcenter上的开源项目
20 }
21 }
22
23 task clean(type: Delete) {
24 delete rootProject.buildDir
25 }
2. app 目录下的build.gradle
1） apply plugin，声明是 Android 应用程序还是库模块；
2） android 闭包，配置项目构建的各种属性，compileSDKVersion 用于指定项目的变异 SDK 版本， buildToolsVersion 用户指定项目构建工具的版本。
◆ defaultConfig 闭包：默认配置、应用程序包名、最小sdk版本、目标sdk版本、版本号、版本名称；
◆ buildTypes 闭包：指定生成安装文件的配置，是否对代码进行混淆；
◆ signingConfigs 闭包：签名信息配置；
◆ sourceSets 闭包：源文件路径配置；
◆ lintOptions 闭包：lint 配置；
3） dependencies 闭包，指定当前项目的所有以来关系，本地以来，库依赖以及远程依赖；
4） repositories 闭包，仓库配置。
1 // 声明是Android程序，
2 // com.android.application 表示这是一个应用程序模块,可直接运行
3 // com.android.library 标识这是一个库模块，是依附别的应用程序运行
4 apply plugin: 'com.android.application'
5
6 android {
7 // 程序在编译的时候会检查lint，有任何错误提示会停止build，我们可以关闭这个开关
8 lintOptions {
9 // 即使报错也不会停止打包
10 abortOnError false
11 // 打包release版本的时候是否进行检测
12 checkReleaseBuilds false
13 }
14
15 // 编译sdk的版本，也就是API Level，例如API-19、API-20、API-21等等。
16 compileSdkVersion 27
17 // build tools的版本，其中包括了打包工具aapt、dx等等。
18 // 这个工具的目录位于你的sdk目录/build-tools/下
19 buildToolsVersion '27.0.3'
20
21 //关闭Android Studio的PNG合法性检查
22 aaptOptions.cruncherEnabled = false
23 aaptOptions.useNewCruncher = false
24
25 defaultConfig { // 默认配置
26 applicationId "com.demo.test" // 应用程序的包名
27 minSdkVersion 22 / 最小sdk版本，如果设备小于这个版本或者大于maxSdkVersion将无法安装这个应用
28 targetSdkVersion 27 // 目标sdk版本，充分测试过的版本（建议版本）
29 versionCode 1 // 版本号，第一版是1，之后每更新一次加1
30 versionName "1.0" // 版本名，显示给用户看到的版本号
31
32 archivesBaseName = "demo-$versionName" // 指定打包成Jar文件时候的文件名称
33 ndk {
34 moduleName "testwifisafe" // 设置库(so)文件名称
35 ldLibs "log", "z", "m", "jnigraphics", "android"
36 // 引入库，比如要用到的__android_log_print
37 abiFilters "armeabi", "x86", "armeabi-v7a" // "x86" 显示指定支持的ABIs
38 cFlags "-std=c++11 -fexceptions" // C++11
39 stl "gnustl_static"
40 }
41
42 // 当方法数超过65535(方法的索引使用的是一个short值，
43 // 而short最大值是65535)的时候允许打包成多个dex文件，动态加载dex。这里面坑很深啊
44 multiDexEnabled true
45
46 // Instrumentation单元测试
47 testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
48 }
49
50 // 默认的一些文件路径的配置
51 sourceSets {
52 main {
53 manifest.srcFile 'AndroidManifest.xml' // 指定清单文件
54 res.srcDirs = ['res'] // 指定res资源目录
55 assets.srcDirs = ['assets'] // asset资源目录
56 jni.srcDirs 'src/main/jni' // jni代码目录
57 jniLibs.srcDir 'src/main/jniLibs' // jni库目录
58 java.srcDirs = ['src'] // 指定java源代码目录
59 resources.srcDirs = ['src'] // 指定resource目录
60 aidl.srcDirs = ['src'] // 指定aidl目录
61 renderscript.srcDirs = ['src'] // 指定source目录
62 }
63 debug.setRoot('build-types/debug') // 指定debug模式的路径
64 release.setRoot('build-types/release') // 指定release模式的路径
65 }
66
67 // multiDex的一些相关配置，这样配置可以让你的编译速度更快
68 dexOptions {
69 // 让它不要对Lib做preDexing
70 preDexLibraries = false
71 // 开启incremental dexing,优化编译效率，这个功能android studio默认是关闭的。
72 incremental true
73 javaMaxHeapSize "4g" // 增加java堆内存大小
74 }
75
76 signingConfigs {// 签名配置
77 release {// 发布版签名配置
78 storeFile file("fk.keystore") // 密钥文件路径
79 storePassword "123456" // 密钥文件密码
80 keyAlias "fk" // key别名
81 keyPassword "123456" // key密码
82 }
83 debug {// debug版签名配置
84 storeFile file("fk.keystore")
85 storePassword "123456"
86 keyAlias "fk"
87 keyPassword "123456"
88 }
89 }
90
91 // 指定生成安装文件的配置，常有两个子包:release,debug，注：直接运行的都是debug安装文件
92 buildTypes {
93 // release版本的配置，即生成正式版安装文件的配置
94 release {
95 zipAlignEnabled true // 是否支持zip
96 shrinkResources true // 移除无用的resource文件
97 minifyEnabled false // 是否对代码进行混淆，true表示混淆
98 // 指定混淆时使用的规则文件；
99 // proguard-android.txt指所有项目通用的混淆规则，proguard-rules.pro当前项目特有的混淆规则
100 // release的Proguard默认为Module下的proguard-rules.pro文件
101 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
102 debuggable false //是否支持调试
103 //ndk的一些配置
104 ndk {
105 // cFlags "-std=c++11 -fexceptions -O3 -D__RELEASE__" // C++11
106 // platformVersion = "19"
107 moduleName "hebbewifisafe" // 设置库(so)文件名称
108 ldLibs "log", "z", "m", "jnigraphics", "android"
109 // 引入库，比如要用到的__android_log_print
110 abiFilters "armeabi", "x86", "armeabi-v7a"// "x86"
111 cFlags "-std=c++11 -fexceptions" // C++11
112 stl "gnustl_static"
113 }
114 // 采用动态替换字符串的方式生成不同的 release.apk （3.0之后版本的修改方式）
115 applicationVariants.all { variant ->
116 variant.outputs.all { output ->
117 if (!variant.buildType.isDebuggable()) {
118 // 获取签名的名字 variant.signingConfig.name
119 // 要被替换的源字符串
120 def sourceFile = "app-release";
121 // 替换的字符串
122 def replaceFile = "Demo-V${variant.versionName}.${releaseTime()}"
123 outputFileName = output.outputFile.name.replace(sourceFile, replaceFile)
124 }
125 }
126 }
127 jniDebuggable false // 关闭jni调试
128 }
129 debug { // debug版本的配置
130 minifyEnabled false
131 zipAlignEnabled true
132 shrinkResources true // 移除无用的resource文件
133 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
134 debuggable true
135 // jniDebuggable true
136 ndk {
137 cFlags "-std=c++11 -fexceptions -g -D __DEBUG__" // C++11
138 }
139 jniDebuggable true
140 }
141 }
142
143 packagingOptions {
144 exclude 'META-INF/ASL2.0'
145 exclude 'META-INF/LICENSE'
146 exclude 'META-INF/NOTICE'
147 exclude 'META-INF/MANIFEST.MF'
148 }
149
150 compileOptions {
151 // 在这里你可以进行 Java 的版本配置，
152 // 以便使用对应版本的一些新特性
153 }
154 productFlavors {
155 // 在这里你可以设置你的产品发布的一些东西，
156 // 比如你现在一共软件需要发布到不同渠道，
157 // 且不同渠道中的包名不同，那么可以在此进行配置；
158 // 甚至可以设置不同的 AndroidManifest.xml 文件。
159 hebbe {
160 }
161 googlePlay {
162 }
163 solo {
164 }
165 }
166 productFlavors.all {
167 flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
168 }
169 // 所谓ProductFlavors其实就是可定义的产品特性，
170 // 配合 manifest merger 使用的时候就可以达成在一次编译
171 // 过程中产生多个具有自己特性配置的版本。
172 // 上面这个配置的作用就是，为每个渠道包产生不同的 UMENG_CHANNEL_VALUE 的值。
173 }
174
175 // 指定当前项目的所有依赖关系：本地依赖、库依赖、远程依赖
176 // 本地依赖：可以对本地 Jar 包或目录添加依赖关系
177 // 库依赖：可以对项目中的库模块添加依赖关系
178 // 远程依赖：可以对 jcenter 库上的开源项目添加依赖
179 // 标准的远程依赖格式是 域名:组织名:版本号
180 dependencies {
181 implementation fileTree(dir: 'libs', include: ['*.jar']) // 本地依赖
182 // 远程依赖，com.android.support是域名部分，appcompat-v7是组名称，26.1.0是版本号
183 implementation 'com.android.support:appcompat-v7:26.1.0'
184 implementation 'com.android.support.constraint:constraint-layout:1.0.2'
185 implementation project(':hello') // 库依赖
186 testImplementation 'junit:junit:4.12' // 声明测试用列库
187 androidTestImplementation 'com.android.support.test:runner:1.0.1'
188 androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
189 }
190
191 // 声明是要使用谷歌服务框架
192 apply plugin: 'com.google.gms.google-services'
193
194 // 第三方依赖库的本地缓存路径
195 task showMeCache << {
196 configurations.compile.each { println it }
197 }
198 // 使用maven仓库。android有两个标准的library文件服务器，一个jcenter一个maven。两者毫无关系。
199 // jcenter有的maven可能没有，反之亦然。
200 // 如果要使用jcenter的话就把mavenCentral()替换成jcenter()
201 repositories {
202 mavenCentral()
203 }
204
205 // 获取日期方法
206 def releaseTime() {
207 return new Date().format("MMdd.HHmm")
208 }
