Android启动屏Drawable资源未找到异常的诊断与解决

问题现象与错误分析

当android应用在启动splashactivity时，如果其背景或内部引用的drawable资源未能正确加载，则可能抛出java.lang.runtimeexception，并伴随android.content.res.resources$notfoundexception。典型的错误日志如下所示：

Fatal Exception: java.lang.RuntimeException
Unable to start activity ComponentInfo{com.packageName/com.packageName.SplashActivity}: 
android.content.res.Resources$NotFoundException: Drawable 
com.packageName:drawable/splash_background with resource ID #0x7f07015d
    ... (堆栈信息) ...
Caused by android.content.res.Resources$NotFoundException Drawable (missing name) with resource ID #0x7f07015e

从上述日志中，我们可以清晰地看到：

1. 崩溃点： 应用在尝试启动SplashActivity时失败。
2. 根本原因： android.content.res.Resources$NotFoundException，即资源未找到异常。
3. 具体资源： 首先是drawable/splash_background（资源ID #0x7f07015d），随后是其内部引用的另一个Drawable（资源ID #0x7f07015e）。

根据问题描述，SplashActivity的SplashTheme样式中，android:windowBackground属性引用了@drawable/splash_background：

<style name="SplashTheme" parent="@style/Theme.AppCompat.NoActionBar">
    <item name="android:windowBackground">@drawable/splash_background</item> <!-- Resource ID #0x7f07015d -->
</style>

而splash_background.xml是一个layer-list，它又引用了另外两个Drawable：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android"
    android:opacity="opaque">
    <item android:drawable="@drawable/gradient_splash" /> <!-- Resource ID #0x7f0700af -->
    <item android:drawable="@drawable/splash_icon" android:gravity="center" /> <!-- Resource ID #0x7f07015e -->
</layer-list>

这意味着，当系统尝试加载splash_background时，如果其内部引用的gradient_splash或splash_icon有任何一个找不到，都会导致链式反应，最终表现为splash_background加载失败。日志中明确指出#0x7f07015e对应的Drawable（即splash_icon）也未找到，这进一步证实了资源缺失或配置不当。

根源剖析：资源未找到异常

Resources$NotFoundException通常发生在以下几种情况：

1. 资源确实不存在： 文件名拼写错误、文件未放置在正确的资源目录下。
2. 多密度资源缺失： Android设备具有不同的屏幕密度（dpi），如mdpi、hdpi、xhdpi等。开发者通常需要在drawable-mdpi、drawable-hdpi等目录下提供不同尺寸的图片资源。如果某个设备密度对应的资源缺失，系统会尝试从其他密度目录或默认的drawable目录进行缩放。但如果所有相关目录中都没有找到该资源，就会抛出此异常。
3. 资源ID冲突或无效： 虽然不常见，但如果资源ID在编译时出现问题（例如，R.java文件未正确生成），也可能导致查找失败。
4. 构建系统问题： Gradle缓存、IDE缓存问题可能导致资源未被正确打包到APK中。

在本案例中，问题描述提到splash_icon.png存在于drawable-ldpi、drawable-mdpi、drawable-hdpi、drawable-xhdpi、drawable-xxhdpi、drawable-xxxhdpi等文件夹中，但仍然出现NotFoundException，这强烈指向了多密度资源管理不当或构建系统在特定设备上查找资源时出现偏差。即使资源文件存在，也可能因为某个特定设备密度下缺少对应的最优匹配，或者在查找过程中出现意外错误。

解决方案与最佳实践

针对此类Resources$NotFoundException，以下是详细的解决方案和建议：

千面视频动捕

千面视频动捕是一个AI视频动捕解决方案，专注于将视频中的人体关节二维信息转化为三维模型动作。

27

查看详情

1. 完善多密度Drawable资源管理

确保所有图像资源在各种屏幕密度下都有适当的变体是解决此问题的关键。

• 提供所有必要的密度版本： 即使splash_icon.png已存在于多个密度文件夹，仍需仔细检查每个文件夹中的文件是否完整且可访问。如果某个特定设备密度（例如，drawable-nodpi或drawable-anydpi，尽管不常用）未找到匹配项，系统可能无法回退。
• 利用矢量图（Vector Drawables）： 对于图标和简单的图形，强烈推荐使用矢量图（SVG转换为VectorDrawable XML文件）。矢量图可以自动适应任何屏幕密度而无需提供多个PNG文件，大大简化了资源管理并减少了APK大小。
  • 如果splash_icon是一个简单的图标，考虑将其转换为VectorDrawable。
  • 在build.gradle中确保启用了vectorDrawables.useSupportLibrary = true，以在旧版本Android上支持矢量图。

    android {
    defaultConfig {
        // ...
        vectorDrawables.useSupportLibrary = true
    }
    }

    登录后复制
• 提供一个通用drawable文件夹版本： 作为最终的备用方案，可以在不带任何密度修饰符的drawable文件夹中放置一份默认尺寸的splash_icon.png。如果系统无法找到特定密度的最佳匹配，它会尝试从这个通用drawable文件夹加载并进行缩放。但这可能导致图片模糊或失真，应作为最后手段。
• 检查XML引用： 确保gradient_splash.xml和splash_background.xml本身没有引用不存在的Drawable。

2. 利用辅助工具管理Drawable

手动创建和管理所有密度的图片可能繁琐且容易出错。

• Android Drawable Importer插件： 这是一个流行的Android Studio插件，可以帮助开发者从单一高分辨率图像自动生成不同密度的Drawable版本。
  • 使用方法： 右键点击res目录 -> New -> Vector Asset（用于矢量图）或 Batch Drawable Import（用于位图）。
  • 注意事项： 随着Android Studio版本的更新，某些插件可能会出现兼容性问题。如果遇到插件无法正常工作的情况，请检查插件的最新版本或查阅相关社区解决方案，确保其与当前Android Studio版本兼容。

3. 检查项目配置

虽然build.gradle中的大部分配置与此错误不直接相关，但以下几点值得检查：

• minSdkVersion与targetSdkVersion： 确保它们与你使用的库和功能兼容。minSdkVersion 19和targetSdkVersion 33是合理的配置。
• multiDexEnabled： 虽然与Drawable查找无关，但multiDexEnabled true表明你的应用可能方法数较多，需要Multidex支持。确保Multidex配置正确，但这不太可能是Resources$NotFoundException的直接原因。
• namespace： namespace 'com.packageName'是Android Gradle Plugin 7.0+的新特性，确保其与applicationId一致。

4. 常见排查步骤

在进行上述代码和配置检查后，尝试以下通用排查步骤：

• 清理和重建项目： Build -> Clean Project，然后 Build -> Rebuild Project。这可以清除旧的构建缓存，强制Gradle重新处理所有资源。
• 清除缓存并重启IDE： File -> Invalidate Caches / Restart...。这有助于解决IDE内部的索引和缓存问题。
• 检查APK内容： 解压生成的APK文件，检查res/drawable及其子目录中是否确实包含了splash_background.xml、gradient_splash.xml以及所有密度的splash_icon.png文件。这能直接验证资源是否被正确打包。
• 在不同设备/模拟器上测试： 在不同API级别和屏幕密度的设备或模拟器上测试应用，以确定问题是否只发生在特定配置下。
• 日志分析： 仔细查看完整的崩溃日志，特别是Caused by部分，它能提供更深层次的错误信息。

总结

Resources$NotFoundException是Android开发中常见的资源管理问题，尤其是在涉及多密度Drawable时。解决此类问题的关键在于理解Android资源查找机制，并确保为所有目标设备提供完整、正确的资源。通过采用矢量图、合理管理多密度位图、利用辅助工具以及执行彻底的排查，可以有效避免此类崩溃，提升应用的稳定性和用户体验。

以上就是Android启动屏Drawable资源未找到异常的诊断与解决的详细内容，更多请关注php中文网其它相关文章！