Ionic Cordova启动屏未显示自定义图片问题排查

核心排查方向及解决步骤 #

• 资源未同步到Android项目目录
  手动检查platforms/android/app/src/main/res下的各个drawable-*文件夹，确认其中的splash图片是否为你自定义的资源。如果不是，直接将resources/android/splash目录下对应尺寸的图片复制过去覆盖。
• cordova-android 11的配置适配问题
  cordova-android 11对资源结构和AndroidX有强制要求：
  1. 检查config.xml中的<splash>标签，确保src路径指向正确的资源文件，示例：

     <splash src="resources/android/splash/drawable-land-mdpi-screen.png" density="land-mdpi" />
     <splash src="resources/android/splash/drawable-port-hdpi-screen.png" density="port-hdpi" />
     

  2. 在config.xml中添加AndroidX启用配置：

     <preference name="AndroidXEnabled" value="true" />
     

• 清理构建残留与缓存
  彻底移除并重新添加Android平台，清除旧构建缓存：

  ionic cordova platform rm android
  ionic cordova platform add android@11.0.0
  ionic cordova build android --clean
  

• cordova-plugin-splashscreen配置校验
  确认config.xml中启动屏基础配置正确，避免错误的默认路径设置：

  <preference name="SplashScreen" value="screen" />
  <preference name="SplashScreenDelay" value="3000" />
  <preference name="SplashMaintainAspectRatio" value="true" />
  

• APK打包验证
  使用Android Studio的APK Analyzer打开生成的APK，检查res/drawable-*目录下是否存在正确的自定义splash资源——如果缺失，说明资源未被正确打包，需重新确认资源生成和同步流程。

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