Accueil
» MAC OS X
»
Comment modifier un fichier plist sur macOS avec Xcode
Comment modifier un fichier plist sur macOS avec Xcode
Vous pouvez modifier un fichier de liste de propriétés (.plist) sous macOS dans l'éditeur structuré d'Xcode. Sauvegardez le fichier, ouvrez-le dans Xcode, modifiez uniquement les clés et valeurs documentées, puis enregistrez. Évitez de modifier le bundle installé d'une application tierce : modifier une application signée peut invalider sa signature ou empêcher les mises à jour. Pour votre propre application, modifiez le code source du projet ou les paramètres de compilation, puis recompilez.
Quand faut-il modifier directement un fichier plist ?
Les listes de propriétés contiennent des données structurées : chaînes de caractères, nombres, valeurs booléennes, tableaux et dictionnaires. La liste de propriétés d'une application Info.plistdécrit son bundle ; des fichiers plist distincts peuvent stocker les préférences. Utilisez le fichier et la clé documentés par l'application : créer une clé ne permettra pas d'ajouter la prise en charge d'un paramètre.
Avant toute modification, vérifiez si le fichier contient des métadonnées d'application ou une préférence utilisateur. Si vous souhaitez modifier une fonctionnalité d'une application que vous utilisez, consultez les paramètres ou la documentation de cette application. Un fichier de préférences peut être écrasé au lancement ou à la fermeture de l'application ; celui d'un module installé Info.plistn'est pas un panneau de paramètres général.
Pour un projet Xcode que vous gérez, vérifiez d'abord le panneau d'informations et les paramètres de compilation de la cible. Xcode peut générer des fichiers lors de la compilation ; la modification d'une copie compilée peut donc être temporaire. Le guide d'éditionInfo.plist d'Apple décrit l'éditeur structuré ; sa documentation sur les paramètres de compilation explique les valeurs générées.
Modifier un fichier plist avec Xcode
1. Installez Xcode
Téléchargez Xcode depuis le Mac App Store . Il est actuellement gratuit ; consultez la fiche produit pour connaître la configuration requise pour votre Mac. Lancez Xcode une fois l’installation terminée.
La fiche produit de Xcode sur le Mac App Store avec le bouton « Obtenir ».
2. Effectuez une sauvegarde fonctionnelle
Localisez le fichier plist dans le Finder et dupliquez-le ou copiez-le dans un dossier de travail avant de le modifier. Conservez l'original jusqu'à la validation des modifications. Stockez vos sauvegardes en dehors du .apppaquet de l'application ; l'ajout de fichiers à cet emplacement peut altérer son contenu signé.
Effectuez une sauvegarde séparée avant toute modification.
3. Trouvez le fichier dans une application, si nécessaire.
Pour examiner le contenu d'un paquet d'application, cliquez dessus dans le Finder en maintenant la touche Contrôle enfoncée, puis choisissez « Afficher le contenu du paquet » . Vous verrez alors ses dossiers internes. Utilisez cette fonctionnalité pour localiser un fichier ou modifier uniquement une application que vous gérez et que vous pouvez recompiler ou resigner ; n'appliquez pas de correctif directement à une application tierce.
Le Finder révèle les fichiers internes d'une application.
4. Ouvrez le fichier plist dans le bundle
Ouvrez le dossier `.plist` Contents, puis recherchez le fichier ` Info.plist.plist`. D'autres fichiers `.plist` peuvent se trouver ailleurs ; consultez la documentation de l'application ou du projet. Pour un fichier isolé, utilisez son emplacement habituel dans le Finder.
Le fichier Info.plist se trouve dans le dossier Contents de l'application.
5. Ouvrez le fichier dans Xcode
Cliquez sur le fichier plist en maintenant la touche Contrôle enfoncée, puis choisissez Ouvrir avec > Xcode . Si Xcode est absent, choisissez Autre et sélectionnez-le dans Applications. Vous pouvez également ouvrir Xcode et utiliser Fichier > Ouvrir . Un fichier plist structuré s'affiche sous forme de lignes contenant une clé, un type et une valeur.
Sélectionnez Xcode dans Ouvrir avec.
6. Modifier une valeur existante ou ajouter une ligne
Cliquez sur une valeur existante pour la modifier. Pour ajouter un paramètre, cliquez en maintenant la touche Contrôle enfoncée dans l'éditeur et choisissez « Ajouter une ligne » , ou cliquez sur le bouton « Ajouter ». Utilisez la clé exacte indiquée par l'application ; les clés mal orthographiées ou non prises en charge peuvent être ignorées.
Ajouter une clé de liste de propriétés documentée.
7. Vérifiez le type de valeur et enregistrez-la.
Respectez le format de la valeur : booléen, nombre et chaîne de caractères ne sont pas interchangeables. Les tableaux contiennent des éléments ordonnés ; les dictionnaires contiennent des valeurs nommées. Évitez les clés devinées ou en double, puis appuyez sur Commande + S.
Chaîne de caractères : texte, tel qu’un identifiant ou une étiquette.
Booléen : vrai ou faux.
Nombre : un entier ou un nombre réel.
Tableau ou dictionnaire : une liste ou un groupe de valeurs nommées.
Exemple de valeur de chaîne modifiée.
8. Rouvrez et vérifiez le fichier enregistré.
Fermez et rouvrez le fichier plist pour vérifier que la valeur a bien été conservée. Pour votre projet, compilez et testez une copie. Si l'application ignore la modification, vérifiez que vous avez bien modifié le bon fichier source ; les applications peuvent lire les préférences ailleurs ou les remplacer au lancement. Restaurez la sauvegarde ou réinstallez l'application si elle ne fonctionne pas.
Fichier rouvert avec la valeur enregistrée.
Notes importantes concernant la signature et le dépannage
Apple indique que la modification d'un paquet d'application signé peut invalider sa signature ; les mises à jour peuvent également remplacer les modifications. Pour les logiciels que vous gérez, modifiez le fichier plist source ou le paramètre cible, puis recompilez. Pour les préférences courantes, utilisez les paramètres de l'application. Ne désactivez pas les protections macOS pour modifier un fichier plist.
Si Xcode ne parvient pas à enregistrer, travaillez à partir d'une copie accessible en écriture. Si une modification disparaît après une recompilation, mettez à jour le code source ou les paramètres de compilation. Si une clé est ignorée, vérifiez son orthographe, son type et son emplacement dans la documentation de l'application.