Personnalisation de votre fichier info.plist

Remonter à Préparation d'une application macOS pour son déploiement

Remonter à Préparation d'une application iOS pour le déploiement

RAD Studio écrit certaines options de vos applications macOS ou iOS dans un fichier *.info.plist, qui est inclus dans votre package d'application final quand vous déployez votre application sur macOS ou iOS. Ce fichier définit des informations comme le code de version ou le nom d'affichage de votre application, la liste des fonctionnalités requises par votre application, et ainsi de suite.

Généralement, vous n'avez pas besoin de modifier ce fichier, et vous pouvez laisser RAD Studio s'occuper de tout. Néanmoins, RAD Studio vous permet de personnaliser le contenu du fichier *.info.plist si des données personnalisées devant être incluses dans ce fichier ne peuvent pas être définies visuellement dans vos options de projet.

Quand vous déployez une application sur les plates-formes macOS ou iOS pour la première fois, RAD Studio ajoute un fichier au dossier de votre projet : info.plist.TemplateOSX.xml ou info.plist.TemplateiOS.xml. Chaque fois que vous déployez votre application sur macOS or iOS, RAD Studio lit le fichier correspondant, remplace des espaces réservés du fichier par les valeurs réelles de vos options de projet, et écrit le contenu résultant dans un fichier de sortie : <plate-forme>\<configuration de construction>\*.info.plist. Ce fichier de sortie est le fichier *.info.plist qui est inclus dans le package d'application généré par RAD Studio lorsque vous déployez vos applications sur les plates-formes cible macOS ou iOS.

Pour personnaliser le fichier de sortie *.info.plist d'un projet unique, modifiez le contenu de info.plist.TemplateOSX.xml ou info.plist.TemplateiOS.xml dans le dossier de votre projet.

Les fichiers modèles ajoutés par RAD Studio à un projet quand vous déployez ce projet sur les plates-formes cible macOS ou iOS pour la première fois viennent du fichier correspondant de C:\Users\<nom d'utilisateur>\AppData\Roaming\Embarcadero\BDS\22.0. Si vous voulez que vos nouveaux projets utilisent un modèle différent, modifiez ce fichier.

Recréation des fichiers modèles info.plist

Le fichier modèle info.plist généré par RAD Studio peut changer d'une version de RAD Studio à une autre. Pour déployer un projet qui a été déployé initialement avec une version différente de RAD Studio, soyez particulièrement vigilant avec les fichiers modèles info.plist du dossier de votre projet.

Il existe deux scénarios possibles :

• Vous voulez conserver les fichiers modèles info.plist anciens puisqu'ils sont personnalisés.
• Vous n'avez pas besoin de conserver les fichiers modèles info.plist anciens.

Conservation des fichiers modèles info.plist

Vous pouvez souhaiter conserver vos fichiers modèles info.plist si vous les avez modifiés manuellement. Dans ce cas, vous devez suivre les étapes suivantes :

1. Ouvrez le dossier de votre projet.
2. Assurez-vous de sauvegarder vos fichiers modèles info.plist.
3. Supprimez les fichiers modèles info.plist du dossier de votre projet.
4. Ouvrez votre projet avec la nouvelle version de RAD Studio.
5. Pour chaque plate-forme cible affectée (macOS, Périphérique iOS - 32 bits, Périphérique iOS - 64 bits et Simulateur iOS) :
   1. Sélectionnez le noeud de plate-forme cible dans le Gestionnaire de projets.
   2. Déployez votre projet sur la plate-forme cible sélectionnée.

      Remarque : Le déploiement de votre projet crée un nouveau fichier modèle info.plist pour la plate-forme cible sélectionnée.

   3. Allez au dossier de votre projet pour vérifier s'il existe un nouveau fichier modèle info.plist.
   4. Ajoutez manuellement vos modifications au nouveau fichier modèle info.plist.

Création de nouveaux fichiers modèles info.plist

Si vous n'avez pas modifié les fichiers modèles info.plist, suivez ces étapes pour permettre à RAD Studio de créer de nouveaux fichiers :

1. Ouvrez le dossier de votre projet.
2. Supprimez les fichiers modèles info.plist, s'ils existent.
3. Ouvrez votre projet avec la nouvelle version de RAD Studio.
4. Pour chaque plate-forme cible affectée (macOS, Périphérique iOS - 32 bits, Périphérique iOS - 64 bits et Simulateur iOS) :
   1. Sélectionnez le noeud de plate-forme cible dans le Gestionnaire de projets.
   2. Déployez votre projet sur la plate-forme cible sélectionnée.

      Remarque : Le déploiement de votre projet crée un nouveau fichier modèle info.plist pour la plate-forme cible sélectionnée.

   3. Allez au dossier de votre projet pour vérifier s'il existe un nouveau fichier modèle info.plist.

Contenu des fichiers modèles info.plist

Les fichiers modèles info.plist contiennent deux espaces réservés que RAD Studio remplace par des paires clé-valeur pendant la présentation du déploiement des applications. La valeur suivante indique les mots clés de info.plist qui remplacent chaque espace réservé :

Espace réservé	Contenu de remplacement
<%VersionInfoPListKeys%>	Les mots clés définis dans la page Informations de version.
<%ExtraInfoPListKeys%>	Mots clés sur l'illustration graphique, basés sur les informations de la page Application. Pour iOS : Mots clés sur la prise en charge de l'orientation, basés sur les informations de la page Orientation. Mots clés pour la désactivation de la fonctionnalité APS si la fonctionnalité "Activer les requêtes de protocole HTTP" est désactivée dans la page Liste des droits. CFBundleShortVersionString, basé sur la valeur des champs correspondants de la page Informations de version. UIRequiredDeviceCapabilities vaut "arm64" pour Périphérique iOS - 64 bits ou "armv7" pour les autres plates-formes. Pour les plates-formes de périphérique iOS : CFBundleSupportedPlatforms vaut "iPhoneOS". CFBundleResourceSpecification vaut "ResourceRules.plist" (RAD Studio génère ce fichier). MinimumOSVersion est la valeur configurée pour l'option "Version iOS minimale supportée" dans la page d'options suivante : Delphi : Projet > Options > Compilateur Delphi > Liaison C++ : Projet > Options > Lieur C++ Pour la configuration de plate-forme Magasin d'applications : DTPlatformName vaut "iphoneos". Les valeurs de DTPlatformBuild et DTXcodeBuild dépendent du SDK que vous utilisez pour construire votre application.

Voir aussi

• Personnalisation de votre liste des droits pour iOS ou macOS

• Personnalisation de votre fichier AndroidManifest.xml