Android Gradle 高级自定义
1.动态配置AndroidManifest文件
动态配置AndroidManifest文件,也即是在构建过程中,动态修改AndroidManifest文件中的一些内容。这样的例子非常多,比如使用友盟等第三方分析统计的时候,会要求我们在AndroidManifest文件中指定渠道名称:
<meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
示例中的Channel ID我们要替换成不同渠道的名称,比如:baidu、yingyongbao等。
对于这种情况,Android Gradle提供了非常便捷的方法让我们来替换AndroidManifest文件中的内容,它就是manifestPlaceholder,Manifest占位符。
MainfestPlaceholders是ProductFlavor的一个属性,是一个Map类型,所以我们可以同时配置很多占位符。
配置如下:
android{
productFlavors{
baidu{
mainfestPlaceholders.put("UMENG_CHANNEL","baidu")
}
yingyongbao{
mainfestPlaceholders.put("UMENG_CHANNEL","yingyongbao")
}
}
}
上面我们已经定义了两个渠道baidu和yingyongbao,并且配置了它们的manifestPlaceholders。它们的key都是一样的,是UMENG_CHANNEL,这个key就是我们在AndroidManifest文件中的占位符变量。在构建的时候,它会把AndroidManifest文件中所有占位符变量为UMENG_CHANNEL的内容替换为manifestPlaceholders中对应的value值。
在AndroidManifest文件中的具体使用:
//多余的代码省略
...
<application
...
<meta-data android:value="@{UMENGT_CHANNEL}" android:name="UMENG_CHANNEL"/>
<activity>
…
</activity>
</application>
通过以上方式就可以动态配置我们的渠道,非常方便。但是这里也有 一个问题,就是我们的渠道非常多的时候维护就非常的麻烦了。我们配置的渠道占位符是在productFlavors,所以我们可以通过迭代productFlavors来自动的修改渠道的名称。
android{
productFlavors{
baidu{}
yingyongbao{}
}
productFlavors.all{flavor->
manifestPlaceholders.put("UMENG_CHANNEL",name)
}
}
我们通过all函数遍历每一个ProductFlavor,然后把它们的name作为友盟中渠道的名字,非常方便。在遍历ProductFlavor的时候,你可以做很多你想做的事情,这就是Gradle的灵活之处,把脚本当成程序写。
2.自定义BuildConfig
对于BuildConfig这个类,相信大家肯定都不会陌生,我们找到它,在源程序顶部会看到“Automatically generated file. DO NOT MODIFY”,意思就是“自动生成的代码,不能修改”。它是由Android Gradle构建脚本在编译后生成的,默认情况如下:
public final class BuildConfig {
public static final boolean DEBUG = Boolean.parseBoolean("true");
public static final String APPLICATION_ID = "com.danikula.videocache";
public static final String BUILD_TYPE = "debug";
public static final String FLAVOR = "";
public static final int VERSION_CODE = 21;
public static final String VERSION_NAME = "2.7.0";
}
DEBUG用于标记是debug模式还是release模式。剩下的还有包名、当前构建的类型是debug还是release、当前构建的渠道、当前的版本号以及版本号名称。它们都是常量,我们可以很方便的引用上面的参数BuildConfig.DEBUG,性能也非常高。
我们也可以自定义增加一些常量,动态配置它们的值,对此Android Gradle提供了buildConfigField(String type,String name,String value)让我们可以添加在即的常量到BuildConfig中。
现在我们用具体例子来演示它们的用法。假设我们有baidu和google两个渠道,发布的时候也会有这两个渠道包,但我们需要安装百度渠道包的时候打开的是Baidu的首页;当我们安装google渠道包的时候打开的是Google的首页。从这个思路分析,我们只需要添加一个字段INDEX_URL,在baidu渠道下它的值是 http://www.baidu.com,在Google渠道下它的值就是http://www.google.com,即可:
android{
productFlavors{
google{
buildConfigField ’String’ 'INDEX_URL' "http://www.google.com"
}
baidu{
buildConfigField ’String’ 'INDEX_URL' "[http://www.baidu.com](http://www.google.com)"
}
}
}
看上面的示例代码,我们定义baidu和google两个渠道,并分别为他们生成了相应的BuildConfig常量字段:
public static final String INDEX_URL = "http://www.baidu.com";
然后我们在代码中使用这个WEB_URL常量即可,在打包的时候,Android Gradle会帮我们自动生成不同的值。这里需要注意的是,value这个参数,是单引号中间的部分。尤其对于String类型的值,里面的双引号一定不能省略不然就会生成如下这样:
public static final String INDEX_URL = http://www.baidu.com;
构建的模式大概如下:
android{
buildTypes{
debug{
buildConfigField ’String’ ’name’ '"value"'
}
}
}
3.Java编译选项
有时候需要对Java源文件的编码、源文件使用的JDK版本等进行调优修改。比如需要配置源文件的编码为UTF-8的编码,以兼容更多的字符;还比如我们想配置编译Java源码的级别为1.6,这样就可以使用Override接口方法的继承等特性。为此Android Gradle提供了一个非常便捷的入口来让我们配置:
android{
compileOptions{
endoding='utf-8'
sourceCompatibility=JavaVersion.VERSION_1_6
targetCompatibility=JavaVersion.VERSION_1_6
}
}
targetCompatibility是配置生成的Java字节码的版本,其可选值和sourceCompatibility一样。