多模块Android项目：能否通过单个Gradle任务生成统一Lint报告？

我经常帮团队解决这类多模块代码质量检查的问题，下面给你两种实用方案——从官方自带的快速方案到自定义灵活配置的方案都有，你可以根据项目情况选择：

方案一：用AGP官方的lintAggregate任务（推荐，AGP 7.0+） #

从Android Gradle Plugin 7.0开始，官方专门提供了lintAggregate任务，用来自动聚合所有Android模块（app+库）的Lint结果，生成单一的HTML/XML报告，配置简单还省心。

配置步骤： #

1. 在根项目的build.gradle（或build.gradle.kts）中添加Lint插件：

// Groovy DSL
plugins {
    id 'com.android.lint' version '7.4.2' // 版本请与你的AGP版本保持一致
}

lint {
    // 开启HTML和XML格式报告
    htmlReport true
    xmlReport true
    // 指定统一报告的输出路径
    htmlOutput file("${rootProject.buildDir}/reports/lint/aggregate-lint.html")
    xmlOutput file("${rootProject.buildDir}/reports/lint/aggregate-lint.xml")
    
    // 可选配置：比如忽略特定检查、设置报错级别
    // abortOnError false // 即使有Lint错误也不中断构建
    // ignoreWarnings true // 只报告错误，忽略警告
}

// Kotlin DSL
plugins {
    id("com.android.lint") version "7.4.2"
}

lint {
    htmlReport.set(true)
    xmlReport.set(true)
    htmlOutput.set(file("${rootProject.buildDir}/reports/lint/aggregate-lint.html"))
    xmlOutput.set(file("${rootProject.buildDir}/reports/lint/aggregate-lint.xml"))
}

2. 执行任务：
   在终端运行以下命令，完成后就能在指定路径找到统一的报告了：

./gradlew lintAggregate

这个方案的优势是官方维护，无需自己处理模块依赖和报告合并，还支持所有常规Lint配置。

方案二：自定义Gradle任务（适配旧版AGP或特殊需求） #

如果你的项目用的是AGP 7.0以下版本，或者需要更灵活的自定义逻辑，可以自己创建任务触发所有模块的Lint检查，并统一管理报告输出。

配置步骤： #

1. 统一配置所有模块的Lint输出路径
   在根项目的build.gradle中，通过subprojects块为所有Android模块统一设置报告位置：

subprojects {
    afterEvaluate { project ->
        // 仅对Android应用/库模块生效
        if (project.plugins.hasPlugin('com.android.application') || project.plugins.hasPlugin('com.android.library')) {
            android {
                lintOptions {
                    htmlReport true
                    xmlReport true
                    // 每个模块的报告输出到根目录的统一文件夹，用模块名区分
                    htmlOutput file("${rootProject.buildDir}/reports/lint/${project.name}-lint.html")
                    xmlOutput file("${rootProject.buildDir}/reports/lint/${project.name}-lint.xml")
                    // 可选：禁用特定Lint规则
                    // disable 'MissingTranslation'
                }
            }
        }
    }
}

2. 创建自定义任务触发所有Lint检查
   在根项目的build.gradle中添加一个任务，依赖所有模块的Lint任务（这里以lintDebug为例，若需检查release变体，改成lintRelease即可）：

task runFullLint {
    group = 'Verification'
    description = 'Runs Lint checks on all Android modules and collects reports in a unified directory'
    
    // 依赖所有Android模块的lintDebug任务
    dependsOn subprojects.findAll {
        it.plugins.hasPlugin('com.android.application') || it.plugins.hasPlugin('com.android.library')
    }.collect { it.tasks.findByName('lintDebug') }
}

3. （可选）合并XML报告为单个文件
   如果需要把所有模块的XML报告合并成一个，可以添加额外任务：

task mergeLintXml {
    group = 'Verification'
    description = 'Merges all module Lint XML reports into a single file'
    
    doLast {
        def mergedFile = new File("${rootProject.buildDir}/reports/lint/merged-lint.xml")
        def mergedIssues = new groovy.xml.MarkupBuilder(new FileWriter(mergedFile))
        mergedIssues.issues {
            // 遍历所有模块的XML报告，提取<issue>节点合并
            subprojects.each { project ->
                def reportFile = new File("${rootProject.buildDir}/reports/lint/${project.name}-lint.xml")
                if (reportFile.exists()) {
                    def xml = new XmlSlurper().parse(reportFile)
                    xml.issue.each { issue ->
                        mergedIssues.copyNode(issue)
                    }
                }
            }
        }
    }
    
    // 确保先生成所有模块报告再合并
    dependsOn runFullLint
}

4. 执行任务：

• 生成各模块独立报告：./gradlew runFullLint
• 生成合并后的XML报告：./gradlew mergeLintXml

两种方案都能满足你的需求，优先推荐方案一，毕竟是官方原生支持，省心又可靠。

内容的提问来源于stack exchange，提问作者sttimchenko