Flutter Android正式版启动时应用图标始终显示白色边距求助

问题根源 #

Android 12及以上版本的原生启动页（Splash Screen）采用自适应图标规范，要求图标分为前景层和背景层，且前景图标需预留安全区域。无论是用flutter_launcher_icons还是直接替换ic_launcher，如果没适配这个规范，release模式下系统会自动缩放图标并添加白色边距，调试模式可能因为缓存或临时资源加载规避了这个问题。

具体解决步骤 #

• 适配自适应图标规范
  直接在android/app/src/main/res目录下替换符合规范的图标资源：

  1. 针对mipmap-anydpi-v26文件夹中的ic_launcher.xml，确保前景层引用的图标无多余空白，背景色配置与启动页一致。
  2. 替换各分辨率mipmap文件夹下的ic_launcher_foreground.png（前景图标）和ic_launcher_background.png（背景），前景图标不要占满整个画布，预留约20%的安全区域（可通过Android Studio的Image Asset Studio生成标准资源）。

• 配置启动页元数据
  在android/app/src/main/AndroidManifest.xml中添加启动页相关配置，明确图标和背景色：

  <application ...>
    <!-- 原有配置 -->
    <meta-data
        android:name="android.splashScreenIconBackgroundColor"
        android:resource="@color/your_splash_bg" />
    <meta-data
        android:name="android.splashScreenAnimatedIcon"
        android:resource="@mipmap/ic_launcher" />
  </application>
  

  其中@color/your_splash_bg需在res/values/colors.xml中定义对应的背景色。

• 清理缓存并重新构建
  执行以下命令清理旧资源缓存，确保release版本使用最新的图标：

  flutter clean
  flutter build apk --release
  

• 用Image Asset Studio生成标准图标
  如果你不确定图标是否符合规范，用Android Studio工具生成：右键res文件夹 → New → Image Asset，选择Launcher Icons (Adaptive and Legacy)，导入你的图标后调整前景大小和背景，生成的资源会自动适配各分辨率和Android版本。

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