Flutter App Launcher Icon

概述

flutter_app_launcher_icon 是一个用于 Flutter 应用程序的图标管理工具,允许开发者为 iOS、macOS 和 Android 平台设置应用启动图标。本文档介绍其配置选项及使用方法。

配置选项

flutter_app_launcher_icon:
  app_icon: ''  # 默认应用图标路径

  ios:
    enable: true # optional
    app_icon: '' # iOS 平台专用图标(可选)
    enable_pad: false  # 是否启用 iPad 适配
    enable_mac: false  # 是否支持 macOS
    enable_watch: false  # 是否支持 watchOS
    launch_image: ''  # 启动画面图像

  macos:
    enable: true # optional
    app_icon: ''  # macOS 平台的应用图标
    enable_round_icon: true  # 是否启用圆形图标, 默认为 false

  android:
    enable: true # optional
    app_icon: '' # Android 平台专用图标(可选)
    enable_circle_icon: true  # 是否启用圆形图标
    firebase_notification_icon: ''  # Firebase 推送通知图标

配置说明

1. app_icon

默认的应用图标路径,适用于所有平台。如果某个平台未指定特定图标,则会使用此图标。

2. iOS 配置

  • app_icon: iOS 设备的应用图标。
  • enable_pad: 是否支持 iPad 适配。
  • enable_mac: 是否支持 macOS 适配。
  • enable_watch: 是否支持 watchOS 适配。
  • launch_image: 启动画面图像路径。

3. macOS 配置

  • app_icon: macOS 平台的应用图标。
  • enable_round_icon: 是否启用圆形图标, 默认为 false

4. Android 配置

  • app_icon: Android 设备的应用图标。
  • enable_round_icon: 是否启用圆形图标(适用于 Android 8.0+)。
  • firebase_notification_icon: Firebase 推送通知图标。

使用方法

  1. pubspec.yaml 文件中添加 flutter_app_launcher_icon 配置。
  2. 运行命令生成应用图标:
    flutter pub get
    flutter pub run flutter_app_launcher_icon:main
    
  3. 确保正确的图标已应用到各个平台。

注意事项

  • app_icon 需提供 PNG 格式的图像,推荐尺寸 1024x1024。
  • 启动画面 launch_image 需符合各个平台的规范。
  • 对于 Android,建议提供 adaptive_icon_foregroundadaptive_icon_background 以适配自适应图标。