【Android Gradle 插件】ProductFlavor 配置 ( ProductFlavor#vectorDrawables 配置 )

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.

一、ProductFlavor#vectorDrawables 配置

---

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

ProductFlavor#vectorDrawables 配置 , 用于配置当前 Android 工程的 SVG 支持 ;

vectorDrawables 配置是 VectorDrawablesOptions 类型的 , 参考文档 https://google.github.io/android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.VectorDrawablesOptions.html ;

VectorDrawablesOptions 有两个配置项 ,

Set<String> generatedDensities 配置 :

在构建时从矢量绘图生成PNG时使用的密度。要生成PNG，最小SDK必须低于21。
如果设置为空集合，将禁用对向量可提取项的所有特殊处理。

Boolean useSupportLibrary 配置 : 设置 true 时 , 运行时支持 ; Google 提供了一个兼容包 , 如果开启了该选项 , 则会自动引入 SVG 支持兼容包 ; 并且 svg 图片不再生成 png 格式的图片 ;

是否对矢量绘图使用运行时支持，而不是构建时支持。

参考文档链接 : https://google.github.io/android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.ProductFlavor.html#com.android.build.gradle.internal.dsl.ProductFlavor:vectorDrawables

使用示例 :

• 设置了 generatedDensities 配置后, 如果 minSdkVersion 小于 21, 则在编译后会在 mdpi 对应的图片资源目录中生成 svg 对应的 png 图片 ;
• 设置了 useSupportLibrary 配置后 , 默认为 false , 如果设置为 true , 则引入 SVG 兼容包 , 忽略上面生成 png 图片的配置 ;

android {
    
    
    compileSdkVersion 31
    buildToolsVersion "30.0.3"

    defaultConfig {
    
    
        applicationId "kim.hsl.websocketdemo"
        minSdkVersion 18
        targetSdkVersion 31
        versionCode 1
        versionName "1.0"

        applicationIdSuffix "tom"
        versionNameSuffix "9527"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

        vectorDrawables {
    
    
            // 设置了该配置后, 如果 minSdkVersion 小于 21,
            // 则在编译后会在 mdpi 对应的图片资源目录中生成 svg 对应的 png 图片
            generatedDensities "mdpi"

            // 引入 SVG 兼容包 , 忽略上面生成 png 图片的配置
            useSupportLibrary true
        }
    }
}