React Native CLI项目修改res文件后模拟器图标未更新问题求助

Android 端排查步骤 #

• 确认图标资源匹配
  检查android/app/src/main/res/mipmap-*文件夹下的图标文件名是否为ic_launcher.png（方形图标）和ic_launcher_round.png（圆形图标），且尺寸符合规范：
  • mipmap-mdpi: 48×48px
  • mipmap-hdpi: 72×72px
  • mipmap-xhdpi: 96×96px
  • mipmap-xxhdpi: 144×144px
  • mipmap-xxxhdpi: 192×192px
• 清理构建缓存
  依次执行以下命令清空React Native和Android构建缓存：

  npx react-native clean
  cd android && ./gradlew clean # Windows 系统替换为 gradlew clean
  

• 验证AndroidManifest配置
  打开android/app/src/main/AndroidManifest.xml，确认application标签的图标属性指向正确资源：

  android:icon="@mipmap/ic_launcher"
  android:roundIcon="@mipmap/ic_launcher_round"
  

• 卸载并重装应用
  先在模拟器中彻底卸载旧应用，再重新运行：

  npx react-native run-android
  

• 检查产品风味（Flavors）
  若项目使用多环境构建，需确认替换的图标资源属于当前构建的Flavor目录（如android/app/src/debug/res或android/app/src/release/res）。

iOS 端排查步骤 #

• 确认AppIcon资产集替换完整
  打开iOS项目的Assets.xcassets，选中AppIcon资产集，确保所有尺寸的图标（包括通知、设置、Spotlight等场景）都已替换为新图标，且格式为PNG。
• 清理Xcode构建缓存
  打开Xcode，依次执行：
  • 按Cmd + Shift + K清理构建文件夹
  • 按Cmd + Option + Shift + K清理衍生数据
• 卸载并重装应用
  在模拟器中删除旧应用，建议直接通过Xcode打开ios/[项目名].xcworkspace，点击运行按钮重新构建安装。
• 验证Info.plist配置
  打开ios/[项目名]/Info.plist，确认CFBundleIcons和CFBundleIcons~ipad节点指向的是AppIcon资产集，无配置错误。

通用注意事项 #

• 图标格式必须为PNG，避免使用JPG或带非标准透明通道的图片
• 重启模拟器后再尝试安装，部分模拟器会缓存旧资源

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