Android多模块同名同路径资源文件编译时检测方案咨询

自定义Gradle任务实现编译时自动检测 #

直接在根项目的build.gradle中添加自定义任务，遍历所有Android模块的资源目录，收集并检测重复的资源相对路径，在编译阶段触发检查并抛出警告/错误。

具体实现代码 #

// 根项目 build.gradle
allprojects {
    afterEvaluate { project ->
        // 仅对Android应用/库模块生效
        if (project.plugins.hasPlugin('com.android.library') || project.plugins.hasPlugin('com.android.application')) {
            task checkDuplicateResources {
                group = 'Verification'
                description = '检测多模块间重复的资源文件路径'

                doLast {
                    def resourceMap = new HashMap<String, List<String>>()

                    // 遍历当前模块的所有资源源集（main、debug、release等）
                    project.android.sourceSets.each { sourceSet ->
                        sourceSet.resources.srcDirs.each { srcDir ->
                            if (srcDir.exists()) {
                                // 递归扫描资源目录下的所有文件
                                srcDir.eachFileRecurse { file ->
                                    if (file.isFile()) {
                                        // 获取资源相对于res目录的路径（如 anim/slide_in_right.xml）
                                        def relativePath = srcDir.toURI().relativize(file.toURI()).toString()
                                        // 记录该路径所属的模块
                                        def moduleList = resourceMap.getOrDefault(relativePath, [])
                                        moduleList.add(project.name)
                                        resourceMap.put(relativePath, moduleList)
                                    }
                                }
                            }
                        }
                    }

                    // 检查并输出重复资源
                    resourceMap.each { path, modules ->
                        if (modules.size() > 1) {
                            // 抛出错误终止编译，若需仅警告则替换为 logger.warn(...)
                            throw new GradleException("重复资源路径: ${path}，涉及模块: ${modules.join(', ')}")
                        }
                    }
                }
            }

            // 将检测任务绑定到编译前置流程
            project.preBuild.dependsOn(checkDuplicateResources)
        }
    }
}

代码说明 #

• 遍历每个Android模块的所有资源源目录（包括main、debug等变体目录）
• 以相对于res目录的路径作为唯一标识，记录每个路径对应的模块
• 若同一路径存在于多个模块，直接抛出GradleException终止编译；如需仅输出警告，将throw语句替换为logger.warn("重复资源路径: ${path}，涉及模块: ${modules.join(', ')}")
• 任务绑定到preBuild阶段，确保编译前先执行检测

替代方案：解析资源合并日志 #

若不需要强制终止编译，可开启Android Gradle插件的详细日志，查看资源合并时的重复提示：
在项目根目录的gradle.properties中添加：

android.debug.obsoleteApi=true

编译时控制台会输出资源合并的详细日志，其中会标记重复的资源文件，但该方式需手动排查，无法自动终止编译。

为什么不使用resourcePrefix #

该方案要求手动为所有资源添加前缀，且会对Styleable及其属性进行强制校验，与需求冲突，因此不适用。

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