【Android Gradle 插件】ProductFlavor 配置 ( AppExtension#variantFilter 过滤变体属性 )

韩曙亮

发布于 2023-03-30 15:09:46

5230

发布于 2023-03-30 15:09:46

文章被收录于专栏：韩曙亮的移动开发专栏

文章目录

一、AppExtension#variantFilter 过滤变体属性

Android Plugin DSL Reference 参考文档 :

文档主页 : https://google.github.io/android-gradle-dsl/2.3/
AppExtension ( build.gradle#android 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.AppExtension.html
build.gradle#android 模块配置文档 : android-gradle-dsl/2.3/com.android.build.gradle.AppExtension.html
ProductFlavor ( build.gradle#android#defaultConfig 配置 ) 文档 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.ProductFlavor.html
ProductFlavor#externalNativeBuild 配置 ( build.gradle#android#defaultConfig#externalNativeBuild 配置 ) : com.android.build.gradle.internal.dsl.ProductFlavor:externalNativeBuild
ExternalNativeBuildOptions ( build.gradle#android#defaultConfig#externalNativeBuild 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.ExternalNativeBuildOptions.html
NdkBuildOptions ( build.gradle#android#defaultConfig#externalNativeBuild#ndkBuild 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.NdkBuildOptions.html
CmakeOptions ( build.gradle#android#defaultConfig#externalNativeBuild#cmake 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.CmakeOptions.html
JackOptions ( build.gradle#android#defaultConfig#jackOptions 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.JackOptions.html
AnnotationProcessorOptions ( 注解处理器配置 ) ( build.gradle#android#defaultConfig#javaCompileOptions配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.AnnotationProcessorOptions.html
NdkOptions ( build.gradle#android#defaultConfig#ndk 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.NdkOptions.html
VectorDrawablesOptions ( build.gradle#android#defaultConfig#vectorDrawables 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.VectorDrawablesOptions.html
NDK 参考文档 : Add C and C++ Code to Your Project.

一、AppExtension#variantFilter 过滤变体属性

ProductFlavor ( build.gradle#android#defaultConfig 配置 ) 文档 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.ProductFlavor.html

build.gradle#android 模块配置文档 : android-gradle-dsl/2.3/com.android.build.gradle.AppExtension.html

AppExtension#variantFilter 属性的作用是 , 控制哪些变体需要被编译 ;

属性原型 :

Action<VariantFilter> variantFilter

文档链接 : AppExtension#variantFilter

在上一篇博客【Android Gradle 插件】ProductFlavor 配置 ( ProductFlavor#resValue 方法 | ProductFlavor#dimension 维度属性 ) 中 , 分析了 ProductFlavor#dimension 维度属性以及 AppExtension#flavorDimensionList 属性和 AppExtension#flavorDimensions 方法 ;

创建了

个维度

    // 创建 2 个维度
    flavorDimensions("tom", "jerry")

以及

个风味

    // 创建产品风味 , 打渠道包就是在这里实现
    productFlavors {
        alpha{
            // 此处可以指定 defaultConfig 配置
            // 如果不指定 , 则默认使用 defaultConfig 默认配置
            // 此处设置属性 , 可以覆盖 defaultConfig 配置
            dimension "tom"
        }
        beta{
            dimension "tom"
        }
        delta{
            dimension "jerry"
        }
        pro{
            dimension "jerry"
        }
    }

在 Build Variants 面板中 , 可以看到不同的打包配置 ;

AppExtension#variantFilter 过滤变体属性用法如下 :

在 build.gradle 的 " android " 层级下配置如下属性 , 遍历了一遍所有的变体 , 将包含 " alpha " 的变体都忽略 ;

    // 设置过滤 带 alpha 的变体
    variantFilter {
        variant ->
            variant.flavors.each {
                if(it.name.contains("alpha")) {
                    setIgnore(true)
                }
            }
    }

此时 , 在 " Build Variants " 面板中 , 已经过滤了带 " alpha " 的变体 ;