diff --git a/README.md b/README.md index fe2bc48b93..ca0326b808 100644 --- a/README.md +++ b/README.md @@ -64,47 +64,58 @@ with the icon located in the image path specified above and given the name "laun Shown below is the full list of attributes which you can specify within your Flutter Launcher Icons configuration. -- `android`/`ios` +### 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`: 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) +- `min_sdk_android`: Specify android min sdk value +**The next two attributes are only used when generating Android 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) +- `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)* -- `min_sdk_android`: Specify android min sdk value +### 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 +### Web + - `web`: Add web related configs - `generate`: Specifies weather 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 weather to generate icons for Windows platform or not - `image_path`: Path to web 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 weather to generate icons for MacOS platform or not - `image_path`: Path to macos icon.png file *Note: iOS icons should [fill the entire image](https://stackoverflow.com/questions/26014461/black-border-on-my-ios-icon) 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 - -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) - ## Flavor support Create a Flutter Launcher Icons configuration file for your flavor. The config file is called `flutter_launcher_icons-.yaml` by replacing `` by the name of your desired flavor.