Définition de l'icône de l'application

L'icône de l'application, généralement affichée dans le coin supérieur gauche des fenêtres de premier niveau de l'application, est définie en appelant la méthode ` QWindow::setIcon()`.

Pour modifier l’icône du fichier exécutable de l’application lui-même, telle qu’elle apparaît sur le bureau (c’est-à-dire avant le lancement de l’application), il est nécessaire d’utiliser une autre technique, qui dépend de la plate-forme.

Définition de l'icône de l'application sous Windows

Commencez par créer un fichier bitmap au format ICO contenant l’image de l’icône. Pour ce faire, utilisez Microsoft Visual Studio : sélectionnez « File >> New », puis choisissez « Icon File ».

Il est également possible de créer un fichier « .ico » à partir d’un ensemble d’images à l’aide de l’outil « convert » d’ImageMagick :

magick.exe convert icon-16.png icon-32.png icon-256.png icon.ico

Enregistrez le fichier ICO dans le répertoire du code source de votre application, par exemple sous le nom appico.ico.

Utilisation de CMake sous Windows

Pour configurer l’icône de votre application, un fichier de ressources contenant des informations sur l’icône est nécessaire. Un fichier de ressources est un fichier texte qui contient des informations sur les ressources de l’application, telles que les icônes, les curseurs, les polices, etc. Pour plus d’informations sur les fichiers de ressources et leur contenu, consultez la section À propos des fichiers de ressources.

Une fois que vous disposez du fichier ` .rc `, ajoutez-y les informations relatives au fichier ICO et utilisez-le pour configurer l'icône de votre application.

L'extrait de code suivant montre comment l’application exemple Photo Surface utilise CMake pour configurer une icône d’application :

    set(app_icon_resource_windows "${CMAKE_CURRENT_SOURCE_DIR}/resources/photosurface.rc")
    qt_add_executable(photosurfaceexample main.cpp ${app_icon_resource_windows})

Notez que la commande ` set ` définit la variable ` app_icon_windows `, qui contient le chemin d’accès au fichier RC. Cette variable est utilisée avec la commande ` add_executable ` pour définir l’icône de l’application.

Utilisation de qmake sous Windows

Si vous utilisez toujours qmake pour générer vos fichiers makefile, vous devez ajouter une seule ligne à votre fichier de projet .pro:

RC_ICONS = myappico.ico

Enfin, régénérez votre makefile et votre application. Le fichier .exe sera désormais représenté par votre icône dans l’Explorateur.

Toutefois, si vous disposez déjà d’un fichier ` .rc `, par exemple nommé ` myapp.rc`, que vous souhaitez réutiliser, les deux étapes suivantes seront nécessaires. Tout d’abord, ajoutez une seule ligne de texte au fichier ` myapp.rc ` :

IDI_ICON1               ICON    "myappico.ico"

Ensuite, ajoutez cette ligne à votre fichier ` myapp.pro ` :

RC_FILE = myapp.rc

Si vous n’utilisez pas qmake, procédez comme suit : créez d’abord un fichier .rc, puis exécutez le programme rc ou windres sur le fichier .rc. Liez ensuite votre application au fichier .res ainsi obtenu.

Définition de l’icône de l’application sous macOS

L’icône de l’application, généralement affichée dans le Dock, est définie en appelant la fonction ` QWindow::setIcon()` sur une fenêtre. Il est possible que le programme apparaisse dans le Dock avant l’appel de cette fonction ; dans ce cas, une icône par défaut s’affichera pendant l’animation de rebond.

Pour garantir l’affichage de la bonne icône, tant au lancement de l’application que dans le Finder, il est nécessaire d’utiliser une technique spécifique à la plate-forme.

Bien que de nombreux programmes permettent de créer des fichiers d’icônes (.icns), il est recommandé d’utiliser le programme iconutil fourni par Apple. iconutil est un outil en ligne de commande qui convertit les dossiers d’icônes en fichiers icns haute résolution prêts à être déployés. L’utilisation de cet outil compresse également le fichier icns résultant ; vous n’avez donc pas besoin d’effectuer de compression supplémentaire.

Utilisation de CMake sous macOS

Pour configurer l’icône de l’application, le fichier Info.plist généré par CMake doit contenir les informations relatives à l’icône. Pour ce faire, il suffit de définir le nom du fichier .icns dans la variable MACOSX_BUNDLE_ICON_FILE.

L'extrait de code suivant montre comment l'application d'exemple Photo Surface utilise CMake pour configurer une icône d'application :

    # The MACOSX_BUNDLE_ICON_FILE variable is added to the Info.plist
    # generated by CMake. This variable contains the .icns file name,
    # without the path.
    set(MACOSX_BUNDLE_ICON_FILE photosurface.icns)

    # And the following tells CMake where to find and install the file itself.
    set(app_icon_macos "${CMAKE_CURRENT_SOURCE_DIR}/resources/photosurface.icns")
    set_source_files_properties(${app_icon_macos} PROPERTIES
           MACOSX_PACKAGE_LOCATION "Resources")

    qt_add_executable(photosurfaceexample MACOSX_BUNDLE main.cpp ${app_icon_macos})

Notez que la première commande ` set ` définit la variable ` MACOSX_BUNDLE_ICON_FILE `, qui est nécessaire pour ajouter le fichier d’icône au fichier ` Info.plist `. La deuxième commande ` set ` définit la variable ` app_icon_macos ` avec le chemin absolu vers le fichier d’icône. Cette variable est ensuite utilisée pour configurer `MACOSX_PACKAGE_LOCATION`, qui définit l’emplacement d’installation du fichier d’icône. Enfin, la commande ` add_executable ` utilise la variable ` app_icon_macOS ` pour définir l’icône de l’application.

Utilisation de qmake sous macOS

Si vous utilisez toujours qmake pour générer vos fichiers makefile, il vous suffit d’ajouter une seule ligne à votre fichier de projet .pro. Par exemple, si le nom de votre fichier d’icône est myapp.icns et que votre fichier de projet est myapp.pro, ajoutez cette ligne à myapp.pro:

ICON = myapp.icns

Cela garantira qu’ qmake place vos icônes au bon endroit et crée une entrée Info.plist pour l’icône.

Si vous n’utilisez pas qmake, vous devez effectuer les opérations suivantes manuellement :

1. Créez un fichier « Info.plist » pour votre application (à l’aide du modèle PropertyListEditor disponible à l’adresse Developer/Applications).
2. Associez votre enregistrement « .icns » à l’enregistrement « CFBundleIconFile » dans le fichier Info.plist (à nouveau, à l’aide de l’outil PropertyListEditor).
3. Copiez le fichier Info.plist dans le répertoire Contents de votre bundle d'application.
4. Copiez le fichier « .icns » dans le répertoire « Contents/Resources » de votre bundle d'application.

Configuration de l’icône d’application sur les environnements de bureau Linux courants

Dans cette section, nous décrivons brièvement les enjeux liés à la fourniture d’icônes pour les applications sur deux environnements de bureau Linux courants : KDE et GNOME. La technologie de base utilisée pour décrire les icônes d’application est la même pour ces deux environnements de bureau et peut également s’appliquer à d’autres, mais certains détails sont spécifiques à chacun d’entre eux. La principale source d’informations sur les normes utilisées par ces environnements de bureau Linux est le site freedesktop.org. Pour plus d’informations sur d’autres environnements de bureau Linux, veuillez vous reporter à la documentation relative aux environnements qui vous intéressent.

Souvent, les utilisateurs n'utilisent pas directement les fichiers exécutables, mais lancent les applications en cliquant sur des icônes situées sur le bureau. Ces icônes sont des représentations de « fichiers d'entrée du bureau » qui contiennent une description de l'application, y compris des informations sur son icône. Les deux environnements de bureau sont capables de récupérer les informations contenues dans ces fichiers et les utilisent pour générer des raccourcis vers les applications sur le bureau, dans le menu Démarrer et sur le panneau.

Vous trouverez plus d’informations sur les fichiers d’entrée de bureau dans la spécification Desktop Entry.

Bien que les fichiers d’entrée du bureau permettent de regrouper utilement les détails de l’application, il reste nécessaire de stocker les icônes à l’emplacement conventionnel pour chaque environnement de bureau. Plusieurs emplacements pour les icônes sont indiqués dans la spécification des thèmes d’icônes.

Bien que le chemin d’accès utilisé pour localiser les icônes dépende du bureau utilisé et de sa configuration, la structure des répertoires sous chacun d’entre eux doit suivre le même schéma : les sous-répertoires sont classés par thème, taille d’icône et type d’application. En général, les icônes d’application sont ajoutées au thème hicolor ; ainsi, une icône d’application carrée de 32 pixels serait stockée dans le répertoire hicolor/32x32/apps, situé sous le chemin d’accès aux icônes.

K Desktop Environment (KDE)

Les icônes d’application peuvent être installées pour être utilisées par tous les utilisateurs, ou de manière spécifique à chaque utilisateur. Un utilisateur actuellement connecté à son bureau KDE 4 peut découvrir ces emplacements à l’aide de kde4-config, par exemple en tapant la commande suivante dans une fenêtre de terminal :

kde4-config --path icon

Les applications utilisant Qt 5 et KDE Frameworks 5 trouveront leurs icônes dans la liste renvoyée par cette commande :

qtpaths --locate-dirs GenericDataLocation icons

En règle générale, la liste des chemins séparés par des deux-points affichée sur la sortie standard (stdout) comprend le chemin d'accès aux icônes spécifique à l'utilisateur et le chemin d'accès à l'échelle du système. Dans ces répertoires, il devrait être possible de localiser et d'installer des icônes conformément aux conventions décrites dans la spécification des thèmes d'icônes.

Si vous développez exclusivement pour KDE, vous pouvez tirer parti du système de compilation KDE pour configurer votre application. Cela garantit que vos icônes sont installées aux emplacements appropriés pour KDE.

Le site web des développeurs KDE se trouve à l'adresse https://techbase.kde.org/.

GNOME

Les icônes d’application sont stockées dans un répertoire standard commun à tout le système, contenant des fichiers indépendants de l’architecture. Cet emplacement peut être déterminé à l’aide de la commande ` gnome-config`, par exemple en saisissant la commande suivante dans une fenêtre de terminal :

gnome-config --datadir

Le chemin d’accès affiché sur la sortie standard (stdout) fait référence à un emplacement qui devrait contenir un répertoire nommé pixmaps; la structure des répertoires au sein du répertoire pixmaps est décrite dans la spécification des thèmes d’icônes.

Si vous développez exclusivement pour GNOME, vous pouvez utiliser l’ensemble standard d’outils de compilation GNU. Pour plus d’informations, consultez la section « Directives d’intégration ». Cela garantit que vos icônes sont installées aux emplacements appropriés pour GNOME.

Le site web des développeurs GNOME, https://developer.gnome.org/, fournit davantage d’informations sur le développement d’applications.