美文网首页Android 其他技巧程序员Android知识
Android Gradle实用技巧(五) | 善用Androi

Android Gradle实用技巧(五) | 善用Androi

作者: 飞雪无情flysnow_org | 来源:发表于2017-03-30 19:43 被阅读2214次

    Android Gradle必备使用技巧,未完待续,欢迎关注公众号flysnow_org,第一时间看后续技巧。

    占位符,其实是一个可以被替换的临时标记,比如${name},我们就可以使用真实的name变量的值替换这个占位符,达到可以动态的修改这个占位符的目的。所以AndroidManifest文件的占位符,其实是帮助我们动态修改AndroidManifest文件里的内容,这样的例子非常多,比如我们使用友盟等第三方分析统计的时候,会要求我们在AndroidManifest文件中指定渠道名称。

    <meta-data android:value="Channel ID" android:name="UMENG_CHANNEL"/>
    

    示例中的Channel ID我们要替换成不同渠道的名称,比如google,baidu,miui等等。

    对于这种情况我们不可能定义很多个AndroidManifest文件,因为这种工作繁琐,而且维护麻烦,所以我们就需要在构建的时候,根据我们正在生成的不同渠道包来为其指定不同的渠道名,对于这种情况Android Gradle为我们提供了非常便捷的方法让我们来替换AndroidManifest文件中的内容,它就是ManifestPlaceholder,Manitest占位符。

    manifestPlaceholders是ProductFlavor的一个属性,他是一个Map<String, Object>类型,所以我们可以同时配置很多个占位符。下面我们就通过这个配置渠道号的例子来演示manifestPlaceholders的用法。

    android {
        compileSdkVersion 23
        buildToolsVersion "23.0.1"
    
        productFlavors {
            google {
                manifestPlaceholders.put("UMENG_CHANNEL","google")
            }
            baidu {
                manifestPlaceholders.put("UMENG_CHANNEL","baidu")
            }
        }
    }
    

    例子中我们定义了两个渠道google和baidu,并且配置了他们的manifestPlaceholders。留意我们的使用方式,他们的Key都是一样的,是UMENG_CHANNEL,这个key就是我们在AndroidManifest文件中的占位符变量,在构建的时候,它会把AndroidManifest文件文件中所有占位符变量为UMENG_CHANNEL的内容替换为我们manifestPlaceholders中对应的value值。我们看AndroidManifest文件中具体的使用:

    <?xml version="1.0" encoding="utf-8"?>
    <manifest package="org.flysnow.app"
              xmlns:android="http://schemas.android.com/apk/res/android">
    
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@android:style/Theme.Black">
            <meta-data android:value="${UMENG_CHANNEL}" android:name="UMENG_CHANNEL"/>
            <activity
                android:name=".MainActivity"
                android:label="@string/title_activity_main">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN"/>
    
                    <category android:name="android.intent.category.LAUNCHER"/>
                </intent-filter>
            </activity>
        </application>
    
    </manifest>
    

    看到以上示例中的meta-data标签了吗?其中${UMENG_CHANNEL}就是一个占位符,它的变量名是UMENG_CHANNEL。构建的时候${UMENG_CHANNEL}将会被替换为google或者baidu。

    现在我们运行./gradlew app:assembleBaiduRelease,打一个百度渠道的包,然后通过apktool反编译,可以看到AndroidManifest文件中的${UMENG_CHANNEL}已经被替换为了baidu。

    <?xml version="1.0" encoding="utf-8" standalone="no"?>
    <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="org.flysnow.app" platformBuildVersionCode="23" platformBuildVersionName="6.0-2438415">
        <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:supportsRtl="true" android:theme="@android:style/Theme.Black">
            <meta-data android:name="UMENG_CHANNEL" android:value="baidu"/>
            <activity android:label="@string/title_activity_main" android:name="org.flysnow.app.MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN"/>
                    <category android:name="android.intent.category.LAUNCHER"/>
                </intent-filter>
            </activity>
        </application>
    </manifest>
    

    通过以上方式我们就可以动态的配置我们的渠道,非常方便,但是这里也有一个问题,就是我们渠道非常多的时候呢?在中国,你们懂的,一个App很随意的就有几十个渠道需要发布,我们总不能一个个的配置吧,太多也太累,维护也麻烦。假如我们的友盟的渠道名和我们在Android Gradle中配置的ProductFlavor一样的话就简单了,我们可以通过迭代productFlavors批量的方式进行修改。

    android {
        compileSdkVersion 23
        buildToolsVersion "23.0.1"
    
        productFlavors {
            google {
            }
            baidu {
            }
        }
    
        productFlavors.all { flavor ->
            manifestPlaceholders.put("UMENG_CHANNEL",name)
        }
    }
    

    我们通过all函数遍历每一个ProductFlavor,然后把他们的name作为我们友盟中渠道的名字,非常方便,这里不止可以做这一个事情,在遍历ProductFlavor的时候,你可以做很多你想做的事情,这就是Gradle的灵活之处,把脚本当成程序写。

    Android Gradle为我们提供的manifestPlaceholders占位符的方式,让我们可以替换AndroidManifest文件中任何${Var}格式的占位符,所以它的使用场景不限于渠道名这一个,比如还有ContentProvider的auth的授权,或者其他动态想配置meta信息等等,灵活的运用它能帮助我们做很多事情,让我们的构建更灵活,更方便。

    Android Gradle必备使用技巧,未完待续,欢迎关注公众号flysnow_org,第一时间看后续技巧。

    扫码关注扫码关注

    相关文章

      网友评论

        本文标题:Android Gradle实用技巧(五) | 善用Androi

        本文链接:https://www.haomeiwen.com/subject/ysvsottx.html