build.gradle文件常用技巧

manifestPlaceholders的一些坑

在新版本的AndroidStudio中，为Gradle新增了多渠道打包的简便方法，比如在使用友盟统计的时候，需要为每个渠道配置 UMENG_APPKEY 和 UMENG_CHANNEL ,其中appkey是固定的，但每个渠道的channel值是不同的，因此我们可以这样写：

AndroidManifest.xml：


<meta-data
        android:name="UMENG_APPKEY"
        android:value="${UMENG_APPKEY_VALUE}" />
<meta-data
        android:name="UMENG_CHANNEL"
        android:value="${UMENG_CHANNEL_VALUE}" />

–

build.gradle:
android {  
 defaultConfig {
  manifestPlaceholders = [UMENG_CHANNEL_VALUE : "umeng"]
  manifestPlaceholders = [UMENG_APPKEY_VALUE : "appkey"]
 }
 productFlavors {
  meizu {}
  wandoujia {}
  ……
 }  
 productFlavors.all { 
  flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] 
 }
}

当我们执行 ./gradlew assembleWandoujiaRelease 命令后会打出豌豆荚的Release包，其中UMENG_CHANNEL为productFlavors.all里执行出来的 wandoujia，UMENG_APPKEY为defaultConfig里设置的appkey。

如果我们的项目meta-data只有以上两个，当然没问题，但有时候我们可能会有多个AndroidManifest.xml 里的值想在build.gradle里动态提供，比如我想增加有米广告，它需要一个 YOUMI_CHANNEL ，很简单，多添加一个manifestPlaceholders不就可以了吗，那如果我的 defaultConfig 里这样写：

   manifestPlaceholders = [UMENG_CHANNEL_VALUE : "umeng"]
   manifestPlaceholders = [YOUMI_CHANNEL_VALUE : "channel"]
   manifestPlaceholders = [UMENG_APPKEY_VALUE : "appkey"]

你会发祥这时运行项目会报错： Error:(74, 13) Attribute meta-data#YOUMI_CHANNEL@value at AndroidManifest.xml:74:13 requires a placeholder substitution but no value for <YOUMI_CHANNEL_VALUE> is provided. 这个问题严重了，他居然说YOUMI_CHANNEL_VALUE没有被赋值，why？这里不谈gradle语法，如果你对其它预言语法了解的话，你会很容易想到[]是数组的符号，因此，上面defaultConfig的写法，会将后面的覆盖前面的数组，其实最后只相当于执行了 manifestPlaceholders = [UMENG_APPKEY_VALUE : "appkey"] ，那问题继续来了，为什么UMENG_CHANNEL_VALUE 就没有抛出错误呢？那是因为我们在productFlavors.all 里执行了 flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] ,这里的flavor.manifestPlaceholders与defaultConfig是合并的关系，而不是覆盖。

那既然知道问题，如果我想在defaultConfig定义多个默认值，怎么解决呢？很简单，和其它语言的数组声明类似，改成以下即可:

 manifestPlaceholders = [UMENG_CHANNEL_VALUE : "umeng",
                         UMENG_APPKEY_VALUE : "appkey",
                         YOUMI_CHANNEL_VALUE : "value"
                        ]

如何隐藏隐私的配置信息

现在的开源爱好者很多，如果我们将umeng的appkey连同一起开源出去，势必会引来一些麻烦，所以在build.gradle文件里隐藏一些比较私密的配置信息就显得尤为重要。在用androidStudio新建完项目之后，我们会发现根目录下有一个local.properties 文件，并且我们还会发现在 .gitignore 文件里以默认将其忽略添加到版本库，因此，我们的解决办法可以这样:将私密信息写在local.properties 文件里， build.gradle 文件里在读取配置文件。示例如下:

build.gradle:

apply plugin: 'com.android.application'

Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream()) android { ……省略很多 manifestPlaceholders = [UMENG_CHANNEL_VALUE : "umeng", UMENG_APPKEY_VALUE : properties.getProperty("umengAppKey"), ] 

–

local.properties：

sdk.dir=/Users/lanyy/Documents/adt/sdk
umengAppKey=************* 

这样，即使我们将项目开源出去，由于 local.properties 文件是没有公开的，被人也就无法拿到我们隐藏的值。因此就保护了我们的私密信息。