Flutter打包APK后图片及图标不显示问题求助

针对你遇到的Release APK资源不显示、图标乱码，但模拟器运行正常的问题，可按以下步骤排查修复：

1. 重置资源打包缓存 #

• 执行以下命令清理缓存并重新获取依赖：

  flutter clean
  flutter pub get
  

• 重新执行打包命令：flutter build apk，避免缓存导致资源未正确打包。

2. 检查资源配置与命名 #

• 确认pubspec.yaml中assets路径是否覆盖所有需要的资源：你当前配置了assets/images/和assets/icons/，若目录下有子文件夹，需补充路径（如assets/icons/sub/）或使用通配符assets/icons/**（Flutter 2.0+支持）。
• 检查资源文件命名：避免中文、空格或特殊字符，统一使用英文小写+下划线（如user_icon.png），Release打包对特殊命名的资源兼容性较差。

3. 关闭Android资源压缩/混淆（临时验证） #

• 打开android/app/build.gradle，修改Release构建配置，关闭资源压缩和代码混淆，验证是否是优化导致资源丢失：

  buildTypes {
      release {
          minifyEnabled false
          shrinkResources false
          signingConfig signingConfigs.release // 保留签名配置
      }
  }
  

• 若关闭后正常，说明是压缩规则误删了资源，可添加保留规则：在android/app/src/main/res/raw下创建keep.xml，写入：

  <?xml version="1.0" encoding="utf-8"?>
  <resources xmlns:tools="http://schemas.android.com/tools"
      tools:keep="@drawable/*,@mipmap/*,@assets/images/*,@assets/icons/*" />
  

4. 处理SVG资源问题 #

• 你使用了flutter_svg包，Release模式下可能存在SVG语法或版本兼容问题：
  • 更新flutter_svg到最新稳定版，或回退到之前能正常打包的版本。
  • 用SVG验证工具检查所有SVG文件的语法，移除debug模式兼容但Release模式不支持的属性。

5. 修复Material Icons字体丢失 #

• 图标乱码是Material Icons字体未正确打包导致，即使pubspec.yaml中已开启uses-material-design: true，仍需在android/app/build.gradle中添加字体保留规则：

  android {
      packagingOptions {
          pickFirst 'fonts/MaterialIcons-Regular.ttf'
      }
  }
  

• 若使用了第三方字体（如google_fonts），确保已配置离线加载，避免Release模式下无法远程下载字体。

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