1.动态配置 AndroidManifest 文件
- 顾名思义就是可以在构建的过程中,动态修改AndroidManifest文件中的一些内容。例如友盟等。
xml文件中:
<meta-data android:value="${UMENG_CHANNEL}" android:name="UMENG_CHANNEL"/>
gradle 文件中:
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
productFlavors{
google{
mainfestPlaceholders.put("UMENG_CHANNEL","google")
}
baidu{
mainfestPlaceholders.put("UMENG_CHANNEL","baidu")
}
}
//name就是每个渠道的名字
productFlavors.all{ flavor ->
mainfestPlaceholders.put("UMENG_CHANNEL",name)
}
}
mainfestPlaceholders是 ProductFlavor 的一个属性,是一个 Map 类型,所以我们可以同时配置很多个占位符。
通过 all 函数遍历每一个productFlavor,然后把它们的那么作为友盟中渠道的名字。
Android Gradle 提供的mainfestPlaceholders占位符的应用方式,让我们可以替换AndroidManifest文件中任何${var}格式的占位符。
2.自定义你的 BuildConfig
- BuildConfig是自动生成的不能修改,它是由 Android Gradle 构建脚本编译后生成的。
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
productFlavors{
google{
buildConfigFiled'String','WEB_URL','"http://www.google.com"'
}
baidu{
buildConfigFiled'String','WEB_URL','"http://www.baidu.com"'
}
}
}
}
buildConfigFiled(String type,String name,String value)让我们可以添加自己的常量到BuildConfig 中。
第一个参数type是要生成的字段的类型,第二个参数 name 是要生成的常量名字,第三个参数 value 是要生成字段的常量。
value 这个参数,是单引号中间的部分,尤其对于 String 类型的值,里面的双引号一定不能省略。
3.动态添加自定义资源
- resValue 方法有 3 个参数:第一个是 type,也就是你要的资源类型,比如有 string、id、bool 等;第二个是 name,也就是你要定义资源的名称;第三是 value 就是你要定义资源的值。
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
productFlavors{
google{
resValue'string','channel_tips','google 渠道欢迎您'
}
baidu{
resValue'string','channel_tips','baidu 渠道欢迎您'
}
}
}
}
- 这和我们在 res/values 这个文件夹定义的 xml 文件的格式是一样的,只不过我们通过 Gradle 配置。
4.Java 编译选项
- 有时候需要对我们的Java 源文件的编码、源文件使用的 JDK版本等进行调优修改。比如需要配置源文件的编码为 UTF-8 的编码,以兼容更多的字符。
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
compileOptions{
encoding = 'utf-8'
sourceCompatibility = JavaVersion.VERSION_1_6
targetCompatibility = JavaVersion.VERSION_1_6
}
}
Android 对象提供了一个compileOptions方法,它接受一个CompileOptions类型的闭包作为参数,来对 Java 编译选项进行配置。
CompileOptions是编译配置,它提供了 3 个属性,分别是 encoding、sourceCompatibility、targetCompatibility,通过对它们
进行设置来配置 Java 相关的编译选项。
5.adb操作选项配置
adb,它是一个 Android Debug Bridge,用于连接我们的 Android 手机进行一些操作,比如调试 apk、安装 apk、复制文件到手机等。
在 Android Gradle 中,预留了对 adb 的一些选项的控制配置,它就是 adbOptions{}闭包,它和 compileOptions一样也是 Android 的一个方法。
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
adbOptions{
timeOutInMs = 5*1000 //秒
installOPtions = '-r','-s'
}
}
第一种对timeOutInMs的设置采用属性的方式,第二种对installOPtions的设置采用方法的方式。
timeOutInMs 它是设置超时时间的,单位是毫秒,这个超时时间是执行 adb 这个命令的超时时间。有时候我们安装、运行或者调试的时候,可能会遇到 CommandRejectException 这样的异常,这个一般是当我们执行一个命令的时候,在规定的 时间内没有返回结果,我们可以把超时设置长一些。记住,它的单位是毫秒。
installOPtions 它是用来设置 adb install安装这个操作的设置项。比如要安装到 SD 上,还是要替换安装等。
adb install 有 l、r、t、s、d、g 六个选项。
l:锁定该应用程序
r:替换已存在的应用程序,也就是我们说的强制安装
t:允许测试包
s:把应用程序安装到 SD 卡上
d:允许进行降级安装,也就是安装的程序比手机上带的版本低
g:为该应用授予所有运行时的权限
6.DEX操作选项配置
Android 中的Java 源码被编译成 class 字节码后,在打包成 apk 的时候又被 dx 命令优化成 Android 虚拟机可执行的 Dex 文件。
Android 默认给 dx 分配的内存是 1024M
Android Gradle 插件提供了 dexOptions{}闭包,让我们可以对 dx 操作进行一些配置。
dexOptions{}是一个DexOptions类型的闭包,它的配置都是有DexOptions提供的。
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
dexOptions{
incremental true
javaMaxHeapSize '4g'
jumboMode true
}
}
incremental 属性,这是一个 boolean 类型的属性,用来配置是否启用 dx 的增量模式,默认值是 false,表示不启用。增量的模式虽然速度更快一些,但目前还是有很多限制,也可能会不工作,所以要慎用。
javaMaxHeapSize 属性,它是配置执行 dx 命令时为其分配的最大堆内存,主要用来解决执行 dx 时内存不够用的情况。它接受一个字符串格式的参数,比如 1024MB,代表 1GB。
jumboMode 属性,boolean 类型,它可以用来配置是否开启 jumbo 模式。有时候我们的程序项目工程比较大,代码太多,函数超过 65535 个,那么就需要强制开启 jumbo 模式才可以构建成功。
preDexLibraries 属性,boolean 类型,用来配置是否预执行 dex Libraries 库工程,开启后会大大提高增量的构建速度,不过这可能会影响 clean 构建速度。默认值为 true,是开启的。
- threadCount 属性,它是 integer 类型,用来配置 Android Gradle 运行 dx 命令时使用的线程数量,适当的线程数量可以提高 dx 的效率。
android{
compileSdkVersion 23
buildToolsVersion "23.0.1"
dexOptions{
threadCount 2
}
}
7.多项目构建
dimension是 ProductFlavor 的一个属性,接受一个字符串,作为该ProductFlavor的维度。
flavorDimensions 使我们使用的 android{}里的方法,它和ProductFlavors{}是平级的,一定要先使用flavorDimensions声明维度,才能在ProductFlavors中使用。
android{
flavorDimensions "abi","version"
productFlavors{
free {
dimension 'version'
}
paid {
dimension 'version'
}
x86 {
dimension 'version'
}
arm {
dimension 'version'
}
}
}
-
示例中的 abi 和 version,现在构建产物 (variant)= BuildType+Abi+Version 所以会生成如下的 variant:
ArmFreeDebug
ArmFreeRelease
ArmPaidDebug
ArmPaidReleaseX86FreeDebug
X86FreeRelease
X86PaidDebug
X86PaidRelease 这种我们只根据维度去分组、去配置,剩下的让 Android Gradle 帮我们组合产生结果的 variant,实现了共性配置,也就是模块化编程,维护起来也很方便。