Formation PUB900 : Développer une application pour iPhone avec SwiftUI, H-2024 Travailler avec Xcode

60.5 Renommer un projet SwiftUI dans Xcode


Pour renommer correctement un projet dans Xcode :

  • Dans le Finder, renommez le dossier du projet. Ex : LeProjet.
  • Renommez le fichier .xcodeproj pour que son nom débute par le nom du dossier du projet. Ex : LeProjet.xcodeproj.
  • Ouvrez maintenant le projet dans Xcode. Une façon simple consiste à faire glisser le fichier .xcodeproj sur la vignette de Xcode dans le Dock (Xcode doit avoir été ouvert au préalable ou sa vignette doit toujours être gardée dans le Dock).
  • Ouvrez le navigateur de projet de Xcode en cliquant sur l'icône de chemise Icône chemise, filière dans la zone de gauche. L'ancien nom du projet apparaît toujours comme nom du sous-dossier. Renommez-le directement dans Xcode.
  • Renommez le fichier dont le nom se termine par App.swift. Ex : LeProjetApp.swift.
  • Renommez également la structure qui y est définie. Ex : struct LeProjet_App.
  • Dans chacun des fichiers, l'ancien nom du projet apparaît dans le commentaire d'en-tête. Modifiez ce nom partout.
  • Dans le navigateur de projet de Xcode, cliquez sur le nom du projet. Dans la zone centrale, le nom du projet est déjà corrigé. Il reste à modifier le nom de la cible sous TARGETS
  • Dans le navigateur de projet, rendez-vous dans l'onglet General /section Identity puis modifiez le Bundle Identifier. Ex : com.monnom.leprojet
  • Pour que le bon nom apparaisse sous l'AppIcon quand l'application est installée sur un téléphone ou dans le simulateur, rendez-vous dans l'onglet General / section Identity puis entrez le nom désiré dans la zone Display Name. Le nom n'a pas besoin d'être identique au nom du projet. On mettra par exemple un espace entre deux mots. Ex : Le projet.
  • Toujours dans le navigateur de projet, onglet Build Settings, entrez DEVELOPMENT_ASSET_PATHS dans la zone Filter dans le haut de l'écran. La configuration recherchée est sous la section Deployment. Modifiez la valeur qui apparaît pour qu'elle soit au format "LeProjet/Preview Content".
  • Si le projet utilise un fichier Info.plist, entrez Info.plist file dans la zone Filter dans le haut de l'écran. Corrigez le nom du dossier à cet endroit.
  • Il reste à redéfinir le schéma actif. Dans la barre de titre de Xcode, cliquez sur le nom de l'ancien schéma puis choisissez Manage Schemes. Supprimez l'ancien schéma puis créez-en un nouveau en conservant les valeurs par défaut.
  • Le projet est maintenant entièrement fonctionnel sous son nouveau nom!

En cas d'erreur

Si, après avoir renommé votre projet, vous obtenez l'erreur « Cannot preview in this file - Active scheme does not build this file » :

  • Rendez-vous dans le menu Xcode / Settings.
  • Dans l'onglet Locations, cliquez sur la flèche située à droite du chemin sous Derived Data.

    Derived Data

  • Ceci ouvre le Finder et montre le dossier Derived Data. Supprimez le dossier Derived Data.
  • Redémarrez Xcode.

▼Publicité

Veuillez noter que le contenu de cette fiche vous est partagé à titre gracieux, au meilleur de mes connaissances et sans aucune garantie.
Merci de partager !
Soumettre