Orientação gerada a partir de informações públicas. Apenas para referência.
icons_launcher é uma ferramenta de linha de comando projetada para simplificar o processo de atualização dos ícones do lançador em aplicativos Flutter. Ela automatiza a geração e colocação dos ícones do aplicativo em múltiplas plataformas, incluindo Android, iOS, macOS, Windows e Linux. Ao simplificar a gestão de ícones, ela reduz o esforço manual e garante consistência em diferentes configurações de dispositivos. A ferramenta se integra perfeitamente aos projetos Flutter por meio do pub add, tornando-a acessível para desenvolvedores que desejam manter aparências profissionais em seus aplicativos sem fluxos de trabalho complexos.
Casos de uso
Atualizando ícones de aplicativos para novas versões
Automatizando a geração de ícones em várias plataformas
Manter a identidade visual consistente entre dispositivos
Regenerando rapidamente ícones após alterações no design
Suporte à implantação de aplicativos multiplataforma
Principais recursos
Geração de ícones multiplataforma
Integração da interface de linha de comando
Atualizações automáticas da pasta de ativos
Suporte a vários tamanhos e formatos de ícones
Configuração simples com flutter pub add
Indicado para
Desenvolvedores Flutter gerenciando marca do aplicativo
Equipes que exigem implantação consistente de ícones
Projetos direcionados para múltiplos sistemas operacionais
Desenvolvedores procurando ferramentas de automação que economizem tempo
Considerações
Requer conhecimento de linha de comando
Pode ser necessário verificação manual dos ativos gerados
Depende das dimensões corretas da imagem de entrada
Não adequado para edição em tempo real de ícones
Interação limitada com a GUI
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
🍃 Icons Launcher 🍃
A command-line tool that simplifies the task of updating your Flutter app's launcher icon. Full flexibility allows you to only update the launcher icon for specific platforms as needed.
Platform Support
Android
iOS
macOS
Web
Linux
Windows
✅
✅
✅
✅
✅
✅
Guide
1. Setup the config file
Add your Icons Launcher configuration to your pubspec.yaml or create a new config file called icons_launcher.yaml.
An example is shown below. More complex examples here.
Add config to pubspec.yaml or create a separate icons_launcher.yaml
Note
For IOS 18 icons dark and tinted also supported. See more on example config below.
2. Run the package
After setting up the configuration, all that is left to do is run the package:
flutter pub get
dart run icons_launcher:create
If you name your configuration file something other than icons_launcher.yaml or pubspec.yaml you will need to specify the name of the file when running the package.
flutter pub get
dart run icons_launcher:create --path <your config file name here>
Note
If you are not using the existing pubspec.yaml your config file must still be 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.
Attributes
Shown below is the full list of attributes which you can specify within your Icons Launcher configuration.
Icons Launcher Option
Type
Default
Description
image_path
String
null
The image file path
platforms
Object
null
Use for specific platforms to generate icons
Platforms Option
Type
Default
Description
android
Object
null
Use for specific Android platform
ios
Object
null
Use for specific iOS platform
macos
Object
null
Use for specific macOS platform
windows
Object
null
Use for specific Windows platform
web
Object
null
Use for specific Web platform
linux
Object
null
Use for specific Linux platform
Android Option
Type
Default
Description
enable
Boolean
false
Use for enable Android platform
image_path
String
null
The image file path
notification_image
String
null
Image for the notification icon
adaptive_background_color
String
null
Color for fill out the background of the adaptive icon
adaptive_background_image
String
null
Image for fill out the background of the adaptive icon
adaptive_foreground_image
String
null
Image for the icon foreground of the adaptive icon
adaptive_round_image
String
null
Image for the round icon of the adaptive icon
adaptive_monochrome_image
String
null
Image for the monochrome version of the adaptive icon
iOS Option
Type
Default
Description
enable
Boolean
false
Use for enable iOS platform
image_path
String
null
The image file path
dark_path
String
null
The dark image file path
tinted_path
String
null
The tinted image file path
Web Option
Type
Default
Description
enable
Boolean
false
Use for enable Web platform
image_path
String
null
The image file path
maskable_image_path
String
null
The maskable image file path for PWA
favicon_path
String
null
The image file path
favicon_output_extension
String
.png
Extension for favicon .png or .ico
macOS Option
Type
Default
Description
enable
Boolean
false
Use for enable macOS platform
image_path
String
null
The image file path
Windows Option
Type
Default
Description
enable
Boolean
false
Use for enable Windows platform
image_path
String
null
The image file path
Linux Option
Type
Default
Description
enable
Boolean
false
Use for enable Linux platform with snapcraft
image_path
String
null
The image file path
Flavor support
Create a Icons Launcher configuration file for your flavor. The config file is called icons_launcher-<flavor>.yaml by replacing <flavor> by the name of your desired flavor.
Example: icons_launcher-dev.yaml and icons_launcher-prod.yaml
Run with flavor:
flutter pub get
# create for dev flavor
dart run icons_launcher:create --flavor dev
# create for prod flavor
dart run icons_launcher:create --flavor prod
Alternatively, you can run multiple flavors at the same time with the following command:
dart run icons_launcher:create --flavors dev,prod
The configuration file format is the same.
Example
icons_launcher:platforms:android:enable:trueimage_path:"assets/ic_logo_radius.png"notification_image:"assets/ic_foreground.png"# adaptive_background_color: "#ffffff"adaptive_background_image:"assets/ic_background.png"adaptive_foreground_image:"assets/ic_foreground.png"adaptive_round_image:"assets/ic_logo_round.png"adaptive_monochrome_image:"assets/ic_black_white.png"ios:enable:trueimage_path:"assets/ic_logo_rectangle_light.png"# For iOS 18+ (support dark and tinted)dark_path:"assets/ic_logo_rectangle_dark.png"tinted_path:"assets/ic_logo_rectangle_tinted.png"web:enable:falseimage_path:"assets/ic_logo_rectangle_light.png"maskable_image_path:"assets/ic_logo_radius.png"favicon_path:"assets/ic_logo_round.png"# favicon_output_extension: ".ico"macos:enable:falseimage_path:"assets/macos_icon.png"windows:enable:falseimage_path:"assets/ic_logo_radius.png"linux:enable:falseimage_path:"assets/ic_logo_radius.png"