Comment changer facilement le texte de l'en-tête de votre fichier dans Xcode

L'en-tête par défaut généré par Xcode

Avez-vous déjà voulu créer votre propre texte d'en-tête automatiquement chaque fois que vous créez votre propre fichier? La page d’aide de Xcode explique déjà comment procéder. Mais il y a trop d'informations là-dedans pour les nouveaux programmeurs. Donc, si vous êtes confus, suivez ce tutoriel facile!

De quoi as-tu besoin

Nous avons besoin de deux choses:

  • Un fichier plist portant ce nom: IDETemplateMacros.plist. Nous allons créer cela.
  • Un emplacement pour mettre le fichier ci-dessus.

Création du fichier plist

  1. Ouvrez Xcode.
  2. Créer un nouveau fichier, le raccourci est Commande + N.
  3. Faites défiler la liste jusqu'aux fichiers de ressources et choisissez Fichier de type Liste de propriétés.
  4. Cliquez sur Suivant et donnez le nom de fichier IDETemplateMacros.plist.
  5. Enregistrez-le sur le bureau pour le moment afin que nous puissions le trouver facilement.

Nous allons déplacer ce fichier à un endroit approprié plus tard.

Personnaliser la macro de texte

Une fois le fichier plist créé, il est temps de le modifier et d’ajouter la clé de macro pour le texte de l’en-tête.

  • Ouvrez le fichier de pliste que vous avez créé en double-cliquant dessus. Je préfère utiliser Xcode comme éditeur de plist.
  • Mettez en surbrillance la ligne Racine et cliquez sur le signe +.
Ajoutez une nouvelle clé en cliquant sur le signe +.
  • Tapez FILEHEADER comme nom de clé et assurez-vous que le type est String.
Tapez FILEHEADER comme nom de clé pour faire référence au texte placé en haut de chaque nouveau fichier.

FILEHEADER est une macro de texte faisant référence au texte placé en haut de chaque nouveau fichier dans Xcode. L'aide Xcode contient la liste de toutes les macros si vous souhaitez en savoir plus sur les autres macros.

  • C'est la partie amusante, créez votre texte d'en-tête personnalisé dans votre éditeur de texte.

J'ai créé mon propre en-tête personnalisé en utilisant TextEdit, comme indiqué ci-dessous. Vous pouvez écrire n'importe quoi et le rendre aussi joli que vous le souhaitez:

Ce qui compte ici, ce sont les touches entourées de trois caractères de soulignement. PACKAGENAME, FULLUSERNAME et DATE seront remplacés par XCode avec ses valeurs internes.

D'autres macros de texte pouvant être ajoutées: COPYRIGHT, FILEBASENAME, ORGANIZATIONNAME. N’oubliez pas d’entourer les touches de macro avec trois traits de soulignement avant et après le texte.

Pour obtenir la liste complète des macros de texte, reportez-vous à la section d’aide de Xcode avec le mot-clé «Référence des macros de texte».

  • Après avoir créé votre en-tête personnalisé, sélectionnez Tout et copiez le texte.
  • Ouvrez le fichier IDETemplateMacros.plist que vous avez créé, double-cliquez sur la ligne de valeur et collez le texte à cet endroit. Appuyez sur Entrée.

La ligne de l’éditeur Xcode Plist ne peut afficher qu’une seule ligne. C’est donc acceptable si vous ne voyez que la dernière ligne de votre en-tête.

Collez l'en-tête personnalisé de l'éditeur de texte dans la cellule de valeur.

Toutes nos félicitations! Vous avez créé votre propre texte d’en-tête et il est prêt à être utilisé.

Choix de l'emplacement du fichier plist

Nous devons maintenant placer ce fichier à un emplacement où Xcode lira la macro. Xcode recherchera une macro de texte aux emplacements suivants:

  • Données utilisateur du projet:

.xcodeproj / xcuserdata / [nom d'utilisateur] .xcuserdatad /

  • Données partagées du projet:

.xcodeproj / xcshareddata / IDETemplateMacros.plist

  • Données d'utilisateur de l'espace de travail:

.xcworkspace / xcuserdata / [nom d'utilisateur] .xcuserdatad /

  • Données partagées de l'espace de travail:

.xcworkspace / xcshareddata /

  • Données utilisateur Xcode:

~ / Library / Developer / Xcode / UserData /

Vous pouvez mettre le fichier plist que vous avez créé dans l’un des répertoires ci-dessus. Si vous travaillez sur un projet, vous pouvez utiliser l'utilisateur du projet ou le répertoire de données partagé. Si vous travaillez sur un espace de travail, vous pouvez utiliser l'utilisateur de l'espace de travail ou des données partagées. Ou, si vous voulez vraiment utiliser votre en-tête personnalisé dans tous vos projets, vous pouvez placer le fichier plist dans le répertoire de données utilisateur Xcode.

L'exemple ci-dessous montre comment placer le fichier dans un répertoire de données utilisateur du projet. Et c'est tout!

Choix du répertoire de données utilisateur du projet pour l’emplacement du fichier plist. (<NomProjet> .xcodeproj / xcuserdata / [nomutilisateur] .xcuserdatad /).

Essayons

Maintenant que tout est fini. Ouvrez le projet ou l'espace de travail dans lequel vous avez placé le fichier plist. Ou vous pouvez ouvrir n’importe quel projet si vous le placez dans le répertoire de données utilisateur Xcode.

Créez un nouveau fichier Swift et admirez votre travail! C'est facile n'est-ce pas !!

Si vous aimez mon post, s'il vous plaît aimer et partager. Je vous remercie!