AppCode
 
2022.2
Shortcuts: macOS
Get AppCode
You are viewing the documentation for an earlier version of AppCode.
  1. Run and debug your app
  2. Run your app

Run applications

Last modified: 28 July 2022

AppCode allows you to run your iOS and tvOS applications on simulated devices as well as on real ones. Applications for macOS run on your current Mac where AppCode is installed.

Select a run/debug configuration

In AppCode, you run applications using run/debug configurations which are the analogues of the Xcode schemes and are synchronized with them.

Every project created in AppCode contains a default run/debug configuration that has the same name as your application. You can also create new run/debug configurations for different targets.

You can access all available run/debug configurations from the corresponding selector on the toolbar:

Run/debug configuration selector on the toolbar

Scroll to the bottom to find them:

Run/debug configuration selector

Select a device

You can see the list of all available simulated and real devices in the run/debug configuration selector:

Select a device

AppCode displays a set of devices relevant to the selected run/debug configuration. So, if you selected a run/debug configuration for the tvOS target, you'll see just Apple TV devices in the list. If you selected a run/debug configuration for the macOS target, only your Mac will be available and preselected:

Running a macOS application

The list of available devices also depends on the lowest operating system version specified in the Xcode project settings. For example, if you have iOS 12.0 selected in Xcode, you'll have a list of devices only for iOS 12.0 and later.

Run your application

tip

By default, AppCode builds your project every time you run it. To exclude the building stage from the running process, delete it from the Before Launch section in the Edit Run/Debug Configuration dialog.

To build a project without running it, click the Build button or press ⌃ ⇧ F9.

While the project is being compiled, the compilation output appears in the Messages tool window:

Messages tool window

Once the compilation has successfully finished, the Run tool window opens, and the application launches on the selected device:

iPhone 11 Simulator

Rerun an application

  • Click the Rerun button on the toolbar.

  • Press ⌃ F5.

  • In the Run tool window, go to your application's tab and click the Rerun button.

Stop an application

  • Click the Stop button on the toolbar.

  • Press ⌃ F2.

  • In the Run tool window, go to your application's tab and click the Stop button.

Run an application extension

  1. Select an Application Extension configuration from the run/debug configuration selector on the toolbar.

  2. Click the Run button on the toolbar or press ⇧ F10.

  3. In the popup that opens, select a host application of your extension:

    Choose Host Application

Review the application output

You can review any output from your running applications in the console of the Run tool window. The output from each application is displayed in its own tab named after the corresponding run/debug configuration.

If you rerun an application, the new output overwrites the contents of the tab. To preserve the output of an application, even if you rerun it, pin the output tab.

Pause and resume the application output

  • To pause the application output, right-click inside the Run tool window and select the Pause Output checkbox in the context menu.

    note

    Only the output will be suspended. The program execution will continue.

  • To resume the application output, deselect the Pause Output checkbox in the context menu.

Show running processes

You can view the list of all active run or debug sessions and navigate between them.

See also

Reference

Concepts