Flutter Launcher Icons失效导致APK安装失败求助

排查与修复步骤 #

1. 检查图标源文件 #

• 必须使用PNG格式的图标，避免WebP、JPG等格式（部分安卓设备兼容性差）
• 源图标尺寸至少1024x1024px，防止生成的适配图标损坏
• 排查透明通道异常：用图片编辑工具重新导出无损坏Alpha通道的PNG文件

2. 清理旧生成文件 #

• 执行命令清理Flutter缓存：

  flutter clean
  

• 手动删除安卓目录下的旧图标：android/app/src/main/res/mipmap-*中的所有ic_launcher相关文件

3. 修正pubspec.yaml配置 #

• 使用稳定版本的flutter_launcher_icons，避免新版bug，示例配置：

  dev_dependencies:
    flutter_launcher_icons: "^0.13.1"
  
  flutter_launcher_icons:
    android: true
    ios: false # 仅需安卓图标时关闭iOS配置
    image_path: "assets/icon/icon.png" # 确保路径正确、文件存在
    adaptive_icon_background: "#FFFFFF" # 指定自适应图标背景色，避免透明兼容问题
  

4. 重新生成图标并构建APK #

• 执行生成命令：

  flutter pub get
  flutter pub run flutter_launcher_icons
  

• 带无缓存参数构建APK：

  flutter build apk --release --no-build-cache
  

5. 检查AndroidManifest.xml #

• 确保图标引用正确，无重复配置：

  <application
      android:label="你的应用名称"
      android:icon="@mipmap/ic_launcher"
      android:roundIcon="@mipmap/ic_launcher_round">
  

• 不要手动修改ic_launcher相关引用，让插件自动生成配置

6. 适配旧设备（可选） #

• 若旧设备仍有问题，禁用自适应图标：

  flutter_launcher_icons:
    android:
      adaptive_icon: false
    image_path: "assets/icon/icon.png"
  

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