Documentation Archive


Xcode Overview

Workspace Window Overview

Perform your core development tasks in the Xcode workspace window, your primary interface for creating and managing projects. A project is the main unit of development in Xcode. It includes all the elements needed to build your app, framework, plug-in, or other software product. It also maintains the relationships between those elements. For more details on projects, see Working with Projects.

The workspace window automatically adapts itself to the task at hand, and you can further configure the window to fit your work style. You can open as many workspace windows as you need.

The components of the workspace window are shown in the following figure.

image: ../art/XC_O_WrkspaceWindow_2x.png

The workspace window always includes the editor area. When you select a file in your project, its contents appear in the editor area, where Xcode opens the file in an appropriate editor. For example, in the figure above, the editor area contains AdventureScene.swift, a swift code file that is selected in the navigator area on the left of the workspace window.

The workspace window displays up to three optional areas used in performing different tasks in the development life cycle. Hiding areas not in use can help you focus on your current task. You can hide or show these optional areas by using the workspace configuration buttons on the far right side of the toolbar:

  • image: ../art/XC_O_area_button_navigator_2x.png  Show and hide the navigator area. Use this area for navigating all facets of your project, including files, symbols, breakpoints, build issues, tests, breakpoints, and build reports. You can also search for any string in your project.

  • image: ../art/XC_O_area_button_debug_2x.png  Show and hide the debug area. Use this area for viewing variables, interacting with the debugger console, and controlling the execution of your app.

  • image: ../art/XC_O_area_button_utilities_2x.png  Show and hide the utilities area. Use this area to inspect or modify attributes of files, graphical user interface elements, sprites, and other elements in your project. Also use it to access a library of ready-made resources. See Accessing Resources and Inspecting Elements.