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.
- Reverted back using old interpolation method
- Fixed issue with image dependency not working on latest version of Flutter (thanks to @sboutet06)
- Fixed iOS icon sizes which were incorrect (thanks to @sestegra)
- Removed dart_config git dependency and replaced with yaml dependency
- Added check to ensure the Android file name is valid
- Fixed issue where there was a git diff when there was no change
- Fixed issue where iOS icon would be generated when it shouldn't be
- Added support for drawables to be used for adaptive icon backgrounds
- Added support for Flutter Launcher Icons to be able to run with it's own config file (no longer necessary to add to pubspec.yaml)
- Upgraded dependencies so that it should now work with Dart 2.1.0
- Moved the package to Flutter Community
- [Android] Support for adaptive icons added
Add your Flutter Launcher Icons configuration to your pubspec.yaml
or create a new config file called flutter_launcher_icons.yaml
.
An example is shown below. A more complex example can be found in the example project.
dev_dependencies:
flutter_launcher_icons: "^0.7.2"
flutter_icons:
android: "launcher_icon"
ios: true
image_path: "assets/icon/icon.png"
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
flutter pub run flutter_launcher_icons:main -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.
After setting up the configuration, all that is left to do is run the package.
flutter pub get
flutter pub pub run flutter_launcher_icons:main
If you encounter any issues please report them here.
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.
Shown below is the full list of attributes which you can specify within your Flutter Launcher Icons configuration.
-
android
/ios
true
: Override the default existing Flutter launcher icon for the platform specifiedfalse
: Ignore making launcher icons for this platformicon/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
: The location of the icon image file which you want to use as the app 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) -
image_path_ios
: The location of the icon image file specific for iOS platform (optional - if not defined then the image_path is used)
Note: iOS icons should fill the entire image and not contain transparent borders.
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
Listed a couple common issues with solutions for them
Caused by an update to the image dependency which is used by Flutter Launcher Icons.
Use #AARRGGBB for colors instead of ##AABBGGRR, to be compatible with Flutter image class.
For best results try and use a foreground image which has padding much like the one in the example.
Note: This is showing a very old version (v0.0.5)
- 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!