flutter：更换图标icons_launcher

大前端 flutter

发布时间 : 2025-08-27 00:00

字数:494 阅读 :

安装插件
配置图标
生成图标

icons_launcher 是一个 Flutter 的命令行工具，用于简化更新应用启动图标的任务。它允许开发者为不同平台（如 Android、iOS、Web、macOS、Windows 和 Linux）生成所需的启动图标。

安装插件

flutter pub add icons_launcher -d

配置图标

在 pubspec.yaml 或单独的配置文件（如 icons_launcher.yaml）中添加图标配置：

icons_launcher:
  image_path: "assets/ic_logo_radius.png"
  platforms:
    android:
      enable: true
      notification_image: "assets/icons/ic_notification.png"
      adaptive_background_image: "assets/ic_background.png"
      adaptive_foreground_image: "assets/ic_foreground.png"
    ios:
      enable: true
      dark_path: "assets/ic_dark.png"
      tinted_path: "assets/ic_tinted.png"
    web:
      enable: true
      favicon_path: "assets/ic_favicon.png"
      sizes: [16, 32, 48, 64, 128, 256]

image_path：主图标源文件路径，工具会基于它生成多分辨率图标。建议至少 1024x1024 px。路径是在项目的根目录下面：项目个目录/assets/ic_logo_radius.png
platforms：每个平台单独配置，控制是否生成图标及平台特有选项。
enable：是否生成 Android/ios/ web/…图标。
adaptive_background_image：自适应图标背景图片（Android 8.0+ 支持）。
adaptive_foreground_image：自适应图标前景图片。
notification_image：生成 Android 推送通知的小图标，通常显示在状态栏。图标背景最好是透明，纯白色或单色线条，避免彩色图标在通知栏显示不清。
dark_path：iOS 暗黑模式图标。
inted_path：iOS 自动着色图标。
不配置 dark_path 或 tinted_path 时，iOS 会使用 image_path 生成标准图标。
favicon_path：favicon 源图标。
sizes（可选）：favicon 生成的尺寸列表，默认常用 16x16、32x32、48x48。

生成图标

配置完成后，运行以下命令生成图标：

flutter pub get
dart run icons_launcher:create
# 或者：flutter pub run icons_launcher:create

这个命令会做哪些具体修改，按平台和文件整理如下：

平台	修改内容	文件/目录
Android	自适应图标、普通图标	`android/app/src/main/res/mipmap-*/`
iOS	AppIcon 资源	`ios/Runner/Assets.xcassets/AppIcon.appiconset/`
Web	favicon	`web/icons/` 或 `web/favicon.ico`
macOS/Windows/Linux	平台启动图标	各自资源目录

不在是flutter的默认图标。