Icône de l'application

Remonter à Options de l'application

Projet > Options > Application > Icônes

Les icônes identifient l'application dans la liste des applications, la page d'accueil ou le menu Démarrer. Les options disponibles dépendent du type de projet que vous êtes en train de développer. Voici les principales options :

• Plates-formes de bureau (VCL ou FireMonkey)
• iOS (FireMonkey seulement)
• Android (FireMonkey seulement)

Plates-formes de bureauf

Pour une application multi-périphérique, la page Application vous permet de parcourir les répertoires et de spécifier un fichier icône (.ico) pour représenter votre application Windows dans la barre des tâches.

Vous devez utiliser un fichier .ico pour une application Windows ; les autres types de fichiers graphiques ne sont pas acceptés. Vous pouvez utiliser IcoFX pour créer un fichier .ico.

Remarque: L'option Paramètres du logo du package de plate-forme Windows universelle est uniquement disponible pour les plates-formes Windows. Elle est uniquement disponible si vous déployez une application Windows au format MSIX pour le Windows Store, pas pour le débogage et le déploiement locaux.

Icône unique

L'expert Icône unique est un outil complet intégré à l'environnement de développement intégré (EDI), conçu pour rationaliser le processus de génération d'icônes et d'écrans d'accueil pour les applications utilisateur sur plusieurs plates-formes dans les applications multi-périphériques ou les applications VCL Windows.

Pour accéder à l'expert, ouvrez la boîte de dialogue Options de projet de votre application, choisissez Application > Icônes, puis utilisez le bouton Générateur d'artwork.

Attention: Pour appliquer la modification à toutes les plates-formes, sélectionnez l'option Toutes les configurations - Toutes les plates-formes dans la liste déroulante Cible au-dessus de ce bouton.

Option	Description
Couche de l'avant-plan	Sélectionnez le type d'actif (Image ou Texte). Les options changent en fonction de votre sélection. Par défaut, l'option Texte est sélectionnée, ce qui vous permet de définir les champs ci-dessous : Texte vous permet de choisir entre différents types de fonte. Couleur vous permet de personnaliser la couleur de la fonte. Echelle définit la taille de la fonte. En outre, lorsque vous sélectionnez Image, vous pouvez configurer les champs suivants : Chemin vous permet de sélectionner un fichier (.svg) enregistré sur votre ordinateur. Teinte vous permet de sélectionner une couleur pour l'image. Echelle définit la taille de la fonte.
Couche de l'arrière-plan	Sélectionnez le type d'actif (Uni ou Image), puis configurez la couche de l'arrière-plan selon votre préférence. Le type d'actif par défaut est Uni,ce qui vous permet de changer la couleur d'arrière-plan. Lorsque vous sélectionnez Image, vous pouvez configurer les champs suivants : Chemin vous permet de sélectionner un fichier (.svg) enregistré sur votre ordinateur. Teinte vous permet de sélectionner une couleur pour l'image. Echelle définit la taille de l'image.
Options	Sélectionnez la forme de l'icône. Vous avez le choix entre différentes formes telles que Arrondi, Rectangle, Légèrement arrondi, Cercle et Goutte d'eau.

Remarque: Le format préféré pour les fichiers des couches d'icône d'avant-plan et d'arrière-plan est (.svg) ; les fichiers (.png) sont également pris en charge.

Avertissement: Les images générées sont enregistrées dans un sous-dossier du dossier du projet avec le même nom de projet. Par conséquent, si vous renommez le projet, vous devez renommer manuellement le sous-dossier en conséquence.

Paramètres d'icône d'application

Les options suivantes sont disponibles pour les plates-formes Windows et macOS :

Option	Description
Icône	Spécifiez un fichier icône (.ico) à insérer dans le fichier de sortie. L'icône d'application affichée dans cette boîte de dialogue s'affiche dans l'explorateur Windows, à côté du nom du fichier de sortie. Cliquez sur Charger une icône... pour afficher la boîte de dialogue Icône de l'application et naviguer jusqu'à un fichier .ico. Cliquez sur Par défaut pour rétablir l'icône par défaut originale fournie pour votre application. RAD Studio fournit des fichiers .ico spécifiques à la personnalité ; ces fichiers sont disponibles dans le répertoire /bin de l'installation de votre produit. Chaque fichier .ico contient un ensemble d'icônes de tailles diverses. Sur les plates-formes Windows, la taille appropriée est automatiquement sélectionnée pour chaque situation. delphi_PROJECTICON.ico object_pascal_PROJECTICON.ico cbuilder_PROJECTICON.ico Pour les applications console, la définition de l'icône d'application est désactivée. Windows utilise une icône de mode console standard par défaut. Si vous voulez changer l'icône pour votre application console, voir le tutoriel suivant (EN) : Delphi @ About.com: Change the Default Application Icon for a Console Mode Delphi Application.
Icône Icns (pour les applications macOS FireMonkey)	Spécifiez un fichier icône Icns (.icns) à insérer dans le fichier de sortie. L'icône affichée dans cette boîte de dialogue sert à représenter votre application sur macOS. Cliquez sur Charger une Icns... pour afficher la boîte de dialogue Icns d'application et naviguez jusqu'à un fichier .icns. Cliquez sur Par défaut pour rétablir l'icône par défaut originale fournie pour votre application RAD Studio. RAD Studio fournit des fichiers .icns spécifiques à la personnalité ; ces fichiers sont disponibles dans le répertoire /bin de l'installation de votre produit. Les noms de fichiers sont : object_pascalPROJECTICNS.icns delphi_PROJECTICNS.icns cbuilder_PROJECTICNS.icns Chaque fichier .icns contient un ensemble d'icônes de tailles diverses. macOS sélectionne automatiquement la taille appropriée à chaque situation. Pour de plus amples informations sur la création d'une icône Icns valide pour votre application, voir : Comment configurer l'icône pour une application Mac dans Xcode ? (EN) Optimisation pour la haute résolution (EN) Pour actualiser le fichier icône icns que vous voulez déployer sur macOS, procédez comme suit : Choisissez Projet > Déploiement pour ouvrir le Gestionnaire de déploiement. Sélectionnez la configuration de construction du projet macOS dans la zone de liste déroulante Sélecteur de configuration. Cliquez sur Revenir aux valeurs par défaut pour ajouter le nouveau fichier icône icns au Gestionnaire de déploiement. Revenir aux valeurs par défaut retire toutes les entrées qui ne sont plus nécessaires, comme le précédent fichier icône icns.

Paramètres du logo du package de plate-forme Windows universelle

La fonctionnalité Paramètres du logo du package de plate-forme Windows universelle, uniquement disponible pour les plates-formes Windows, vous permet de charger un logo enregistré sur votre ordinateur ou d'utiliser un logo par défaut.

iOS

Icône unique

L'expert Icône unique pour iOS est le même que pour les plates-formes de bureau. Pour de plus amples informations, consultez la section ci-dessus.

Paramètres d'icône d'application

Dans le cas d'une application iOS, la page Application propose deux onglets :

• iPhone
• iPad

Icônes pour vos applications iOS

Pour les plates-formes iPhone et iPad, RAD Studio fournit des fichiers icône que vous pouvez utiliser pour les applications FireMonkey iOS sous la forme de fichiers .png de diverses tailles, disponibles dans le répertoire /bin/Artwork/iOS de l'installation de votre produit.

Par exemple, voici quelques-uns des noms des fichiers icônes fournis par RAD Studio :

• FM_ApplicationIcon_120x120.png
• FM_SpotlightSearchIcon_120x120.png
• FM_SettingIcon_58x58.png
• FM_NotificationIcon_40x40.png
• FM_LaunchImage_2x.png

Pour configurer les images et les icônes qui sont déployées avec votre application iOS, cliquez sur le bouton Points de suspension () dans le champ approprié de l'onglet spécifique à la plate-forme (iPhone ou iPad).

Onglet iPhone

Champ	Description
Icône d'application (120 x 120)	Icône représentant votre application. Cette icône peut être placée par vos utilisateurs sur leur écran d'accueil ; ils devront ensuite la toucher pour démarrer votre application.
Icône d'application (180x180)
Icône d'application (1024x1024)	Icône représentant votre application sur l'App Store.
Icône Spotlight (80 x 80)	Icône représentant votre application sur une recherche Spotlight.
Icône Spotlight (120 x 120)
Icône Réglages (58 x 58)	Icône représentant votre application sur l'application Réglages intégrée.
Icône Réglages (87 x 87)
Icône de notification (40 x 40)	L'icône de notification s'affiche pour les notifications de votre application.
Icône de notification (60 x 60)
Image de lancement toute apparence 2X l'échelle	L'image de lancement apparaît à la place de votre application tant que le chargement de l'application n'est pas terminé et occupe l'espace alloué à l'image.
Image de lancement apparence sombre 2X l'échelle
Image de lancement toute apparence 3X l'échelle
Image de lancement apparence sombre 3X l'échelle
Couleur d'arrière-plan de l'image de lancement	L'option Couleur d'arrière-plan de l'image de lancement vous permet de modifier la couleur d'arrière-plan pour le mode clair et le mode sombre des applications iOS.
Couleur d'arrière-plan sombre de l'image de lancement

Onglet iPad

Champ	Description
Icône d'application (152x152)	Icône représentant votre application. Cette icône peut être placée par vos utilisateurs sur leur écran d'accueil ; ils devront ensuite la toucher pour démarrer votre application.
Icône d'application (167x167)
Icône Spotlight (80 x 80)	Icône représentant votre application sur une recherche Spotlight.
Icône Réglages (58 x 58)	Icône représentant votre application sur l'application Réglages intégrée.
Icône de notification (40 x 40)	L'icône de notification s'affiche pour les notifications de votre application.
Image de lancement toute apparence 2X l'échelle	L'image de lancement apparaît à la place de votre application tant que le chargement de l'application n'est pas terminé et occupe l'espace alloué à l'image.
Image de lancement apparence sombre 2X l'échelle

Aperçu

Option	Description
Aperçu	Pour les plates-formes cible iOS, ce champ apparaît sur le côté droit de la page Application et affiche un aperçu de l'image sélectionnée.
Taille réelle	Cochez cette case pour que l'aperçu affiche l'icône dans sa taille réelle. Par défaut, l'aperçu est redimensionné pour qu'il n'occupe pas plus d'espace que l'espace disponible dans la colonne de droite. Selon la taille de l'image, il peut être nécessaire d'utiliser le défilement pour voir l'image entière.

Notes relatives à iOS

• Vous pouvez toujours configurer les images et icônes dans les onglets iPhone et iPad, quel que soit le périphérique iOS cible actuellement sélectionné.

• Les fichiers image doivent être des fichiers .png et avoir les dimensions requises. Sinon, vous obtiendrez un message d'erreur.

• Toutes les images ne sont pas nécessaires (pour de plus amples informations, voir le document Custom Icon and Image Creation Guidelines (EN) d'Apple).
  • Si vous ne voulez pas fournir d'image, effacez le champ correspondant et cliquez sur OK.
  • Si vous effacez un champ image, assurez-vous que la cible sélectionnée sur la page Application est définie sur Toutes les configurations. Les champs vides sont remplis avec les chemins des cibles parent, et Toutes les configurations est la seule cible qui n'est pas écrasée.

• Vous pouvez aussi définir la valeur de la propriété UIDeviceFamily associée à votre application iOS. UIDeviceFamily est une valeur du fichier info.plist associé à votre application iOS ; UIDeviceFamily définit les périphériques iOS sur lesquels votre application est prise en charge. Pour les applications iOS, la valeur UIDeviceFamily par défaut est iPhone & iPad, mais vous pouvez limiter votre application iOS à iPad ou iPhone si vous le souhaitez. Définissez UIDeviceFamily dans la liste Clé/Valeur de Projet > Options > Informations de version.

• Les applications iOS peuvent être conçues pour prendre en charge le mode d'apparence Tout ou Sombre ou les deux modes en même temps.

Apparence claire	Apparence sombre
La couleur de fond de l'écran de lancement et l'image de l'écran de lancement du mode d'apparence "Tout" sont utilisées dans une application iOS lorsque le périphérique cible : Exécute n'importe quelle version d'iOS A son apparence système définie sur Claire.	La couleur d'arrière-plan et l'image de l'écran de lancement du mode d'apparence Sombre sont utilisées dans une application iOS lorsque le périphérique cible : Exécute une version d'iOS égale ou supérieure à 13.0 A son apparence système définie sur Sombre.

• Les options Couleur d'arrière-plan de l'image de lancement et Couleur d'arrière-plan sombre de l'image de lancement sont disponibles uniquement sous l'onglet iPhone, mais elles s'appliquent aux périphériques iPhone et iPad.

• La prise en charge du mode d'apparence Sombre dans une application iOS est facultative. Si une application iOS n'a pas besoin de prendre en charge le mode d'apparence Sombre pour l'instant, vous pouvez désactiver les options Image de lancement apparence sombre 2X l'échelle et Image de lancement apparence sombre 3X l'échelle.

Android

Icône unique

L'expert Icône unique pour Android est presque identique à celui pour les plates-formes de bureau. Pour de plus amples informations, consultez la section ci-dessus. La différence réside dans l'expert Ecrans d'accueil.

Après avoir configuré les paramètres d'icône, vous pouvez utiliser un ensemble d'options similaire pour configurer les modes Clair et Sombre des écrans d'accueil.

Ce processus remplit toutes les icônes de la plate-forme en une fois, générant des éléments de la taille attendue.

Remarque: Pour la plate-forme Android, RAD Studio fournit des fichiers icône et des images d'accueil que vous pouvez utiliser pour les applications FireMonkey Android sous la forme de fichiers .png de diverses tailles, disponibles dans le répertoire \bin\Artwork\Android de l'installation de votre produit.

Paramètres d'icône d'application

L'option Icônes pour les plates-formes Android vous permet de configurer des icônes pour votre projet. Pour ce faire, RAD Studio présente plusieurs onglets dans lesquels vous pouvez configurer les icônes de votre application.

Lanceur

L'option Lanceur vous permet de choisir entre Icône adaptative et Lanceur existant. Cette icône peut être placée par vos utilisateurs sur leur écran d'accueil ; ils devront ensuite la toucher pour démarrer votre application.

Par défaut, l'option Utiliser une icône adaptative est sélectionnée, car Google recommande de l'utiliser pour toutes les versions modernes d'Android. Avec cette option, vous pouvez configurer les champs suivants.

Champ	Description
Avant-plan	Cette option vous permet de configurer les couches de l'icône, que vous pouvez sélectionner directement sur votre ordinateur.
Arrière-plan
Couche monochrome

Pour utiliser le Lanceur existant, désélectionnez l'option Utiliser une icône adaptative. Vous pourrez ensuite configurer les champs suivants :

Champ	Description
36x36 ldpi	Icône représentant votre application.
48x48 mdpi
72x72 hdpi
96x96 xhdpi
144x144 xxhdpi
192x192 xxxhdpi

Notification

Dans l'onglet Notification, vous pouvez modifier les icônes dont les utilisateurs se servent pour les notifications.

Vous pouvez utiliser la couleur d'accentuation en cochant la case correspondante et choisir une couleur dans la liste déroulante Couleur d'accentuation des notifications.

Remarque: Par défaut, la case Utiliser la couleur d'accentuation n'est pas cochée.

Configurez l'icône vectorisée en la sélectionnant sur votre périphérique. Cette option est activée par défaut.

Configurez votre icône de notification dans différentes tailles en la choisissant sur votre périphérique.

Champ	Description
24x24 mdpi	Icônes de notification pour votre application.
36x36 hdpi
48x48 xhdpi
72x72 xxhdpi
96x96 xxxhdpi

Images d'accueil

Ce sont les images qui s'affichent à l'ouverture de votre application. Vous pouvez spécifier une image unique ou plusieurs images de tailles différentes. Pour minimiser le changement d'échelle, utilisez un bitmap multi-résolution ou plusieurs images de tailles différentes.

Vous pouvez activer ou désactiver les images d'accueil de votre projet en utilisant la case à cocher Inclure l'image de démarrage. Vous pouvez en outre changer la couleur d'arrière-plan et la couleur d'arrière-plan sombre en en choisissant d'autres dans les listes déroulantes.

RAD Studio vous permet d'utiliser un écran d'accueil vectorisé et un écran d'accueil existant. Ces deux options sont activées par défaut.

Pour activer l'écran d'accueil vectorisé, sélectionnez l'option Utiliser des images vectorisées. Si cette option est activée, vous pouvez la configurer avec les champs suivants :

Champs	Description
Avant-plan	Cette option vous permet de configurer l'avant-plan en mode clair et mode sombre.
Avant-plan sombre
Avant-plan Android 12	Cette option vous permet de configurer l'avant-plan en mode clair et mode sombre.
Avant-plan Android 12 sombre

Pour activer l'écran d'accueil existant, sélectionnez l'option Inclure l'image d'accueil. Si cette option est activée, vous pouvez la configurer avec les champs suivants :

Champ	Description
426x320 small	Images d'accueil de votre application.
470x320 normal
640x480 large
960x720 xlarge

Mode mosaïque de l'écran d'accueil : lorsque le mode mosaïque est activé, l'image est répétée. Utilisez cette zone de liste déroulante pour définir le mode mosaïque à l'aide des options suivantes :

Mode mosaïque	Description
disabled	L'image apparaît une fois sur l'écran.
clamp	La couleur de la bordure de l'image est répliquée jusqu'à remplir l'écran.
repeat	L'image est reproduite horizontalement et verticalement jusqu'à remplir l'écran.
mirror	L'image est reproduite horizontalement et verticalement jusqu'à remplir l'écran avec un effet miroir entre les images successives.

Pour de plus amples informations, voir la documentation Android relative au mode mosaïque.

Gravité de l'écran d'accueil : la gravité de l'écran d'accueil détermine la position de l'image sur l'écran lorsque sa taille est inférieure à celle de l'écran. La gravité de l'écran d'accueil est prise en compte uniquement lorsque le mode mosaïque de l'écran d'accueil est désactivé. Pour de plus amples informations, voir la documentation Android relative à la gravité.

Aperçu

Chaque expert Icône présente une section Aperçu dans laquelle vous pouvez configurer différentes options.

Option	Description
Aperçu	Pour les plates-formes cible Android, ce champ apparaît sur le côté droit de la page Application et affiche un aperçu de l'image sélectionnée.
Taille réelle	Cochez cette case pour que l'aperçu affiche l'icône dans sa taille réelle. Par défaut, l'aperçu est redimensionné pour qu'il n'occupe pas plus d'espace que l'espace disponible dans la colonne de droite. Selon la taille de l'image, il peut être nécessaire d'utiliser le défilement pour voir l'image entière.

Notes relatives aux images dans Android

• Vous pouvez toujours configurer vos images d'application dans l'onglet Artwork, quel que soit le périphérique mobile cible actuellement sélectionné.
• Les fichiers image doivent être des fichiers *.png* et avoir les dimensions requises. Sinon, vous obtiendrez un message d'erreur.
• Android autorise l'utilisation d'images 9-patch qui déterminent la manière dont l'image sera étirée.
  • Vous pouvez convertir une image au format 9-patch en utilisant l'outil draw9patch disponible dans C:\Utilisateurs\Public\Documents\Embarcadero\Studio\23.0\CatalogRepository\adt-bundle-windows-x86-20131030\tools\lib.
  • Lorsque vous utilisez l'outil draw9patch, vous pouvez charger des images .png et .9.png ; une fois votre image terminée, elle est enregistrée avec l'extension .9.png. Draw9patch fonctionne avec un périmètre de 1 pixel, de sorte que les images .png sont enregistrées avec 4 pixels supplémentaires (2 horizontalement et 2 verticalement) ; les images .9.png ne sont pas modifiées.
  • Réglez les repères noirs d'une largeur de 1 pixel en haut et à gauche pour déterminer l'échelle de l'image. Pour de plus amples informations, voir la documentation Android relative au dessin d'images 9-patch.

• Toutes les images sont facultatives.
  • Si vous ne voulez pas fournir d'image, effacez le champ correspondant et cliquez sur OK.
  • Si vous effacez un champ image, assurez-vous que la cible sélectionnée sur la page Application est définie sur Toutes les configurations. Les champs vides sont remplis avec les chemins des cibles parent, et Toutes les configurations est la seule cible qui n'est pas écrasée.
• Lorsque vous exécutez une application Android sur un Kindle Fire, le carrousel affiche l'icône de lancement de votre application au format mdpi (48x48), même si vous fournissez une icône de meilleure résolution. L'icône apparaît donc floue. Cependant, cela se produit uniquement lorsque l'application Android est installée sur le Kindle Fire via une connexion USB. Lorsque les utilisateurs téléchargent l'application depuis le magasin d'applications Amazon, l'icône de l'application affichée sur le carrousel du Kindle Fire est téléchargée à partir de ce magasin d'applications, où vous pouvez charger une icône de petit format (114x114) et une icône de grand format (512x512). Pour de plus amples informations, voir la documentation Amazon.
• Pour déployer une application Android sans écran d'accueil, avant de désactiver l'option Inclure l'image d'accueil et de reconstruire l'application, vous devez manuellement supprimer les fichiers splash_image_def.xml, styles.xml et styles-v21.xml créés pour une construction précédente de votre application (ces fichiers sont normalement placés dans le sous-dossier '<Active-Target-Platform>\<Active-Build-Configuration>').
• Icônes adaptatives : conformément à la documentation Android, nous ne devrions pas attacher ou utiliser des masques de format d'icône, car Android doit configurer l'icône en fonction de son thème afin de normaliser le format des icônes du système d'exploitation. Par conséquent, la valeur de forme est ignorée pour les icônes adaptatives Android.
• Ecran d'accueil : pour la plate-forme Android, nous ignorons actuellement la couleur d'arrière-plan (à l'extérieur de la surface de l'image).

Rubriques

• Boîte de dialogue Icns d'application
• Page Apparence
• Page Orientation

Voir aussi

• Création et déploiement d'icônes d'apps
• Activation de l'aide dans les applications
• Préparation d'une application iOS pour son déploiement
• Préparation d'une application Android pour son déploiement
• Utilisation d'images 9-patch dans Android
• Personnalisation du fichier manifeste d'une application Windows