React Native应用从Play Store下载后图片无法显示问题求助

可能原因及修复方案 #

1. 资源拆分配置导致图片被过滤 #

Google Play的App Bundle会根据设备配置拆分资源，可能你的图片未被正确包含进对应拆分包：

• 打开android/app/build.gradle，检查bundle配置：

  android {
      ...
      bundle {
          language {
              enableSplit = false // 若无需按语言拆分，关闭此选项避免资源丢失
          }
          density {
              enableSplit = true // 保持开启，但需确保图片适配了对应密度目录
          }
          abi {
              enableSplit = true
          }
      }
  }
  

• 确认图片放置在android/app/src/main/res/drawable-xxx（或assets）目录，命名符合Android规范（小写、无特殊字符）。

2. 图片引用路径/方式错误 #

• 检查IMAGES.loginScreenImg的定义，确保是静态路径引用，比如require('../assets/login.png')，避免动态拼接路径（如require(../assets/${name}.png)）——这种动态方式在AAB打包时无法被正确识别。
• 核对引用路径的层级关系，确保打包时资源路径没有被项目结构变更影响。

3. 资源压缩/混淆误删图片 #

• 若开启了shrinkResources，需在proguard-rules.pro中添加规则保护图片资源：

  -keep class com.yourpackage.R$drawable { *; }
  -keep class com.yourpackage.R$mipmap { *; }
  

• 检查android/app/build.gradle的release构建配置，确认shrinkResources不会误删必要图片：

  buildTypes {
      release {
          minifyEnabled true
          shrinkResources true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

4. 正确测试AAB包 #

不要直接安装AAB文件，用bundletool生成模拟Play分发的APK测试：

# 生成APKS包
bundletool build-apks --bundle=app-release.aab --output=app-release.apks --ks=你的密钥库.jks --ks-pass=pass:密钥库密码 --ks-key-alias=密钥别名 --key-pass=pass:密钥密码
# 安装到设备
bundletool install-apks --apks=app-release.apks

这种方式能提前复现Play Store分发后的实际效果。

5. 图片格式/大小问题 #

• 确保图片为Android支持的格式（PNG、JPG），若使用WebP需在gradle中开启支持；
• 压缩过大的图片，避免资源拆分时出现异常。

内容的提问来源于stack exchange，提问作者hand code 2