一个 Flutter 包,可简化在多个平台上更新应用启动图标的过程。它会自动为 Android、iOS、macOS、Windows 和 Linux 生成并放置图标,确保品牌一致性,无需手动配置。通过在单一配置文件中定义图标设置,开发者可以节省时间并减少构建过程中的错误。该包与 Flutter 工作流程无缝集成,并支持自定义图标大小和资源目录。
适合场景
自动化多平台应用的图标生成
在 CI/CD 流水线中更新应用图标
在各种设备上保持品牌的一致性
简化新团队成员的入职流程
减少手动构建配置错误
主要特点
支持 Android、iOS、macOS、Windows 和 Linux
从单一源自动生成图标
可自定义的图标大小和资源路径
与 Flutter 构建流程集成
可通过 pubspec.yaml 配置
适合对象
跨平台 Flutter 开发人员
使用 CI/CD 工作流的团队
注重品牌一致性的应用开发者
初学者学习Flutter应用自定义
需要频繁更新图标的工作项目
使用建议
需要正确的图标源文件
可能与现有的图标配置冲突
与所有第三方构建工具不兼容
需要正确的权限以访问平台特定的目录
自动化后建议手动验证
原始 README
以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。
Flutter Launcher Icons
A command-line tool which simplifies the task of updating your Flutter app's launcher icon. Fully flexible, allowing you to choose what platform you wish to update the launcher icon for and if you want, the option to keep your old launcher icon in case you want to revert back sometime in the future.
:book: Guide
1. Setup the config file
Run the following command to create a new config automatically:
dart run flutter_launcher_icons:generate
This will create a new file called flutter_launcher_icons.yaml in your flutter project's root directory.
If you want to override the default location or name of the config file, use the -f flag:
dart run flutter_launcher_icons:generate -f <your config file name here>
To override an existing config file, use the -o flag:
dart run flutter_launcher_icons:generate -o
OR
Add your Flutter Launcher Icons configuration to your pubspec.yaml.
An example is shown below. More complex examples can be found in the example projects.
After setting up the configuration, all that is left to do is run the package.
flutter pub get
dart run flutter_launcher_icons
If you name your configuration file something other than flutter_launcher_icons.yaml or pubspec.yaml you will need to specify
the name of the file when running the package.
flutter pub get
dart run flutter_launcher_icons -f <your config file name here>
Note: If you are not using the existing pubspec.yaml ensure that your config file is located in the same directory as it.
In the above configuration, the package is setup to replace the existing launcher icons in both the Android and iOS project
with the icon located in the image path specified above and given the name "launcher_icon" in the Android project and "Example-Icon" in the iOS project.
:mag: Attributes
Shown below is the full list of attributes which you can specify within your Flutter Launcher Icons configuration.
Global
image_path: The location of the icon image file which you want to use as the app launcher icon.
Android
android
true: Override the default existing Flutter launcher icon for the platform specified
false: Ignore making launcher icons for this platform
icon/path/here.png: This will generate a new launcher icons for the platform with the name you specify, without removing the old default existing Flutter launcher icon.
image_path_android: The location of the icon image file specific for Android platform (optional - if not defined then the image_path is used)
min_sdk_android: Specify android min sdk value
The next two attributes are only used when generating Android launcher icon
adaptive_icon_background: The color (E.g. "#ffffff") or image asset (E.g. "assets/images/christmas-background.png") which will
be used to fill out the background of the adaptive icon.
adaptive_icon_foreground: The image asset which will be used for the icon foreground of the adaptive icon
Note: Adaptive Icons will only be generated when both adaptive_icon_background and adaptive_icon_foreground are specified. (the image_path is not automatically taken as foreground)
adaptive_icon_foreground_inset: This is used to add padding (in %) to the foreground icon when generating an adaptive icon. The default value is 16.
adaptive_icon_monochrome: The image asset which will be used for the icon
foreground of the Android 13+ themed icon. For more information see Android Adaptive Icons
IOS
ios
true: Override the default existing Flutter launcher icon for the platform specified
false: Ignore making launcher icons for this platform
icon/path/here.png: This will generate a new launcher icons for the platform with the name you specify, without removing the old default existing Flutter launcher icon.
image_path_ios: The location of the icon image file specific for iOS platform (optional - if not defined then the image_path is used)
remove_alpha_ios: Removes alpha channel for IOS icons
image_path_ios_dark_transparent: The location of the dark mode icon image file specific for iOS 18+ platform. Note: Apple recommends this icon to be transparent. For more information see Apple Human Interface Guidelines for App Icons
image_path_ios_tinted_grayscale: The location of the tinted mode icon image file specific for iOS 18+ platform. Note: This icon should be an grayscale image. Use desaturate_tinted_to_grayscale_ios: true to automatically desaturate the image provided here.
desaturate_tinted_to_grayscale_ios: Automatically desaturates tinted mode icon image to grayscale, defaults to false
background_color_ios: The color (in the format "#RRGGBB") to be used as the background when removing the alpha channel. It is used only when the remove_alpha_ios property is set to true. (optional - if not defined then #ffffff is used)
Web
web: Add web related configs
generate: Specifies whether to generate icons for this platform or not
image_path: Path to web icon.png
background_color: Updates background_color in web/manifest.json
theme_color: Updates theme_color in web/manifest.json
Windows
windows: Add Windows related configs
generate: Specifies whether to generate icons for Windows platform or not
image_path: Path to windows icon.png
icon_size: Windows app icon size. Icon size should be within this constrains 48<=icon_size<=256, defaults to 48
MacOS
macos: Add MacOS related configs
generate: Specifies whether to generate icons for MacOS platform or not
Create a Flutter Launcher Icons configuration file for your flavor. The config file is called flutter_launcher_icons-<flavor>.yaml by replacing <flavor> by the name of your desired flavor.
You may receive a message similar to the following
Because flutter_launcher_icons >=0.9.0 depends on args 2.0.0 and flutter_native_splash 1.2.0 depends on args ^2.1.1, flutter_launcher_icons >=0.9.0 is incompatible with flutter_native_splash 1.2.0.
And because no versions of flutter_native_splash match >1.2.0 <2.0.0, flutter_launcher_icons >=0.9.0 is incompatible with flutter_native_splash ^1.2.0.
So, because enstack depends on both flutter_native_splash ^1.2.0 and flutter_launcher_icons ^0.9.0, version solving failed.
pub get failed (1; So, because enstack depends on both flutter_native_splash ^1.2.0 and flutter_launcher_icons ^0.9.0, version solving failed.)
For a quick fix, you can temporarily override all references to a dependency: See here for an example.
:eyes: Example
Note: This is showing a very old version (v0.0.5)
Special thanks
Thanks to Brendan Duncan for the underlying image package to transform the icons.
Big thank you to all the contributors to the project. Every PR / reported issue is greatly appreciated!