Sheehan Alam
Sheehan Alam

Reputation: 60869

Rename or refactor files in Xcode

Is it possible to rename/refactor a class file and have it rename the actual file on disk? If so, how can I do this?

Upvotes: 94

Views: 89436

Answers (7)

user3696153
user3696153

Reputation: 752

Xcode 11.6, attempting to rename "foo.cpp" to "bar.cpp" does not work using the above methods. the REFACTOR option is greyed out. Instead, do the following:

  • In the Project Browser, find the file to rename, ie: foo.cpp
  • Right (2finger) click on foo.cpp
  • Select, "Show in File Inspector"

Right side of screen, the file inspector appears.

  • In the Name field, type your new filename, press ENTER

Upvotes: 1

KareemJ
KareemJ

Reputation: 804

One Way: Select the file you want to rename and then press Tab. I mostly use this, however, Xcode sometimes fails to rename it. So what I'd then is

Another Way: Select the file. Open the Inspectors Area (on the top-right corner). And then open up File Inspector. There you'll find the name field, where you can edit file's name. (See screenshot).

enter image description here

Upvotes: 10

Carlos  Chang
Carlos Chang

Reputation: 9

Choose Refactor->Rename nevan king's answer is also works fine on Xcode Version 7.0 beta (7A120f)

Upvotes: 0

nevan king
nevan king

Reputation: 113747

The safest way to rename files is to refactor the class name using Xcode's "Refactor" command. Using that command makes sure that your code is also updated anywhere that references the file or the class (including NIBs).

Right-click on the class name in the interface (.h) file, choose Refactor->Rename, and Xcode will guide you through the process, allowing you to preview changes before you commit to them.

More details:

Right click on the class name (after @interface) and choose Refactor->Rename. For example, right click on ViewController in this code:

@interface ViewController : UIViewController

enter image description here

Enter the new name for the class:

enter image description here

Xcode will let you review the changes before you commit.

enter image description here

You can also highlight the class name and use Xcode's Edit->Refactor menu, or even map it to a keyboard shortcut if you want.

If you actually want to rename the file without affecting any code, click on the name in the Navigator pane (left pane), wait a second, then click again. The name will be highlighted and you can type in a new one. You can also delete from the Navigator, rename the file in the Finder and re-add it to your project.

Upvotes: 185

jclv
jclv

Reputation: 161

If you renamed a file manually, and used Find and Replace to rename the class name, make sure the file is added to Compile Sources in Build Phases of your target, as it will probably be removed.

Upvotes: 0

Dave
Dave

Reputation: 811

Works for Xcode 4.2.1: select file in project navigator (default left panel) and press [tab]

Upvotes: 81

bbum
bbum

Reputation: 162712

By default, Xcode will rename a file when you rename it in either the file navigator (left hand outline view thingy) or when you use the inspector.

Upvotes: 4

Related Questions