Un outil de ligne de commande qui simplifie la tâche de mise à jour de l’icône de lancement de votre application Flutter

Un outil de ligne de commande qui simplifie la tâche de mise à jour de l’icône du lanceur de votre application Flutter. Entièrement flexible, vous permettant de choisir la plate-forme pour laquelle vous souhaitez mettre à jour l’icône du lanceur et, si vous le souhaitez, l’option de conserver votre ancienne icône de lanceur au cas où vous voudriez revenir en arrière dans le futur.

📖Guider

1. Configurez le fichier de configuration

Ajoutez votre configuration Flutter Launcher Icons à votre pubspec.yaml ou créez un nouveau fichier de configuration appelé flutter_launcher_icons.yaml. Un exemple est illustré ci-dessous. Exemples plus complexes peut être trouvé dans les exemples de projets.

dev_dependencies:
  flutter_launcher_icons: "^0.11.0"

flutter_icons:
  android: "launcher_icon"
  ios: true
  image_path: "assets/icon/icon.png"
  min_sdk_android: 21 # android min sdk min:16, default 21
  web:
    generate: true
    image_path: "path/to/image.png"
    background_color: "#hexcode"
    theme_color: "#hexcode"
  windows:
    generate: true
    image_path: "path/to/image.png"
    icon_size: 48 # min:48, max:256, default: 48
  macos:
    generate: true
    image_path: "path/to/image.png"

Si vous nommez votre fichier de configuration autrement que flutter_launcher_icons.yaml ou pubspec.yaml vous devrez spécifier le nom du fichier lors de l’exécution du package.

flutter pub get
flutter pub run flutter_launcher_icons -f <your config file name here>

Remarque : Si vous n’utilisez pas le pubspec.yaml assurez-vous que votre fichier de configuration se trouve dans le même répertoire que lui.

2. Exécutez le package

Après avoir défini la configuration, il ne reste plus qu’à exécuter le package.

flutter pub get
flutter pub run flutter_launcher_icons

Si vous rencontrez des problèmes merci de les signaler ici.

Dans la configuration ci-dessus, le package est configuré pour remplacer les icônes de lanceur existantes dans les projets Android et iOS par l’icône située dans le chemin d’image spécifié ci-dessus et portant le nom « launcher_icon » dans le projet Android et « Example-Icon » dans le projet iOS.

🔍 Attributs

Vous trouverez ci-dessous la liste complète des attributs que vous pouvez spécifier dans la configuration de votre Flutter Launcher Icons.

Mondial

• image_path: L’emplacement du fichier d’image d’icône que vous souhaitez utiliser comme icône du lanceur d’applications.

Android

• android

  • true: Remplacer l’icône du lanceur Flutter existant par défaut pour la plate-forme spécifiée
  • false: Ignorer la création d’icônes de lanceur pour cette plate-forme
  • icon/path/here.png: Cela générera une nouvelle icône de lanceur pour la plate-forme avec le nom que vous spécifiez, sans supprimer l’ancienne icône de lanceur Flutter existante par défaut.

• image_path: L’emplacement du fichier image de l’icône que vous souhaitez utiliser comme icône du lanceur d’applications

• image_path_android: L’emplacement du fichier image de l’icône spécifique à la plate-forme Android (facultatif – s’il n’est pas défini, l’image_path est utilisée)

• min_sdk_android: Spécifiez la valeur minimale du SDK Android
  Les deux attributs suivants ne sont utilisés que lors de la génération de l’icône du lanceur Android

• adaptive_icon_background: La couleur (Ex. "#ffffff") ou un élément d’image (par exemple "assets/images/christmas-background.png") qui sera utilisé pour remplir l’arrière-plan de l’icône adaptative.

• adaptive_icon_foreground: L’élément d’image qui sera utilisé pour le premier plan de l’icône de l’icône adaptative
  Remarque : les icônes adaptatives ne seront générées que lorsque adaptive_icon_background et adaptive_icon_foreground sont spécifiés. (l’image_path n’est pas automatiquement prise en premier plan)

  

iOS

• ios
  • true: Remplacer l’icône du lanceur Flutter existant par défaut pour la plate-forme spécifiée
  • false: Ignorer la création d’icônes de lanceur pour cette plate-forme
  • icon/path/here.png: Cela générera une nouvelle icône de lanceur pour la plate-forme avec le nom que vous spécifiez, sans supprimer l’ancienne icône de lanceur Flutter existante par défaut.
• image_path_ios: L’emplacement du fichier image de l’icône spécifique à la plate-forme iOS (facultatif – s’il n’est pas défini, l’image_path est utilisée)
• remove_alpha_ios: Supprime le canal alpha pour les icônes IOS

la toile

• web: Ajouter des configurations liées au Web
  • generate: Spécifie la météo pour générer ou non des icônes pour cette plateforme
  • image_path: Chemin d’accès à l’icône Web.png
  • background_color: Mises à jour Couleur de l’arrière plan dans web/manifest.json
  • theme_color: Mises à jour theme_color dans web/manifest.json

les fenêtres

• windows: Ajouter des configurations liées à Windows
  • generate: Spécifie la météo pour générer ou non des icônes pour la plate-forme Windows
  • image_path: Chemin d’accès à l’icône Web.png
  • icon_size: taille de l’icône de l’application Windows. La taille de l’icône doit respecter ces contraintes 48<=icon_size<=256, par défaut à 48

Mac OS

• macos: Ajouter des configurations liées à MacOS
  • generate: Spécifie la météo pour générer ou non des icônes pour la plate-forme MacOS
  • image_path: Chemin d’accès au fichier macos icon.png

Remarque : les icônes iOS doivent remplir toute l’image et ne pas contenir de bordures transparentes.

Support de saveur

Créez un fichier de configuration Flutter Launcher Icons pour votre version. Le fichier de configuration s’appelle flutter_launcher_icons-<flavor>.yaml en remplaçant <flavor> par le nom de votre saveur désirée.

Le format du fichier de configuration est le même.

Un exemple de projet avec le support de saveur activé a été ajouté aux exemples.

❓ Dépannage

Énuméré quelques problèmes courants avec des solutions pour eux

La couleur de l’icône générée est différente de l’icône d’origine

Causé par une mise à jour de la dépendance d’image utilisée par Flutter Launcher Icons.

Use #AARRGGBB for colors instead of ##AABBGGRR, to be compatible with Flutter image class.

Problème connexe

Le premier plan de l’image est trop grand/trop petit

Pour de meilleurs résultats, essayez d’utiliser une image de premier plan qui a un rembourrage un peu comme celui de l’exemple.

Problème connexe

Dépendance incompatible

Vous pouvez recevoir un message semblable au suivant

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.
pub 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.)

Pour une solution rapide, vous pouvez remplacer temporairement toutes les références à une dépendance : Voir ici pour un exemple.

👀 Exemple

Remarque : ceci montre une version très ancienne (v0.0.5)

Remerciement spécial

• Merci à Brendan Duncan pour le sous-jacent paquet d’images pour transformer les icônes.
• Un grand merci à tous les contributeurs du projet. Chaque PR / problème signalé est grandement apprécié !

GitHub

Voir Github