Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Changer l'icone de l'application pour windows¶

Par défaut, l'icône du jeu exporté sera l'icône de Godot. Il y a beaucoup de chance que vous souhaitiez changer cela pour votre jeu. Il y a deux types d'icônes pouvant être changées sur Windows : l'icône du fichier et l'icône de la barre des tâches.

Création d’un fichier ICO¶

Windows n'utilise pas de formats tels que png ou jpg pour les icônes d'application. Il utilise plutôt un format propre à Windows appelé ICO. Vous pouvez créer votre icône d'application dans n'importe quel programme, mais vous devrez la convertir en fichier ICO à l'aide d'un programme tel que GIMP.

Ce tutoriel vidéo explique comment exporter un fichier ICO avec GIMP.

Il est également possible de convertir une image PNG en un fichier ICO compatible hiDPI à l’aide de cette commande ImageMagick :

magick convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

Selon la version d'ImageMagick que vous avez installée, vous devrez peut-être omettre le magick et lancer cette commande à la place :

convert icon.png -define icon:auto-resize=256,128,64,48,32,16 icon.ico

Avertissement

Pour que le fichier ICO remplace effectivement l'icône Godot par défaut, il doit contenir toutes les tailles incluses dans l'icône Godot par défaut : 16×16, 32×32, 48×48, 64×64, 128×128, 256×256. Si le fichier ICO ne contient pas toutes les tailles, l'icône Godot par défaut sera conservée pour les tailles qui n'ont pas été remplacées.

La commande ImageMagick ci-dessus prend cela en compte.

Changer l'icône de la barre des tâches¶

L'icône de la barre des tâches correspond à celle qui apparaît sur la barre des tâches quand le jeu est lancé.

Pour changer l'icône de la barre des tâches, allez dans Projet → Paramètres du projet → Application → Config → Icon. Cliquez sur l'icône de dossier et sélectionnez votre fichier ICO.

Ce paramètre ne modifie que l'icône de votre jeu exporté sur Windows. Pour définir l'icône pour macOS, utilisez Macos Native Icon. Et pour toute autre plate-forme, utilisez le paramètre Icon.

Changer l'icône du fichier¶

Dans Godot 3.5 et ultérieur , vous pouvez changer l'icône du fichier sans outils externes en utilisant godoticon. Changer l'icône du fichier de cette façon devrait fonctionner pour les exécutables contenant un PCK intégré.

Avertissement

Il y a des problèmes connus lors du changement de l'icône de l'application dans les exécutables qui intègrent un fichier PCK. Il est recommandé d'éviter d'utiliser rcedit pour l'instant si vous choisissez d'activer l'option Embed Pck pour votre préréglage d'exportation Windows dans la boîte de dialogue Exporter.

L'icône du fichier est celle de l'exécutable sur lequel on clique pour lancer le jeu.

Avant de le sélectionner dans les options d'exportation, vous allez devoir installer un outil supplémentaire appelé rcedit. Vous pouvez le télécharger ici.

Après le téléchargement, vous devez indiquer à Godot le chemin vers l'exécutable rcedit sur votre ordinateur. Allez dans Editeur → Paramètres de l'éditeur → Exporter → Windows. Cliquez sur l'icône dossier de l'entrée rcedit. Recherchez et sélectionnez l’exécutable rcedit.

Note

Les utilisateurs Linux et macOS devront également installer WINE pour utiliser rcedit.

On macOS 10.15 (Catalina) or later, make sure to use a 64-bit version of both WINE and rcedit since 32-bit applications aren't supported anymore.

Vous devriez maintenant avoir tout en place pour changer l'icône du fichier. Pour ce faire, vous devrez spécifier l'icône lors de l'exportation. Allez sur Projet → Exporter. En supposant que vous avez déjà créé un préréglage Windows Desktop, sélectionnez votre icône au format ICO dans le champ Application → Icon.

Avertissement

All the supplied metadata must be valid. Most importantly, the version identifiers must take the form major.minor.patch.revision where every component is required and is a positive integer. For instance, 1.2.0.0 is valid but 1.2.0 is not.

If you provide invalid metadata in the export preset, the application icon won't change as rcedit will fail to change the executable's metadata.

Note

Si rcedit ne parvient pas à changer l'icône, vous pouvez à la place compilez vos propres modèles d'exportation Windows avec l'icône changée. Pour ce faire, remplacez platform/windows/godot.ico par votre propre fichier ICO avant de compiler les modèles d'exportation.

Une fois que cela est fait, vous pouvez spécifier vos modèles d'exportation comme modèles d'exportation personnalisés dans le préréglage d'exportation de Windows de votre projet.

Tester le résultat¶

Vous pouvez maintenant exporter le projet. Si cela a fonctionné correctement, vous devriez voir ceci :

Note

Si votre icône n'apparaît pas correctement, sous Windows 10, essayez de vider le cache des icônes. Pour ce faire, ouvrez Run et appelez la commande ie4uinit.exe -ClearIconCache ou ie4uinit.exe -show.