How to Rename an Xcode Project Without Losing Your Mind

Image for post
Image for post
Xcode 11 Demo at WWDC19

I was recently working on an iOS app when I found myself in need of renaming my project. This can be useful if you ever need to make a copy of one of your projects to serve as a basis for further development or want to completely overhaul your app’s branding. Unfortunately, the process of refactoring can get a bit complicated in Xcode 11, especially if you are using Cocoapods, additional libraries, or have several subfolders and schemas. In this short tutorial, I will explain how to comprehensively rename your Xcode project without breaking anything in 7 straightforward steps.

Step 1 — Renaming the project

  1. If you are using in your project, close the workspace, and open the XCode project to complete the following steps.
  2. Select the project you want to rename in the “Project Navigator” which can be found on the left side of the Xcode view.
  3. On the right-hand side of the window, select the “File Inspector”. The name of your project should be in there under “Identity and Type”, change it to “NEW” and press Enter.
Image for post
Image for post
File inspector example
  1. A dialog will display, listing the items in your project that can be renamed. Confirm everything looks right and click “Rename”
Image for post
Image for post
Example rename dialogue in Xcode (Source: digitalleaves.com)

Step 2- Renaming the schema

  1. In the top bar (near “Stop” button), there is a scheme with your “OLD” name, click on it, then go to “Manage Schemes”. Alternatively, you can find “Manage Schemes” here: Product > Scheme > Manage Schemes
Image for post
Image for post
Manage Schemes
  1. Click on the “OLD” name in the scheme, and it will become editable, change the name to “NEW”.
  2. Quit Xcode.

Step 4 — Renaming the folder with your assets

  1. Open your project folder and rename OLD.xcworkspace to NEW.xcworkspace.
  2. In the correct named master folder, there will be a newly named .xcodeproj file with the wrong named “OLD” folder. Rename the “OLD” folder with “NEW”.

Step 5 — Renaming in the Podfile

  1. In the terminal, cd into project directory & open Podfile. You should see a target clause with the “OLD” name. Change it to “NEW” and SAVE.
  2. Run the command pod deintegrate so Cocoapods will delete all pod related configs, scripts, generated framework as well as the Pods/ directory.
  3. Now execute pod install to recreate all Cocoapods resources.

Step 6 — Renaming the Build .plist Data

  1. Reopen your Xcode project. You will see the following warning: “The folder OLD does not exist”, dismiss the warning and continue with the following steps.
  2. In the “Project Navigator” on the left, you will see the “OLD” folder name. Click on the folder icon in “File Inspector”, open Finder and navigate to the “NEW” internal folder from the “NEW” project folder.
  3. Go to “Project Navigator” -> [Your project name] -> Build Settings -> Packaging -> Info.plist, and change the path’s substring from “OLD” to “NEW”.
Image for post
Image for post
Change the Info.plist
  1. Do the same for the “Product Identifier”.

Step 7 — Clean and Build the Project

  1. Command + Shift + K to clean
  2. Command + B to build

…and voila! Your project should build and run perfectly with its new name.

Thanks for reading!

Also be sure to check out my , , , and .

writing about life, culture, and technology.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store