How do I completely rename an Xcode project i e inclusive of folders

Question

I have a project named XXX  I want to rename this project to YYY   Note that XXX is an extremely common term  for e g   data   or simply  project    and thus a simple RegEx search-and-replace is not possible  out of risk of corrupting the project configuration files   My current project directory contains the following items    XXX XXXTests XXX xcodeproj   and I want to rename them to    YYY YYYTests YYY xcodeproj       respectively  with the necessary changes being reflected in my project file    How can I accomplish this without having to manually create and populate a new project     Edit  It is absolutely ridiculous that this has become my most upvoted question

User · Answer

A quicker solution using shell commands (works with CocoaPods too):

PLEASE cd TO A NON-GIT REPOSITORY BEFORE PROCEEDING ??

Step 1 - Prerequisites

Copy your original project folder to a temporary /NewProjectFolder OUTSIDE your git repository. ?? changes to .git could corrupt your git index ?

Step 2 - Open Terminal

Now we're going to rename the project from oldName to NewProject.

Close XCode.
Go to your /NewProjectFolder.

cd /Path/to/your/NewProjectFolder

Install the extra tools needed.

brew install rename ack

Rename the files and directories containing the source string. You’ll need to RUN THIS COMMAND TWICE, because directories will be renamed first, then files and directories inside those will be renamed on the next iteration.

find . -name 'oldName*' -print0 | xargs -0 rename --subst-all 'oldName' 'NewProject'

Check if all the files containing the source string are renamed. You should see empty output.

find . -name 'oldName*'

Replace all occurrences of the string in all files.

ack --literal --files-with-matches 'oldName' --print0 | xargs -0 sed -i '' 's/oldName/NewProject/g'

Check if all occurrences of the string in all files were replaced. You should see empty output.

ack --literal 'oldName'

Run pod install
Add NewProjectFolder to your repository.
You are done!

User · Answer

Step 1 - Rename the project  Click on the project you want to rename in the  quot Project navigator quot  in the left panel of the Xcode window  In the right panel  select the  quot File inspector quot   and the name of your project should be found under  quot Identity and Type quot   Change it to your new name  When the dialog asks whether to rename or not rename the project s content items  click  quot Rename quot   Say yes to any warning about uncommitted changes   Step 2 - Rename the scheme  At the top of the window  next to the  quot Stop quot  button  there is a scheme for your product under its old name  click on it  then choose  quot Manage Schemes    quot   Click on the old name in the scheme and it will become editable  change the name and click  quot Close quot    Step 3 - Rename the folder with your assets  Quit Xcode  Rename the master folder that contains all your project files  In the correctly-named master folder  beside your newly-named  xcodeproj file  there is probably a wrongly-named OLD folder containing your source files  Rename the OLD folder to your new name  if you use Git  you could run git mv oldname newname so that Git recognizes this is a move  rather than deleting adding new files   Re-open the project in Xcode  If you see a warning  quot The folder OLD does not exist quot   dismiss the warning  The source files in the renamed folder will be grayed out because the path has broken  In the  quot Project navigator quot  in the left-hand panel  click on the top-level folder representing the OLD folder you renamed  In the right-hand panel  under  quot Identity and Type quot   change the  quot Name quot  field from the OLD name to the new name  Just below that field is a  quot Location quot  menu  If the full path has not corrected itself  click on the nearby folder icon and choose the renamed folder   Step 4 - Rename the Build plist data  Click on the project in the  quot Project navigator quot  on the left  and in the main panel select  quot Build Settings quot   Search for  quot plist quot  in the settings  In the Packaging section  you will see Info plist and Product Bundle Identifier  If there is a name entered in Info plist  update it  Do the same for Product Bundle Identifier  unless it is utilizing the   PRODUCT NAME  variable  In that case  search for  quot product quot  in the settings and update Product Name  If Product Name is based on   TARGET NAME   click on the actual target item in the TARGETS list on the left of the settings pane and edit it  and all related settings will update immediately  Search the settings for  quot prefix quot  and ensure that Prefix Header s path is also updated to the new name  If you use SwiftUI  search for  quot Development Assets quot  and update the path   Step 5 - Repeat step 3 for tests  if you have them  Step 6 - Repeat step 3 for core data if its name matches project name  if you have it  Step 7 - Clean and rebuild your project  Command   Shift   K to clean Command   B to build

User · Answer

XCode 11 0     It s really simple now  Just go to Project Navigator left panel of the XCode window  Press Enter to make it active for rename  just like you change the folder name       Just change the new name here  and XCode will ask you for renaming other pieces of stuff         Tap on Rename here and you are done  If you are confused about your root folder name that why it s not changed  well it s just a folder  just renamed it with a new name

User · Answer

To add to  luke-west  s excellent answer   When using CocoaPods  After step 2    Quit XCode  In the master folder  rename OLD xcworkspace to NEW xcworkspace    After step 4    In XCode  choose and edit Podfile from the project navigator  You should see a target clause with the OLD name  Change it to NEW  Quit XCode  In the project folder  delete the OLD podspec file  rm -rf Pods  Run pod install  Open XCode  Click on your project name in the project navigator  In the main pane  switch to the Build Phases tab  Under Link Binary With Libraries  look for libPods-OLD a and delete it  If you have an objective-c Bridging header go to Build settings and change the location of the header from OLD OLD-Bridging-Header h to NEW NEW-Bridging-Header h Clean and run

User · Answer

To change the project name    Select your project in the Project navigator    2 In the Identity and Type section of the File inspector  enter a new name into the Name field   3 Press Return   A dialog is displayed  listing the items in your project that can be renamed  The dialog includes a preview of how the items will appear after the change    To selectively rename items  disable the checkboxes for any items you don   t want to rename  To rename only your app  leave the app selected and deselect all other items  Press  Rename

User · Answer

There is a GitHub project called Xcode Project Renamer      It should be executed from inside root of Xcode project directory and called with two string parameters   OLD PROJECT NAME  amp   NEW PROJECT NAME      Script goes through all the files and directories recursively    including Xcode project or workspace file and replaces all occurrences   of  OLD PROJECT NAME string with  NEW PROJECT NAME string  both in   each file s name and content     DON T FORGET TO BACKUP YOUR PROJECT   Xcode Project Renamer

User · Answer

Extra instructions when following  Luke-West s    Vaiden s solutions   If your scheme has not changed  still showing my mac  on the top left next to the stop button    Click NEWLY created Project name  next to stop button   gt  Click Edit Schemes  gt  Build  left hand side   gt  Remove the old target  will say it s missing  and replace with the NEWLY named project under NEWLY named project logo  Also  I did not have to use step 3 of  Vaiden s solution  Just running rm -rf Pods  in terminal got rid of all old pod files I also did not have to use step 9 in  Vaiden s solution  instead I just removed the OLD project named framework under Link Binary Libraries  the NEWLY named framework was already there  So the updated steps would be as follows  Step 1 - Rename the project  If you are using cocoapods in your project  close the workspace  and open the XCode project for these steps  Click on the project you want to rename in the  quot Project navigator quot  on the left of the Xcode view  On the right select the  quot File inspector quot  and the name of your project should be in there under  quot Identity and Type quot   change it to the new name  Click  quot Rename quot  in a dropdown menu  Step 2 - Rename the Scheme  In the top bar  near  quot Stop quot  button   there is a scheme for your OLD product  click on it  then go to  quot Manage schemes quot  Click on the OLD name in the scheme  and it will become editable  change the name Quit XCode  In the master folder  rename OLD xcworkspace to NEW xcworkspace   Step 3 - Rename the folder with your assets  Quit Xcode In the correctly named master folder  there is a newly named xcodeproj file with the the wrongly named OLD folder  Rename the OLD folder to your new name Reopen the project  you will see a warning   quot The folder OLD does not exist quot   dismiss the warning In the  quot Project navigator quot  on the left  click the top level OLD folder name In Utilities pane under  quot Identity and type quot  you will see the  quot Name quot  entry  change this from the OLD to the new name Just below there is a  quot Location quot  entry  Click on a folder with the OLD name and chose the newly renamed folder  Step 4 - Rename the Build plist data  Click on the project in the  quot Project navigator quot  on the left  in the main panel select  quot Build Settings quot  Search for  quot plist quot  in this section Under packaging  you will see Info plist  and Product bundle identifier Rename the top entry in Info plist Do the same for Product Identifier  Step 5 Handling Podfile  In XCode  choose and edit Podfile from the project navigator  You should see a target clause with the OLD name  Change it to NEW  Quit XCode  In terminal  cd into project directory  then  pod deintegrate Run pod install  Open XCode  Click on your project name in the project navigator  In the main pane  switch to the Build Phases tab  Under Link Binary With Libraries  look for the OLD framework and remove it  should say it is missing  The NEWLY named framework should already be there  if not use the  quot   quot  button at the bottom of the window to add it If you have an objective-c Bridging header go to Build settings and change the location of the header from OLD OLD-Bridging-Header h to NEW NEW-Bridging-Header h Clean and run   You should be able to build with no errors after you have followed all of the steps successfully

User · Answer

Aside from all the steps Luke and Vaiden recommended  I also had to rename all the customModule properties in my Storyboard to match the new name  and this has to be case sensitive

User · Answer

Adding to the accepted answer by Luke West  If you have any entitlements   Close Xcode Change the entitlements filename Go into Xcode  select the entitlements file should be highlighted red  in the File inspector select the Folder icon and select your renamed file  Go into Build Settings  and search  quot entitlements quot  and update the folder name and file name for the entitlement  Clean and rebuild

[xcode] How do I completely rename an Xcode project (i.e. inclusive of folders)?

A quicker solution using shell commands (works with CocoaPods too):

Step 1 - Prerequisites

Step 2 - Open Terminal

Examples related to xcode

Examples related to ide

Examples related to rename

Examples related to batch-rename