Xcode 5 Quick Guide

Xcode’s workspace window is split into 5 main areas: the toolbar, the navigation area, the editing area, the debug area and the utility area:

xcode 5 set up defined

Navigating in Xcode

The navigation area has a toolbar as well. It has 8 tabs: project navigator, symbol navigator, find navigator, issue navigator, test navigator, debug navigator, breakpoint navigator and log navigator. You can quickly select one of them by pressing ⌘ and the index corresponding to it.

- ⌘1 Project Navigator
- ⌘2 Symbol Navigator
- ⌘3 Find Navigator
- ⌘4 Issue Navigator
- ⌘5 Test Navigator
- ⌘6 Debug Navigator
- ⌘7 Breakpoint Navigator
- ⌘8 Log Navigator

xcode 5 navigation toolbar

And if you need the extra space and want to get rid of the navigator then use ⌘0 (command zero).

At the bottom of the navigation area there are the navigation filters. These are different for each tab and are very helpful. In the project navigator tab, the filters allow you to see the recently modified or recently edited files. Recently modified lets you focus on your SCM changes.

xcode 5 Project Navigator

You can also enter some text and try to filter the name of the files if you know what you’re looking for. However, better than using that filter is to use open quickly. The keyboard shortcut for that is:
⇧⌘ o Open quickly

xcode 5 viewcontroller open quickly

This is very handy and very smart. Even if you don’t remember the full name of the class or method you’re searching for it can still help you find it.

Smart Open Quickly

You didn’t even have to specify the full words (why write view controller when you can write just a few letters) and it still found what I was looking for.

And if you want to open the file and go to line 246 because you know that’s where that method is then you can just add :246 in the open quickly window and Xcode will do that for you. And if you want to skip to another line then just press

⌘ L Go to line

and enter the line number.

xcode 5 Go To Line

Show line numbers

If you wish to show line numbers in Xcode 5 simply hold down the cmdand buttons together and a window will pop up. In this window click Text Editing along the top options and then make sure the checkbox for Show: Line Numbers is selected.

xcode 5 show line numbers

Another very useful keyboard shortcut is the one that allows you to switch between the .h and .m file for a class.

⌃⌘⇡ Jump to Next counterpart

And a very similar keyboard shortcut if you want to go back to the previous file you were looking at. Or forward again:

⌃⌘⇢ Go forward

⌃⌘⇠ Go back

Editing

When you’re editing the code you might decide that an instance variable’s name is not as suggestive as it should be or that there is a spelling mistake in it. You want to rename all instances of that variable, but only in a certain scope. Select one of the instances and then hit:

⌃⌘E Edit all in scope

You’ll see that all the occurrences of that variable have boxes around it. Editing one will update all the others. This is very helpful for code refactoring and cleaning. Also very useful during refactoring is moving lines around. To do this you press:

⌥⌘[ Move line up

⌥⌘] Move line down

The indentation will be fixed as you move lines up or down, but if you still have some code that’s not properly indented then use this shortcut:

⌃I Re-indent code

If you want to Auto-Indent a block of code, check out this article: Auto-Indent Lines of code in Xcode.

If you need to comment things out just press:

⌘/ Comment/uncomment line or selection

Apart from the standard editor Xcode also has an assistant editor and a version editor. To switch from one to another you use the following:

⌘↩ Standard editor

⌥⌘↩ Assistant editor

⌥⇧⌘↩ Version editor

The assistant editor is excellent for auxiliary content. It tracks the contents of the main editor. If you need to see the superclass for your class at the same time as you’re editing the class just switch on the assistant editor. You can see counterparts, callers or test callers, includes and lots more. It is very powerful and I encourage you to use it. If you want to open a file in the assistant editor just hold the option key (⌥) down:

⌥⌘, Open in assistant editor

Debugging

Normally we set or remove breakpoints by clicking the margins of the document. You can also do this via keyboard shortcuts:

⌘\ Add/remove breakpoint at current line

In the breakpoint navigator you can see all the existing breakpoints. To get to the navigator you press ⌘7

⌘Y Activate or deactivate breakpoints

Very useful while debugging is the exception breakpoint. If your app is crashing just add an exception breakpoint and the program will stop at the line that’s causing the problem. You can do this by pressing the + at the bottom of the breakpoints navigator or from Xcode’s main menu by going to Debug-> Breakpoints -> Create exception breakpoint.

xcode 5 Exception Breakpoint

Testing

To run all the tests in your project use ⌘U . Or ⌃⌘U to test without building.

The test editor is your best friend when running your tests. You get to it by pressing ⌘5 From here you can run only one test by pressing the little play button that appears next to it, a whole test suite or all your tests.

xcode 5 Tests

You can also filter results so you can see only the failing tests:

xcode 5 Failing Tests Filter

If you want to debug the test then you can add a test failure breakpoint from the breakpoint navigator the same way you would add an exception breakpoint.

Source control

⌥⌘C Commit code

⌥⌘X Update

⌃⌥⌘X Update all

You can use the version navigator to check what’s changed in a file and who’s to blame.

⌥⇧⌘↩ Show version editor

Interface Builder

⌘= Size to fit content

⌘_ Add horizontal guide

⌘| Add vertical guide

iPhone Simulator

⌘⇠ Rotate left

⌘⇢ Rotate right

⌃⌘Z Shake gesture

⇧⌘H Home

⇧⌘M Simulate memory warning

⌘T Toggle slow animations