Android Gradle中的productFlavors

Posted 好人静

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Android Gradle中的productFlavors相关的知识,希望对你有一定的参考价值。

目录

前言

一 productFlavors

1.productFlavors基本使用

 2. productFlavors的variants输出

二 productFlavors应用场景

三 总结


目录

前言

一 productFlavors

1.productFlavors基本使用

 2. productFlavors的variants输出

二 productFlavors应用场景

三 总结


前言

        前段时间在研究android自定义插件的一系列内容(具体见 Android 自定义Gradle插件的多层属性扩展(五))的时候 ,接触到android{}中的productFlavors该扩展属性,觉得很有意思,简单的总结下。

一 productFlavors

        productFlavors是android{}中的一个扩展属性,主要用来让同一套代码可以打包成不同的apk包,又可以成为变体(Variants)。其实该productFlavors属性是与buildTypes配合使用的,后面会列举。先从一个实例中来看下这个扩展属性怎么用。

1.productFlavors基本使用

        通常使用productFlavors{}可以使用一套代码来产生多个apk包,例如多渠道打包。

  • (1)在AndroidManifest中添加一个<meta-data>

        添加该<meta-data>用来标记多渠道,代码如下:

        <!--设置多渠道-->
        <meta-data
            android:name="channel"
            android:value="${CHANNEL}" />
  •  (2)在build.gradle中添加该productFlavors{}

        在app下的build.gradle中通过productFlavors为AndroidManifest中的meta-data赋值,代码如下:

//特色产品:同一套代码生产出不同特色的产品
    flavorDimensions "channel"
    productFlavors {
        huawei {
            manifestPlaceholders = [CHANNEL: "huawei"]
            dimension = "channel"
        }

        oppo {
            manifestPlaceholders = [CHANNEL: "oppo"]
            dimension = "channel"
        }

        xiaomi {
            manifestPlaceholders = [CHANNEL: "xiaomi"]
            dimension = "channel"
        }

    }
}

        对于在productFlavors{}下面的每个闭包都是一个flavor,注意从Android Studio 3.0.0之后,在使用productFlavors{}的时候,必须为每个flavor设置一个dimension。这个dimension可以理解为对flavor进行分组,不同的dimension中的flavor会组合成一个变体variants。如果不设置dimension,则会在build输出窗口抛出下面异常:

All flavors must now belong to a named flavor dimension. Learn more at https://d.android.com/r/tools/flavorDimensions-missing-error-message.html

         进入到错误的提示链接中发现:

        

         第一句话明确说明需要给每一个flavor设置一个dimension。

        当然官网也给到解决方案:使用flavorDimensions定义dimension,即apk的维度;然后给到每个闭包flavor设置对应的dimension即可,如同所示:

        

          写在第一个的维度的优先级最高,最后会以所有维度的笛卡尔积来产生variant的数量,最后配合为每个variant添加buildTypes{}中的定义的类型,生成最后的variant。  对项目进行编译之后,可以看到在Build Variants窗口中就可以看到有6个variant。

        

        默认的在通过Android Studio的Run运行,只会产生一个apk,但是通过Generate Signed Bundle or APK,即如下窗口   

                    

        可以任意选择要生成签名的variant来进行打包签名。

        最后在代码中可以打印出该<meta-data>中的值,代码如下:

 private String getChannelFromAndroidManifest() {
        String metaChannel = "";
        try {
            ApplicationInfo info = getPackageManager().getApplicationInfo(getPackageName(), PackageManager.GET_META_DATA);
            if (info == null || info.metaData == null) {
                return metaChannel;
            }
            metaChannel = info.metaData.getString("channel");
        } catch (PackageManager.NameNotFoundException e) {
        }
        return metaChannel;
    }

        发现与在build.gradle中设置的值保持一致。具体的代码已经上传到至https://github.com/wenjing-bonnie/AndroidPlugin.git的app目录的相关内容。因为逐渐在这基础上进行迭代,可回退到Gradle_5.0.1该tag下可以查看相关内容。

 2. productFlavors的variants输出

        其实在Android Gradle提供了对应的api来将输出所有的variant变体的信息,在项目配置完成之后,可以通过this.android.applicationVariants.all将所有的variants的信息输出,例如name:


this.afterEvaluate {
    this.android.applicationVariants.all { variant ->
        println(prefix + "name = " + variant.name)
    }
}

        通过Android Studio编译项目,发现Build输出窗口会输出每个variant的name,如下:

@@@@@@@@@@@@@@ app @@@@@@@@@@@@@   name = huaweiDebug
@@@@@@@@@@@@@@ app @@@@@@@@@@@@@   name = oppoDebug
@@@@@@@@@@@@@@ app @@@@@@@@@@@@@   name = xiaomiDebug
@@@@@@@@@@@@@@ app @@@@@@@@@@@@@   name = huaweiRelease
@@@@@@@@@@@@@@ app @@@@@@@@@@@@@   name = oppoRelease
@@@@@@@@@@@@@@ app @@@@@@@@@@@@@   name = xiaomiRelease

二 productFlavors应用场景

        前面主要总结了productFlavors的一个基本使用,那么在Android开发中productFlavors可以用来做什么呢?

  • 1.同一套代码维护了面向不同用户的apk

        像一个APK可以打包成一个debug版本和一个release版本,需要在一个手机上同时安装这两个apk。我们知道对于这两个apk如果包名一致的话,肯定会相互覆盖,那么就可以采用productFlavors{}来为每个variant设置不同的applicationId,那么打包成的两个apk会共用同一套代码,但是包名不一致,所以可以同时安装在同一个手机上。相比较于1.productFlavors基本使用仅仅是将在不同的flavor闭包为不同的flavor设置"applicationId = xxxx"即可。

  • 2.多渠道打包

        像在1.productFlavors基本使用的例子就是设置的多渠道打包的方式,可以通过productFlavors{}对<meta-data> 设置不同的渠道值。

  • 3.针对不同的手机设置不同的应用icon、文字或其他信息

       像Android各大手机厂商,有自己的手机系统的应用icon的样式,那么就可以通过 productFlavors{}来设置不同的icon,其步骤大体如下:

        (1)按照在1.productFlavors基本使用设置好不同的渠道标识;

        (2)在项目的src的同级目录右击src目录,选择New Resource Directory ,在弹出的对话框中选择src/huawei/res依次新建放置icon的不同的资源包,如图所示:

              

        创建之后的项目目录如下所示:

        ​​

         这样每个flavor会先读取本flavor对应的目录下读取对应的代码或者资源文件,如果没有的话,才会去main目录下进行查找。这样在Build Variants的窗口中选择huaweiDebug,运行到手机中,发现对应的icon已经更换

          具体的代码已经上传到至https://github.com/wenjing-bonnie/AndroidPlugin.git的app目录的相关内容。因为逐渐在这基础上进行迭代,可回退到Gradle_5.0.1该tag下可以查看相关内容。

        对于其他内容如代码、文案等的修改同样如此。

  • 4.简单的不同flavor值的设置

        像在 1.productFlavors基本使用使用的通过<meta-data>设置一个简单的字符串,在代码中取需要比较多的代码,才可以获取到该值,其实如果仅仅是简单的设置一些值的区别,可以直接使用buildConfigField来设置即可,代码如下:

productFlavors {

        huawei {
            manifestPlaceholders = [CHANNEL: "huawei"]
            dimension = "channel"
            buildConfigField("String","CHANNEL","\\"huawei\\"")
        }

        oppo {
            manifestPlaceholders = [CHANNEL: "oppo"]
            dimension = "channel"
            buildConfigField("String","CHANNEL","\\"oppo\\"")
        }

        xiaomi {
            manifestPlaceholders = [CHANNEL: "xiaomi"]
            dimension = "channel"
            buildConfigField("String","CHANNEL","\\"xiaomi\\"")
        }
    }

        而在代码中只需要通过BuildConfig.CHANNEL就可以取得设置的渠道值。

  • 5.对variant进行不同的处理

        在前面的 2. productFlavors的variants输出可以通过this.android.applicationVariants.all将所有的variants输出,那么就可以针对不同的variants来进行单独处理。例如可以得到每个variant的Task,针对所需的Task进行Hook,如图所示:

        

        代码如下:

this.afterEvaluate {
    //当前variant的类型为application类型
    this.android.applicationVariants.all { ApplicationVariant variant ->
        println(prefix + "name = " + variant.name)
        //得到每个variant中的task,然后进行对Task进行hook
        variant.getAssembleProvider().get().doFirst {
            println(prefix + " assemble task do first ")
        }
    }
}

三 总结

productFlavors{}主要用来针对一套代码打包成多个有差异的apk。

  • 1.productFlavors{}下的每个闭包就是一个flavor,也可称为变体variant;
  • 2.定义一个variant,需要设定dimension。需要通过flavorDimensions来定义dimension;
  • 3.每个dimension称为一个分组,多个不同的dimension通过笛卡尔积的形式得到一个variant,最后结合buildTypes{}里面配置的项,形成最终的variant
  • 4.如果只是简单的逻辑的差异,可以通过BuildConfigField进行设置差异,当然可以通过<meta-data>的形式来设置差异;
  • 5.对于每个variant在main的同级目录下都有一个对应的资源目录和代码目录,在打包成apk的时候,首先会读取对应的variant的相应目录,没有的话再去读取main下的目录内容;
  • 6.可通过this.android.applicationVariants.all在项目配置完成之后,得到所有的variants,每个variant是一个ApplicationVariant,可以得到该variant中的task、name等信息

           加油,越来越好玩了。

以上是关于Android Gradle中的productFlavors的主要内容,如果未能解决你的问题,请参考以下文章

Android Gradle 插件build.gradle 中的 android 配置 ( 配置项 | compileSdkVersion 配置 | buildToolsVersion 配置 )

React Native:build.gradle 文件中的 Android Gradle Plugin 和 Android Studio 有啥区别?

gradle build 未检测到 build.gradle 中的 android ndkVersion

Android Gradle 插件Gradle 依赖管理 ② ( build.gradle 中的 dependencies 依赖配置 | DependencyHandler#add 方法介绍 )

Gradle,Gradle 包装器在 Android Studio 中的不同实例 by ionic cordova

Android Gradle 插件Gradle 构建机制 ① ( 空白工程 Gradle 构建文件 | IntelliJ IDEA 工程构建文件 | Android Studio 工程构建文件 )