Android Studio构建时自动生成已删除.png文件问题求助

为什么图片会反复生成？ #

• Gradle构建缓存残留：Android Gradle Plugin（AGP）会缓存构建产物以加速后续构建，如果旧资源的缓存没清理，构建时会自动从缓存中恢复该文件。
• 第三方依赖库包含该资源：你引入的某个依赖库中自带了同名的.png资源，打包时会被合并到APK中，看起来像是自动生成的。
• 构建变体/源集遗漏：如果项目使用了多Product Flavor或Build Type（比如Debug/Release单独的资源目录），你可能只删除了主模块的资源，但某个变体的src/debug/drawable或src/flavorName/drawable下还保留着该文件。
• 自定义构建任务/脚本生成：项目的build.gradle中可能存在自定义Task，或者使用了资源生成工具（比如批量生成适配图的脚本），构建时会自动生成该图片。
• 版本控制缓存未清理：如果用Git管理代码，可能该文件还在Git的缓存中，切换分支或拉取代码时被恢复。

彻底移除的步骤（覆盖Debug/Release构建） #

1. 清理构建缓存与产物 #

• 执行Android Studio工具栏的Build > Clean Project，再执行Build > Rebuild Project
• 手动删除以下目录：
  • 项目根目录下的.gradle、build文件夹
  • 用户目录（比如~/.gradle/caches或C:\Users\你的用户名\.gradle\caches）下的Gradle缓存

2. 排查并处理依赖库资源 #

• 在终端执行命令查看依赖树：

  ./gradlew app:dependencies
  

  查找是否有依赖库包含该.png资源
• 如果确认是依赖带来的，在build.gradle(app)的dependencies块中排除对应的资源模块，例如：

  implementation('com.example:some-library:1.0.0') {
      exclude group: 'com.example', module: 'some-library-resources'
  }
  

  或者用resConfigs只保留需要的资源类型，减少冗余资源：

  android {
      defaultConfig {
          resConfigs 'zh-rCN', 'xhdpi' // 只保留中文和xhdpi资源
      }
  }
  

3. 检查所有构建变体的资源源集 #

• 切换到所有构建变体（Debug/Release、不同Flavor），检查对应的src子目录（比如src/debug/drawable、src/premium/drawable）下是否还有该图片
• 执行命令查看所有资源源集的路径：

  ./gradlew app:sourceSets
  

  逐一检查输出中的res目录，确保没有遗漏的资源文件

4. 排查自定义构建逻辑 #

• 打开build.gradle(app)和项目根目录的build.gradle，检查是否有自定义Task在构建时生成或复制该图片，比如类似这样的代码：

  task generateImage {
      doLast {
          copy {
              from 'some/path'
              into 'src/main/res/drawable'
              include 'target.png'
          }
      }
  }
  preBuild.dependsOn generateImage
  

  如果有，删除对应的Task或修改逻辑

5. 清理版本控制缓存 #

• 如果使用Git，执行命令删除缓存中的文件并提交：

  git rm --cached path/to/your/image.png
  git commit -m "Remove cached image file"
  

• 检查.gitignore文件，确保没有添加该文件的例外规则（比如误写了!path/to/image.png导致被追踪）

6. 定位APK中的资源来源 #

• 用Android Studio的Build > Analyze APK打开生成的APK，找到该图片后右键选择Show in Explorer，查看该资源的路径，判断是来自主模块还是依赖库，再针对性处理

背后的构建逻辑解释 #

Android的构建系统基于Gradle和AGP，核心逻辑是资源聚合与缓存复用：

1. 资源聚合：AGP会将主模块、所有依赖库、构建变体的资源目录中的资源合并，只要任意一个源集中存在该资源，就会被打包进APK。如果主模块删除了资源，但依赖或变体中还有，就会继续出现在APK中。
2. 缓存机制：为了加速构建，AGP会缓存所有构建产物（包括编译后的资源、.class文件等），如果缓存未失效，构建时会直接复用缓存中的旧资源，导致已删除的文件“复活”。
3. 依赖资源合并：第三方依赖的资源会被自动合并到项目中，同名资源的优先级是：构建变体资源 > 主模块资源 > 依赖库资源，但如果主模块删除了资源，依赖库的同名资源就会被保留下来。

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