Documentation Archive


Xcode Overview

Using Unit Tests

Xcode supports three main types of testing. Functional tests focus on code functionality. Performance tests focus on measuring execution time. User Interface tests focus on flows through the user interface. Functional and performances tests are functions that you write. Each function sets up an environment for the test, executes the targeted parts of the app, and tears down the test environment. User interface tests are recordings you make as you use your app.

The most common type of functional testing is unit testing. A unit of code is the smallest testable component of your project—for example, a method in a class or a set of methods that accomplish an essential purpose. Unit tests are often used to detect regressions introduced by code changes to a project. Some developers write unit tests first and then implement methods that pass the tests.

Performance tests measure the time it takes your app to complete a task on different types of devices. Xcode tracks times for different configurations and you choose baselines from measured values.

A test case exercises a unit of code in a specific way or measures a specific part of your app’s performance; if the result of the test is different from the expected result, the test case fails. A test suite is made up of a set of test cases.

When you create a project or a target, Xcode includes a unit test target in the scheme that builds the app. The implementation file for the target includes stubs for the setUp, tearDown, and testExample methods. Complete these stub implementations and add other code as necessary to perform unit tests on your app.

Run all tests by choosing Product > Test. Click the Test Navigator icon to view the status and results of the tests. You can add a test target to a project (or add a class to a test) by clicking the Add button (+) in the bottom-left corner of the test navigator. To view the source code for a particular test, select it from the test list. The file opens in the source code editor.

image: ../art/XC_O_about_test_navigator_2x.png

To run a test suite, click the arrow to the right of the name. To run a subset of test methods, select them in the test navigator and choose Product > Perform Action > Run Test Methods. To run an individual test method, click the arrow to the right of the method name. Choose Product > Test to run all tests in the active scheme.

When a test succeeds, a green diamond with a checkmark denoting success appears to the right of the test name. When a test fails, a red diamond with an X denoting failure appears to the right of the test name and the issue is displayed in the issue navigator. To see the issue, click the Issue Navigator button (image: ../art/XG_NavArea_Issue_icon.pdf) in the navigator bar.

To view only the failed tests, click the Failed Test button (image: ../art/FailedTestIcon.pdf) at the bottom of the test navigator. Select a failed method to examine it in the source code editor. After addressing the reason for the failure, click the failed test indicator (a red diamond with an X) to rerun the test.

Show related test methods in an assistant editor by choosing either the Test Classes or Test Callers category from the Assistant pop-up menu.

For more detail on writing, running, and viewing tests, see Testing with Xcode.