Android Gradle 高级自定义

2018-09-14  本文已影响7人  明明_白_白

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一样。

上一篇下一篇

猜你喜欢

热点阅读