Android Gradle 插件ProductFlavor 配置 ( ProductFlavor#jackOptions 配置 | javaCompileOptions 配置 )

Posted 2022-03-19 韩曙亮

文章目录

• 一、ProductFlavor#jackOptions 编译选项配置
• 二、ProductFlavor#javaCompileOptions 配置

Android Plugin DSL Reference 参考文档 :

• 文档主页 : https://google.github.io/android-gradle-dsl/2.3/

• AppExtension 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.AppExtension.html

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

• ProductFlavor 文档 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.ProductFlavor.html

• externalNativeBuild 配置 : com.android.build.gradle.internal.dsl.ProductFlavor:externalNativeBuild

• ExternalNativeBuildOptions 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.ExternalNativeBuildOptions.html

• NdkBuildOptions 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.NdkBuildOptions.html

• CmakeOptions 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.CmakeOptions.html

• JackOptions 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.JackOptions.html

• AnnotationProcessorOptions ( 注解处理器配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.AnnotationProcessorOptions.html

• NDK 参考文档 : Add C and C++ Code to Your Project.

一、ProductFlavor#jackOptions 编译选项配置

---

ProductFlavor 参考文档 : com.android.build.gradle.internal.dsl.ProductFlavor.html

ProductFlavor#jackOptions 配置的是编译选项 , 配置项的类型是 JackOptions 类型 ;

可设置的属性项 :

• additionalParameters : 额外参数 ;
• enabled : 是否开启 Jack 的开关 , 默认是关闭的 ;
• jackInProcess : 是否使用与 Gradle 相同的 Java 虚拟机运行该 Jack , 默认为 true ;
• pluginNames : 向 Jack 通道添加的 Jack 插件 ;

参考文档 : https://google.github.io/android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.JackOptions.html

用法示例 : 使用了 jackOptions 之后 , 可以支持部分 java8 特性 , 如 lambda 表达式 ;

android 
    defaultConfig 
        jackOptions
            enabled true
        
    

二、ProductFlavor#javaCompileOptions 配置

---

ProductFlavor 参考文档 : com.android.build.gradle.internal.dsl.ProductFlavor.html

ProductFlavor#javaCompileOptions 配置 , 用于配置一些 Java 编译选项 ;

ProductFlavor#javaCompileOptions 配置项的类型是 JavaCompileOptions 类型的 , 文档地址 https://google.github.io/android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.JavaCompileOptions.html ;

在 JavaCompileOptions 中 , 只有一个配置属性 , annotationProcessorOptions , 是 AnnotationProcessorOptions 类型的 ;

该配置项 主要是用于配置 " 注解处理器 " 的 ;

进入 AnnotationProcessorOptions 配置项的文档 https://google.github.io/android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.AnnotationProcessorOptions.html 页面 , 该配置项有 $3$ 个可配置的属性 ,

• arguments : 配置的注解处理器选项 ;
• classNames : 要运行的注解处理器 ;
• includeCompileClasspath : 注解处理器路径是否要包含便编译路径 ;

改配置不常使用 ;