Android Studio：如何为多模块创建共用Gradle静态分析任务

绝对没问题！Gradle早就为这种多模块重复配置的场景准备了好几种解决方案，我给你梳理几个最实用的，从快速实现到优雅复用都有：

这是最直接的方式，不用额外创建插件，直接在根项目的build.gradle里遍历所有子模块，统一添加任务：

subprojects { subProject ->
    // 只给Android模块（应用或库）添加任务，避免给纯Java/Kotlin等非Android模块生效
    if (subProject.plugins.hasPlugin('com.android.application') || subProject.plugins.hasPlugin('com.android.library')) {
        task staticAnalysisReport(type: DefaultTask) {
            description = "生成当前模块的静态分析报告"
            group = "Static Analysis" // 把任务归到指定分组，方便在Gradle面板找到

            doLast {
                // 这里替换成你的实际静态分析逻辑，比如调用lint、自定义代码检查工具等
                // 示例：生成一个简单的报告到模块根目录
                def reportFile = new File(subProject.projectDir, "static_analysis_report.txt")
                reportFile.text = """静态分析报告
模块名称: ${subProject.name}
生成时间: ${new Date()}
"""
                println "✅ 报告已生成至: ${reportFile.absolutePath}"
            }
        }
    }
}

配置完成后，执行方式完全符合你的需求：

• 给模块A生成报告：./gradlew moduleA:staticAnalysisReport
• 给模块B生成报告：./gradlew moduleB:staticAnalysisReport

如果有个别模块不需要这个任务，还可以加过滤条件，比如排除某个模块：

if (!subProject.name.equals("moduleC") && /* Android模块判断 */) {
    // 创建任务
}

如果你的静态分析逻辑比较复杂，或者以后要扩展功能，自定义插件是更专业的选择，还能在其他项目复用。步骤如下：

1. 在根项目下创建buildSrc目录（Gradle会自动识别这个目录作为内置插件源，不用发布到远程仓库）
2. 在buildSrc/build.gradle中添加插件依赖：

plugins {
    id 'groovy'
    id 'java-gradle-plugin'
}

repositories {
    mavenCentral()
    google()
}

dependencies {
    implementation gradleApi()
    implementation localGroovy()
    // 如果需要Android相关API，添加对应版本的Gradle插件依赖
    implementation 'com.android.tools.build:gradle:7.4.2'
}

3. 编写插件实现类，比如buildSrc/src/main/groovy/com/example/StaticAnalysisPlugin.groovy：

package com.example

import org.gradle.api.Plugin
import org.gradle.api.Project
import org.gradle.api.tasks.DefaultTask

class StaticAnalysisPlugin implements Plugin<Project> {
    @Override
    void apply(Project project) {
        // 仅给Android模块应用任务
        if (project.plugins.hasPlugin('com.android.application') || project.plugins.hasPlugin('com.android.library')) {
            project.tasks.register('staticAnalysisReport', DefaultTask) { task ->
                task.description = "生成当前模块的静态分析报告"
                task.group = "Static Analysis"

                task.doLast {
                    def reportDir = project.layout.projectDirectory.dir("reports/static-analysis")
                    reportDir.get().asFile.mkdirs() // 自动创建目录
                    def reportFile = reportDir.file("report.txt").get().asFile
                    reportFile.text = """静态分析报告
模块: ${project.name}
完成时间: ${new Date()}
"""
                    println "✅ 报告已生成到: ${reportFile.path}"
                }
            }
        }
    }
}

4. 在根build.gradle中让所有子模块应用这个插件：

subprojects {
    plugins.apply('com.example.static-analysis')
}

或者让单个模块在自己的build.gradle中单独应用：

plugins {
    id 'com.android.library'
    id 'com.example.static-analysis'
}

这是Gradle官方推荐的模块化配置方式，把配置逻辑抽成独立的约定插件，结构更清晰，适合大型项目：

1. 在buildSrc中创建约定插件类，比如buildSrc/src/main/groovy/com/example/conventions/StaticAnalysisConventionPlugin.groovy：

package com.example.conventions

import org.gradle.api.Plugin
import org.gradle.api.Project

class StaticAnalysisConventionPlugin implements Plugin<Project> {
    @Override
    void apply(Project project) {
        // 借助Android基础插件判断，更通用
        project.pluginManager.withPlugin('com.android.base') {
            project.tasks.register('staticAnalysisReport') { task ->
                task.description = "生成当前模块的静态分析报告"
                task.group = "Static Analysis"
                task.doLast {
                    def reportFile = project.layout.projectDirectory.file("static_analysis_report.txt").get().asFile
                    reportFile.text = """模块: ${project.name}
分析完成时间: ${new Date()}
"""
                    println "✅ 报告已生成: ${reportFile.path}"
                }
            }
        }
    }
}

2. 在buildSrc/src/main/resources/META-INF/gradle-plugins/com.example.conventions.static-analysis.properties中配置插件实现类：

implementation-class=com.example.conventions.StaticAnalysisConventionPlugin

3. 子模块直接通过plugins块应用约定插件：

plugins {
    id 'com.android.library'
    id 'com.example.conventions.static-analysis'
}

额外优化建议 #

• 增量构建：如果你的任务有输入（比如源码文件）和输出（报告文件），建议配置inputs和outputs，这样Gradle只会在输入变化时重新执行任务，提升效率：

task staticAnalysisReport(type: DefaultTask) {
    inputs.files(project.android.sourceSets.main.java.srcDirs) // 监听源码变化
    outputs.file(project.layout.projectDirectory.file("static_analysis_report.txt")) // 标记输出文件

    doLast {
        // 分析逻辑
    }
}

• 自定义参数：如果不同模块需要不同配置，可以给插件添加扩展属性，比如允许模块指定报告文件名：

// 在插件中创建扩展
def extension = project.extensions.create('staticAnalysis', StaticAnalysisExtension)

// 在任务中使用扩展
def reportFile = new File(project.projectDir, extension.reportFileName)

// 子模块可以这样自定义配置：
staticAnalysis {
    reportFileName = "custom_report.txt"
}

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