Generally, AppCode runs and debugs tests in the same way as other applications, by running the run/debug configurations you have created. When doing so, it passes the specified test classes or methods to the test runner.
In many cases, you can initiate a testing session from a context menu. For this purpose, the Run and Debug commands are provided in certain context menus. For example, these commands are available for files containing tests in the Project Tool Window. They are also available for a test class or method you are currently working on in the editor.
If you run a test for which there is no permanent run/debug configuration a temporary configuration is created. You can then save such a configuration using the Run/debug configuration dialog, if you want to reuse it later.
The tests run in the background, so you can execute several tests at the same time.
To run or debug a test, follow these general steps:
To start running or debugging a test, you can use the main toolbar, or a context menu in the Project tool window or in the editor:
- Using the main toolbar:
- Select the necessary run/debug configuration from the list on the main toolbar.
- Click Run or Debug to the right of the list. (Alternatively, choose Run | Run (⌃R) or Run | Debug (⌃D) from the main menu.)
- Using a context menu:
Right-click a test file in the Project tool window, or open it in the editor, and right-click the background. On the context menu, choose Run... or Debug....
- To run/debug a unit test, you can also use the gutter icons. Click icon to run a single test, or icon to run all tests from the suit (fixture, in case of Google Test): Note: following the first run of a test, the gutter icons indicate the test state: success ( icon) or failed ( icon), as in below example: