Installation and Setup
Rename XCode Project
1. Rename the Project
Open your project in Xcode.
In the Project Navigator on the left side, click once on your project name to make it editable.
Enter your new project name and press
Enter
.This will rename the project itself and will also update the build target's name.
2. Rename the Scheme
- In the top bar (near the Run and Stop buttons), click on the active scheme (the dropdown list that shows your project name and the device it's running on).
- From the dropdown, select
Manage Schemes...
. - Click on the scheme that bears your project's name, wait a moment, and it will become editable.
- Rename it and then close the dialog.
3. Rename the Folder
This step is optional, but for completeness, you might want your main project folder to have the same name as your project:
- Close Xcode.
- In Finder, navigate to your project folder and rename it to the new name.
- Open the project in Xcode by clicking on the
.xcodeproj
file.
4. Update the Bundle Identifier (if needed)
If you're changing the project name because you want a different bundle identifier, you should change that too:
- In Xcode, click on the project in the Project Navigator.
- In the main view, select the target.
- Go to the
General
tab. - Modify the
Bundle Identifier
as needed.
5. Search for any lingering old names
It's a good practice to ensure that the old name doesn't exist anywhere in the project:
- Use the search functionality in Xcode (the search bar at the bottom of the Project Navigator).
- Enter the old project name and see if it comes up anywhere, especially in code comments or documentation.
6. Test your project
After renaming:
- Clean the build folder (Shift + Cmd + K).
- Build and run your project (Cmd + R) to ensure that everything works as expected.