什么是Android Unused Resource Cleanup
Android Unused Resource Cleanup 是一款专为 Android 开发者设计的 Git 辅助工具，用于智能识别因代码修改而变得不再使用的资源文件。当你在项目中替换背景图、调整字符串、重构布局或修改颜色等资源后，旧资源往往会遗留下来成为“无用资产”。该工具通过分析 Git 的代码改动差异，自动检测这些被弃用的资源，并判断其是否仍在项目中被引用，从而帮助开发者高效清理冗余文件，保持项目整洁。
它支持分析暂存的改动（git add 后的内容）、工作区中的未提交修改，以及任意历史提交的变更。工具覆盖 Android 项目的全部资源类型，包括 drawable、layout、string、color、dimen、style、anim、raw 和 font 等，能够全面扫描资源引用情况。通过文本匹配方式识别 Java/Kotlin 代码中的 R.type.name 格式以及 XML 文件中的 @type/name 格式引用，为开发者提供可操作的安全删除建议。
虽然脚本基于静态分析，可能存在一定的误判风险，但可作为清理工作的有力参考。建议在执行删除前人工复核结果，并在删除后编译验证项目完整性，以确保资源清理不会破坏现有功能。
核心功能特点
- 智能分析 Git 代码改动，识别因修改而废弃的资源文件
- 支持分析暂存区、工作区和历史提交的资源变更
- 覆盖 drawable、layout、string、color、dimen 等全部 Android 资源类型
- 自动搜索项目内资源引用情况，区分仍可使用的保留项与可安全删除项
- 提供命令行接口，便于集成到开发流程中
适用场景
该工具特别适合在频繁进行 UI 重构或资源优化的 Android 开发场景中应用。例如，当你将一个按钮的背景从 `bg_main` 更换为 `bg_new_main` 后，旧的 `bg_main.xml` 文件可能仍存在于项目中却不再被任何代码引用。此时运行此脚本，即可快速定位该资源并确认其无引用，避免手动查找的繁琐。类似地，在批量重命名字符串资源或调整主题样式后，遗留的旧名称资源也容易被遗漏清理。
此外，团队协作开发中也十分适用：当某位成员修改了布局文件并删除了对某个 layout 的引用，但该 layout 文件未被及时移除时，该工具能帮助其他成员或后续维护者发现这些“幽灵文件”，防止资源堆积影响项目性能或造成混淆。尤其适用于长期维护的大型项目，定期使用此工具可有效控制资源库膨胀，提升构建效率。
需要注意的是，对于通过反射或动态拼接字符串生成的资源引用，该工具无法检测，因此在处理复杂逻辑时应结合人工审查。尽管如此，它仍是 Android 开发者日常维护资源库不可或缺的自动化助手，显著减少手动排查时间，让精力更集中于核心功能开发。