diff --git a/README.md b/README.md index 2da8202822..6a7caacbc3 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,18 @@ +# Flutter Launcher Icons + [![Flutter Community: flutter_launcher_icons](https://fluttercommunity.dev/_github/header/flutter_launcher_icons)](https://github.com/fluttercommunity/community) [![Build Status](https://travis-ci.org/fluttercommunity/flutter_launcher_icons.svg?branch=master)](https://travis-ci.org/MarkOSullivan94/flutter_launcher_icons) [![pub package](https://img.shields.io/pub/v/flutter_launcher_icons.svg)](https://pub.dartlang.org/packages/flutter_launcher_icons) -# 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 +### 1. Setup the config file 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. More complex examples [can be found in the example projects](https://github.com/fluttercommunity/flutter_launcher_icons/tree/master/example). + ```yaml dev_dependencies: flutter_launcher_icons: "^0.9.3" @@ -20,33 +21,37 @@ flutter_icons: android: "launcher_icon" ios: true image_path: "assets/icon/icon.png" + web: + generate: true + image_path: "path/to/image.png" + background_color: "#hexcode" + theme_color: "#hexcode" ``` + 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. -``` +```shell flutter pub get flutter pub run flutter_launcher_icons:main -f ``` Note: If you are not using the existing `pubspec.yaml` ensure that your config file is located in the same directory as it. -#### 2. Run the package +### 2. Run the package After setting up the configuration, all that is left to do is run the package. -``` +```shell flutter pub get flutter pub run flutter_launcher_icons:main ``` If you encounter any issues [please report them here](https://github.com/fluttercommunity/flutter_launcher_icons/issues). - 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. @@ -62,7 +67,13 @@ Shown below is the full list of attributes which you can specify within your Flu - `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](https://stackoverflow.com/questions/26014461/black-border-on-my-ios-icon) and not contain transparent borders._ +- `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` + +*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 @@ -83,29 +94,27 @@ An example project with flavor support enabled [has been added to the examples]( Listed a couple common issues with solutions for them - -#### Generated icon color is different from the original icon +### Generated icon color is different from the original icon Caused by an update to the image dependency which is used by Flutter Launcher Icons. -``` +```txt Use #AARRGGBB for colors instead of ##AABBGGRR, to be compatible with Flutter image class. ``` [Related issue](https://github.com/fluttercommunity/flutter_launcher_icons/issues/98) - -#### Image foreground is too big / too small +### Image foreground is too big / too small For best results try and use a foreground image which has padding much like [the one in the example](https://github.com/fluttercommunity/flutter_launcher_icons/blob/master/example/default_example/assets/images/icon-foreground-432x432.png). [Related issue](https://github.com/fluttercommunity/flutter_launcher_icons/issues/96) -#### Dependency incompatible +### Dependency incompatible You may receive a message similar to the following -``` +```log 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.