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 d'une application, est définie en appelant la méthode QWindow::setIcon().

Pour modifier l'icône du fichier d'application exécutable lui-même, tel qu'il est présenté 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

Tout d'abord, créez un fichier bitmap au format ICO contenant l'image de l'icône. Cette opération peut être réalisée à l'aide de Microsoft Visual Studio : Sélectionnez File >> New, puis Icon File.

Il est également possible de créer un fichier .ico à partir d'un ensemble d'images en utilisant l'outil de conversion d'ImageMagick :

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

Stockez 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, voir À propos des fichiers de ressources.

Une fois que vous avez le fichier .rc, ajoutez-y des informations sur le fichier ICO et utilisez-le pour configurer l'icône de votre application.

L'extrait suivant montre comment l'application d'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})

Remarquez 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 makefiles, 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 maintenant représenté par votre icône dans l'explorateur.

Cependant, si vous avez déjà un fichier .rc, par exemple, avec le nom myapp.rc, que vous voulez 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, les étapes nécessaires sont les suivantes : créez d'abord un fichier .rc et exécutez le programme rc ou windres sur le fichier .rc, puis liez votre application au fichier .res qui en résulte.

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

L'icône de l'application, généralement affichée dans la zone d'accueil de l'application, est définie en appelant QWindow::setIcon() sur une fenêtre. Il est possible que le programme apparaisse dans la zone d'ancrage de l'application avant l'appel de la fonction, auquel cas une icône par défaut apparaîtra pendant l'animation de rebond.

Pour s'assurer que l'icône correcte apparaît, à la fois lors du lancement de l'application et dans le Finder, il est nécessaire d'utiliser une technique dépendant de la plate-forme.

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

Utilisation de CMake sur 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, le nom du fichier .icns doit être associé à la variable MACOSX_BUNDLE_ICON_FILE.

L'extrait suivant montre comment l'application d'exemple Photo Surface utilise CMake pour configurer l'icône de l'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})

Remarquez 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 d'accès absolu au fichier d'icône. Cette variable est ensuite utilisée pour configurer MACOSX_PACKAGE_LOCATION, qui définit l'emplacement d'installation du fichier icône. Enfin, add_executable utilise la variable app_icon_macOS pour définir l'icône de l'application.

Utilisation de qmake sur macOS

Si vous utilisez toujours qmake pour générer vos makefiles, 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 permettra à qmake de placer vos icônes au bon endroit et de créer 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 de PropertyListEditor, que vous trouverez dans Developer/Applications).
2. Associez votre enregistrement .icns à l'enregistrement CFBundleIconFile dans le fichier Info.plist (toujours à l'aide de 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 module d'application.

Définition de l'icône de l'application sur les bureaux Linux courants

Dans cette section, nous décrivons brièvement les problèmes liés à la fourniture d'icônes pour les applications dans 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 les deux bureaux et peut également s'appliquer à d'autres, mais certains détails sont spécifiques à chacun d'eux. La principale source d'information sur les normes utilisées par ces bureaux Linux est freedesktop.org. Pour obtenir des informations sur d'autres bureaux Linux, veuillez vous référer à la documentation des bureaux qui vous intéressent.

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

Vous trouverez plus d'informations sur les fichiers d'entrée du bureau dans la spécification de l'entrée du bureau.

Bien que les fichiers d'entrée du bureau puissent utilement encapsuler les détails de l'application, nous devons toujours stocker les icônes à l'emplacement conventionnel pour chaque environnement de bureau. Un certain nombre d'emplacements pour les icônes sont indiqués dans la spécification du thème des icônes.

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

Environnement de bureau K (KDE)

Les icônes d'application peuvent être installées pour tous les utilisateurs ou pour chaque utilisateur. Un utilisateur connecté à son bureau KDE 4 peut découvrir ces emplacements en utilisant kde4-config, par exemple, en tapant ce qui suit 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

Généralement, la liste des chemins d'accès séparés par deux points et affichée sur la sortie stdout comprend le chemin d'accès à l'icône spécifique à l'utilisateur et le chemin d'accès à l'ensemble du système. Sous 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 souhaiterez peut-être profiter du système de construction de KDE pour configurer votre application. Cela garantit que vos icônes sont installées dans les emplacements appropriés pour KDE.

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

GNOME

Les icônes des applications sont stockées dans un répertoire standard du système contenant des fichiers indépendants de l'architecture. Cet emplacement peut être déterminé en utilisant gnome-config, par exemple en tapant ce qui suit dans une fenêtre de terminal :

gnome-config --datadir

Le chemin imprimé sur stdout fait référence à un emplacement qui devrait contenir un répertoire appelé pixmaps; la structure du répertoire pixmaps est décrite dans la spécification du thème d'icônes.

Si vous développez exclusivement pour GNOME, vous pouvez utiliser l'ensemble standard d'outils de construction GNU. Pour plus d'informations, voir la section Directives d'intégration. Cela garantit que vos icônes sont installées dans les emplacements appropriés pour GNOME.

Le site web des développeurs de GNOME, https://developer.gnome.org/, fournit de plus amples informations sur le développement d'applications.