【Android Gradle 插件】LintOptions 配置 ⑨ ( quiet 属性配置 | severityOverrides 属性配置 | showAll 属性配置 )

Android Plugin DSL Reference 参考文档 :

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

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

• 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

• BuildType ( build.gradle#android#buildTypes 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.BuildType.html

• SigningConfig ( build.gradle#android#signingConfigs 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.SigningConfig.html

• AaptOptions ( build.gradle#android#aaptOptions 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.AaptOptions.html

• AndroidSourceSets ( build.gradle#android#sourceSets 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.api.AndroidSourceSet.html

• AndroidSourceDirectorySet ( build.gradle#android#sourceSets#aidl/assets/java/jni/jniLibs 配置 ) 文档位置 :android-gradle-dsl/2.3/com.android.build.gradle.api.AndroidSourceDirectorySet.html

• AndroidSourceFile ( build.gradle#android#sourceSets#manifest 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.api.AndroidSourceFile.html

• DataBindingOptions ( build.gradle#android#dataBinding ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.DataBindingOptions.html

• DexOptions ( build.gradle#android#dexOptions ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.DexOptions.html

• LintOptions ( build.gradle#android#lintOptions ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.LintOptions.html

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

一、LintOptions#quiet 属性配置

LintOptions ( build.gradle#android#lintOptions ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.LintOptions.html

1、配置简介

LintOptions#quiet 属性配置 用于配置 Lint 检查时是否 在 Terminal 终端中输出 分析消息 , 也就是是否处于静默状态 ;

2、配置原型

LintOptions#quiet 属性配置原型 : boolean 类型 , 设置 true 或 false ;

boolean quiet
Returns whether lint should be quiet (for example, not write informational messages such as paths to report files written)

返回lint是否应处于静默状态（例如，不写入信息性消息，例如写入报告文件的路径）

3、使用示例

LintOptions#quiet 属性配置使用示例 :

    lintOptions {
        // 编译时遇到错误, 停止编译
        abortOnError false
        // 将指定的 Lint 问题 ID 设置为 fatal 级别
        fatal ('ContentDescription')
        // 显示完整路径
        absolutePaths true
        // 设定要检查的 Lint 问题 ID 集合 , 使用逗号隔开
        check 'ContentDescription'
        // 是否检查所有警告
        checkAllWarnings true
        // 发布版本是否检查 fatal 级别的错误
        checkReleaseBuilds true
        // 设定要 关闭 检查的 Lint 问题 ID 集合 , 字符串之间使用逗号隔开
        disable 'UnusedResources'
        // 设定要 开启 检查的 Lint 问题 ID 集合 , 字符串之间使用逗号隔开
        enable 'ContentDescription'
        // 检查结果是否带详解
        explainIssues true
        // html 输出文件
        htmlOutput File('lint.html')
        // 是否生成 html 输出文件
        htmlReport true
        // 是否忽略警告 , 只报告错误
        ignoreWarnings true
        // 指定用于备份的配置文件
        lintConfig File('config.xml')
        // 如果检查出的错误 , 是否输出出错位置代码行
        noLines true
        // 终端是否输出分析消息 
        quiet true
    }

二、LintOptions#severityOverrides 属性配置

LintOptions ( build.gradle#android#lintOptions ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.LintOptions.html

1、配置简介

LintOptions#severityOverrides 属性配置 用于配置 的 map 即可 , 键是 Lint 问题 ID , 值为 问题对应的 严重性 ;

严重性指的是

• “fatal”, 致命
• “error”, 错误
• “warning”, 警告
• “ignore” , 忽略

四个级别 , 越往下级别越低 ;

2、配置原型

LintOptions#severityOverrides 属性配置原型 : boolean 类型 , 设置 true 或 false ;

Map severityOverrides
An optional map of severity overrides. 
The map maps from issue id's to the corresponding severity to use, 
which must be "fatal", "error", "warning", or "ignore".

严重性覆盖的可选映射。
映射从问题id映射到要使用的相应严重性，
必须是“致命”、“错误”、“警告”或“忽略”。

3、使用示例

LintOptions#severityOverrides 属性配置使用示例 :

    lintOptions {
        // 编译时遇到错误, 停止编译
        abortOnError false
        // 将指定的 Lint 问题 ID 设置为 fatal 级别
        fatal ('ContentDescription')
        // 显示完整路径
        absolutePaths true
        // 设定要检查的 Lint 问题 ID 集合 , 使用逗号隔开
        check 'ContentDescription'
        // 是否检查所有警告
        checkAllWarnings true
        // 发布版本是否检查 fatal 级别的错误
        checkReleaseBuilds true
        // 设定要 关闭 检查的 Lint 问题 ID 集合 , 字符串之间使用逗号隔开
        disable 'UnusedResources'
        // 设定要 开启 检查的 Lint 问题 ID 集合 , 字符串之间使用逗号隔开
        enable 'ContentDescription'
        // 检查结果是否带详解
        explainIssues true
        // html 输出文件
        htmlOutput File('lint.html')
        // 是否生成 html 输出文件
        htmlReport true
        // 是否忽略警告 , 只报告错误
        ignoreWarnings true
        // 指定用于备份的配置文件
        lintConfig File('config.xml')
        // 如果检查出的错误 , 是否输出出错位置代码行
        noLines true
        // 终端是否输出分析消息 
        quiet true
    }

三、LintOptions#showAll 属性配置

LintOptions ( build.gradle#android#lintOptions ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.LintOptions.html

1、配置简介

LintOptions#showAll 属性配置 用于配置 是否输出所有的 Lint 检查信息 ;

2、配置原型

LintOptions#showAll 属性配置原型 : boolean 类型 , 设置 true 或 false ;

boolean showAll
Returns whether lint should include all output (e.g. include all alternate locations, not truncating long messages, etc.)

返回lint是否应包括所有输出
（例如，包括所有备用位置、不截断长消息等）

3、使用示例

LintOptions#showAll 属性配置使用示例 :

    lintOptions {
        // 编译时遇到错误, 停止编译
        abortOnError false
        // 将指定的 Lint 问题 ID 设置为 fatal 级别
        fatal ('ContentDescription')
        // 显示完整路径
        absolutePaths true
        // 设定要检查的 Lint 问题 ID 集合 , 使用逗号隔开
        check 'ContentDescription'
        // 是否检查所有警告
        checkAllWarnings true
        // 发布版本是否检查 fatal 级别的错误
        checkReleaseBuilds true
        // 设定要 关闭 检查的 Lint 问题 ID 集合 , 字符串之间使用逗号隔开
        disable 'UnusedResources'
        // 设定要 开启 检查的 Lint 问题 ID 集合 , 字符串之间使用逗号隔开
        enable 'ContentDescription'
        // 检查结果是否带详解
        explainIssues true
        // html 输出文件
        htmlOutput File('lint.html')
        // 是否生成 html 输出文件
        htmlReport true
        // 是否忽略警告 , 只报告错误
        ignoreWarnings true
        // 指定用于备份的配置文件
        lintConfig File('config.xml')
        // 如果检查出的错误 , 是否输出出错位置代码行
        noLines true
        // 终端是否输出分析消息 
        quiet true
        // 是否输出所有的 Lint 检查信息
        showAll true
    }