Flutter 3.10.0升级后APK安装异常及图标摇树问题咨询

问题现象 #

• Debug模式运行正常，构建Release APK后出现两个异常：
  • 安装时弹出其他项目没有的警告弹窗，点击“更多详情”可继续完成安装
  • 部分场景下安装后应用显示空白屏
• 构建APK时出现全新提示：

  Font asset "MaterialIcons-Regular.otf" was tree-shaken, reducing it from 1645184 to 1384 bytes (99.9% reduction). Tree-shaking can be disabled by providing the --no-tree-shake-icons flag when building your app.

问题原因及解决建议 #

1. 图标摇树优化提示 #

Flutter 3.10.0 新增了图标摇树优化特性，默认会自动移除代码中未直接引用的Material Icons字体内容，以此大幅压缩APK体积，这就是构建时出现该提示的原因——旧版本Flutter无此特性，所以之前不会显示。

如果你的代码中存在动态调用图标的逻辑（比如通过字符串名称加载图标），摇树优化会误删这些未被静态引用的图标资源，导致运行时无法加载图标，进而引发空白屏或UI异常。

对应解决方式：

• 无动态图标调用：该提示仅为优化通知，无需处理，属于正常现象
• 有动态图标调用：构建Release包时添加--no-tree-shake-icons参数禁用摇树优化，命令如下：

  flutter build apk --release --no-tree-shake-icons
  

2. 安装警告弹窗 #

升级后出现安装弹窗，多因Flutter 3.10对APK的签名、权限或AndroidManifest配置逻辑做了调整：

• 检查APK签名是否符合目标Android版本规范（尤其是Android 12+的签名要求）
• 核对AndroidManifest.xml中是否新增了旧版本未要求的权限，或权限声明格式不符合新规范
• 确认Flutter 3.10生成的Android项目配置变更（比如targetSdkVersion升级后未适配对应权限策略）

3. 空白屏问题 #

空白屏大概率与图标摇树优化误删资源有关，此外还可排查：

• 检查Release模式下的初始化逻辑是否存在仅Debug模式生效的代码（比如依赖本地调试服务）
• 通过adb logcat获取Release模式运行日志，定位具体报错（如资源加载失败、初始化异常等）

项目pubspec配置 #

name: project
description: A new Flutter project.
publish_to: 'none' # Remove this line if you wish to publish to pub.dev

version: 1.0.0+1

environment:
  sdk: '>=3.0.0 <4.0.0'

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.2

dev_dependencies:
  flutter_test:
    sdk: flutter

  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true

  # To add assets to your application, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg

  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic

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