Documentation Archive


Xcode Overview

Navigating Your Workspace

Access files, symbols, unit tests, diagnostics, and other facets of your project from the navigator area. In the navigator bar, you choose the navigator suited to your task. The content area of each navigator gives you access to relevant portions of your project, and each navigator’s filter bar allows you to restrict the content that is displayed.

image: ../art/XC_O_Navigator_area_2x.png

Choose from these options in the navigator bar:

  • image: ../art/XC_O_navigator_project_button_2x.pngProject navigator. Add, delete, group, and otherwise manage files in your project, or choose a file to view or edit its contents in the editor area.

  • image: ../art/XC_O_navigator_symbol_button_2x.pngSymbol navigator. Browse the symbols in your project as a list or hierarchy. Buttons on the left of the filter bar let you limit the shown symbols to a combination of only classes and protocols, only symbols in your project, or only containers.

  • image: ../art/XC_O_navigator_find_button_2x.pngFind navigator. Use search options and filters to quickly find any string within your project.

  • image: ../art/XC_O_navigator_issue_button_2x.pngIssue navigator. View issues such as diagnostics, warnings, and errors found when opening, analyzing, and building your project.

  • image: ../art/XC_O_navigator_test_button_2x.pngTest navigator. Create, manage, run, and review unit tests.

  • image: ../art/XC_O_navigator_debug_button_2x.pngDebug navigator. Examine the running threads and associated stack information at a specified point or time during program execution.

  • image: ../art/XC_O_navigator_breakpoint_button_2x.pngBreakpoint navigator. Fine-tune breakpoints by specifying characteristics such as triggering conditions.

  • image: ../art/XC_O_navigator_report_button_2x.pngReport navigator. View the history of your build, run, debug, continuous integration, and source control tasks.

Typing text in the filter bar text input field shows only the items in the content area containing the search term. Most navigators show buttons on the left side of the filter bar used to further restrict what content is shown. Some filter bars have an Add button (+) on the left that you use to add an element to the content area. The button on the left of the filter bar in the report navigator (image: ../art/XC_O_filter_bot_button_2x.png) is used for interacting with bots. Using bots from the report navigator is covered in more detail in Manage and Monitor Bots from the Report Navigator.

Select files in the content area to view or edit them.