[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-9256":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},9256,"flutter_launcher_icons","fluttercommunity\u002Fflutter_launcher_icons","fluttercommunity","Flutter Launcher Icons - A package 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. Maintainer: @MarkOSullivan94","https:\u002F\u002Fpub.dev\u002Fpackages\u002Fflutter_launcher_icons",null,"Dart",2116,423,24,117,0,1,6,29.88,"MIT License",false,"master",[24,25,26],"dart","flutter","hacktoberfest","2026-06-12 02:02:04","# Flutter Launcher Icons\n\n[![Flutter Community: flutter_launcher_icons](https:\u002F\u002Ffluttercommunity.dev\u002F_github\u002Fheader\u002Fflutter_launcher_icons)](https:\u002F\u002Fgithub.com\u002Ffluttercommunity\u002Fcommunity)\n\n[![pub package](https:\u002F\u002Fimg.shields.io\u002Fpub\u002Fv\u002Fflutter_launcher_icons.svg)](https:\u002F\u002Fpub.dartlang.org\u002Fpackages\u002Fflutter_launcher_icons)\n\nA 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.\n\n## :book: Guide\n\n### 1. Setup the config file\n\nRun the following command to create a new config automatically:\n\n```shell\ndart run flutter_launcher_icons:generate\n```\n\nThis will create a new file called `flutter_launcher_icons.yaml` in your `flutter` project's root directory.\n\nIf you want to override the default location or name of the config file, use the `-f` flag:\n\n```shell\ndart run flutter_launcher_icons:generate -f \u003Cyour config file name here>\n```\n\nTo override an existing config file, use the `-o` flag:\n\n```shell\ndart run flutter_launcher_icons:generate -o\n```\n\nOR\n\nAdd your Flutter Launcher Icons configuration to your `pubspec.yaml`.  \nAn example is shown below. More complex examples [can be found in the example projects](https:\u002F\u002Fgithub.com\u002Ffluttercommunity\u002Fflutter_launcher_icons\u002Ftree\u002Fmaster\u002Fexample).\n\n```yaml\ndev_dependencies:\n  flutter_launcher_icons: \"^0.14.4\"\n\nflutter_launcher_icons:\n  android: \"launcher_icon\"\n  ios: true\n  image_path: \"assets\u002Ficon\u002Ficon.png\"\n  min_sdk_android: 21 # android min sdk min:16, default 21\n  web:\n    generate: true\n    image_path: \"path\u002Fto\u002Fimage.png\"\n    background_color: \"#hexcode\"\n    theme_color: \"#hexcode\"\n  windows:\n    generate: true\n    image_path: \"path\u002Fto\u002Fimage.png\"\n    icon_size: 48 # min:48, max:256, default: 48\n  macos:\n    generate: true\n    image_path: \"path\u002Fto\u002Fimage.png\"\n```\n\n### 2. Run the package\n\nAfter setting up the configuration, all that is left to do is run the package.\n\n```shell\nflutter pub get\ndart run flutter_launcher_icons\n```\n\nIf you name your configuration file something other than `flutter_launcher_icons.yaml` or `pubspec.yaml` you will need to specify\nthe name of the file when running the package.\n\n```shell\nflutter pub get\ndart run flutter_launcher_icons -f \u003Cyour config file name here>\n```\n\nNote: If you are not using the existing `pubspec.yaml` ensure that your config file is located in the same directory as it.\n\nIf you encounter any issues [please report them here](https:\u002F\u002Fgithub.com\u002Ffluttercommunity\u002Fflutter_launcher_icons\u002Fissues).\n\nIn the above configuration, the package is setup to replace the existing launcher icons in both the Android and iOS project\nwith 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.\n\n## :mag: Attributes\n\nShown below is the full list of attributes which you can specify within your Flutter Launcher Icons configuration.\n\n### Global\n\n- `image_path`: The location of the icon image file which you want to use as the app launcher icon.\n\n### Android\n\n- `android`\n  - `true`: Override the default existing Flutter launcher icon for the platform specified\n  - `false`: Ignore making launcher icons for this platform\n  - `icon\u002Fpath\u002Fhere.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.\n- `image_path_android`: The location of the icon image file specific for Android platform (optional - if not defined then the image_path is used)\n- `min_sdk_android`: Specify android min sdk value\n**The next two attributes are only used when generating Android launcher icon**\n\n- `adaptive_icon_background`: The color (E.g. `\"#ffffff\"`) or image asset (E.g. `\"assets\u002Fimages\u002Fchristmas-background.png\"`) which will\nbe used to fill out the background of the adaptive icon.\n- `adaptive_icon_foreground`: The image asset which will be used for the icon foreground of the adaptive icon\n*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)*\n- `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`.\n- `adaptive_icon_monochrome`: The image asset which will be used for the icon\nforeground of the Android 13+ themed icon. For more information see [Android Adaptive Icons](https:\u002F\u002Fdeveloper.android.com\u002Fdevelop\u002Fui\u002Fviews\u002Flaunch\u002Ficon_design_adaptive#user-theming)\n\n### IOS\n\n- `ios`\n  - `true`: Override the default existing Flutter launcher icon for the platform specified\n  - `false`: Ignore making launcher icons for this platform\n  - `icon\u002Fpath\u002Fhere.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.\n- `image_path_ios`: The location of the icon image file specific for iOS platform (optional - if not defined then the image_path is used)\n- `remove_alpha_ios`: Removes alpha channel for IOS icons\n- `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](https:\u002F\u002Fdeveloper.apple.com\u002Fdesign\u002Fhuman-interface-guidelines\u002Fapp-icons#iOS-iPadOS)*\n- `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.*\n- `desaturate_tinted_to_grayscale_ios`: Automatically desaturates tinted mode icon image to grayscale, *defaults to false*\n- `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)\n\n### Web\n\n- `web`: Add web related configs\n  - `generate`: Specifies whether to generate icons for this platform or not\n  - `image_path`: Path to web icon.png\n  - `background_color`: Updates *background_color* in `web\u002Fmanifest.json`\n  - `theme_color`: Updates *theme_color* in `web\u002Fmanifest.json`\n\n### Windows\n\n- `windows`: Add Windows related configs\n  - `generate`: Specifies whether to generate icons for Windows platform or not\n  - `image_path`: Path to windows icon.png\n  - `icon_size`: Windows app icon size. Icon size should be within this constrains *48\u003C=icon_size\u003C=256, defaults to 48*\n  \n### MacOS\n\n- `macos`: Add MacOS related configs\n  - `generate`: Specifies whether to generate icons for MacOS platform or not\n  - `image_path`: Path to macos icon.png file\n\n*Note: iOS icons should [fill the entire image](https:\u002F\u002Fstackoverflow.com\u002Fquestions\u002F26014461\u002Fblack-border-on-my-ios-icon) and not contain transparent borders.*\n\n## Flavor support\n\nCreate a Flutter Launcher Icons configuration file for your flavor. The config file is called `flutter_launcher_icons-\u003Cflavor>.yaml` by replacing `\u003Cflavor>` by the name of your desired flavor.\n\nThe configuration file format is the same.\n\nAn example project with flavor support enabled [has been added to the examples](https:\u002F\u002Fgithub.com\u002Ffluttercommunity\u002Fflutter_launcher_icons\u002Ftree\u002Fmaster\u002Fexample\u002Fflavors).\n\n## :question: Troubleshooting\n\nListed a couple common issues with solutions for them\n\n### Generated icon color is different from the original icon\n\nCaused by an update to the image dependency which is used by Flutter Launcher Icons.\n\n```txt\nUse #AARRGGBB for colors instead of #AABBGGRR, to be compatible with Flutter image class.\n```\n\n[Related issue](https:\u002F\u002Fgithub.com\u002Ffluttercommunity\u002Fflutter_launcher_icons\u002Fissues\u002F98)\n\n### Dependency incompatible\n\nYou may receive a message similar to the following\n\n```log\nBecause 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.\nAnd because no versions of flutter_native_splash match >1.2.0 \u003C2.0.0, flutter_launcher_icons >=0.9.0 is incompatible with flutter_native_splash ^1.2.0.\nSo, because enstack depends on both flutter_native_splash ^1.2.0 and flutter_launcher_icons ^0.9.0, version solving failed.\npub 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.)\n```\n\nFor a quick fix, you can temporarily override all references to a dependency: [See here for an example](https:\u002F\u002Fgithub.com\u002Ffluttercommunity\u002Fflutter_launcher_icons\u002Fissues\u002F262#issuecomment-879872076).\n\n## :eyes: Example\n\n[![Video Example](https:\u002F\u002Fi.imgur.com\u002FR28hqdz.png)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=RjNAxwcP3Tc)\n\nNote: This is showing a very old version (v0.0.5)\n\n### Special thanks\n\n- Thanks to Brendan Duncan for the underlying [image package](https:\u002F\u002Fpub.dev\u002Fpackages\u002Fimage) to transform the icons.\n- Big thank you to all the contributors to the project. Every PR \u002F reported issue is greatly appreciated!\n","fluttercommunity\u002Fflutter_launcher_icons 是一个简化 Flutter 应用启动图标更新过程的命令行工具。它支持为 Android、iOS、Web、Windows 和 macOS 平台单独或批量更新应用图标，并允许用户选择是否保留旧图标以便将来恢复。该工具使用 Dart 语言编写，具有高度灵活性和易用性。通过简单的配置文件设置（如 `flutter_launcher_icons.yaml` 或在 `pubspec.yaml` 中直接配置），开发者可以轻松指定图标路径、平台及其它相关参数。适用于需要频繁更改应用图标或希望统一管理多平台图标的 Flutter 项目开发场景。",2,"2026-06-11 03:21:53","top_language"]