AppCode 2020.1 Help

Create and edit run/debug configurations

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

Run Menu

Scroll to the bottom of the list to find them:

Run/debug configurations

AppCode provides the Run/Debug Configuration dialog as a tool for handling run/debug configurations: creating configuration profiles or changing the default ones.

Create a run/debug configuration

  1. Open the Run/Debug Configuration dialog in one of the following ways:

    • Select Run | Edit Configurations from the main menu.

    • With the Navigation bar visible (View | Appearance | Navigation Bar), choose Edit Configurations from the run/debug configuration selector.

    • Press ⌃⌥R, then press 0 or select the configuration from the popup and press ⌘↓.

  2. In the Run/Debug Configurations dialog, click the Add New Configuration icon on the toolbar or press ⌘N. The list shows the default run/debug configurations. Select the desired configuration type.

    Add a new run/debug configuration

    The fields that appear in the right-hand pane display the default settings for the selected configuration type.

  3. Fill in the following fields on the Configuration tab:
    • Name: type the configuration name.

    • Target: select the desired target from the list.

    • Configuration: select the configuration type — Debug or Release.

    • Executable: select the proper executable for your configuration.

    If necessary, add program arguments and environment variables.

    Specify additional parameters depending on the configuration type. Refer to the Run/debug configurations dialog section for more information on available options.

  4. In the Before launch section, define whether you want to launch any external tool or another run/debug configuration before run. To skip the build stage, remove Build from Before launch list.

    When adding run/debug configurations to the Before launch list, you can choose devices or simulators on which they will be run:

    1. Click the Add New Configuration icon and select Run Another Configuration.

    2. Choose configuration and a device or simulator for it from the list that opens.

      Select device or simulator for configuration

  5. Apply the changes and close the dialog.

Edit an existing run/debug configuration

  1. Do one of the following:
    • From the main menu, choose Run | Edit Configurations.

    • With the Navigation Bar visible (View | Appearance | Navigation Bar), choose Edit Configurations from the run/debug configurations selector.

    • Press ⌃⌥R, then press 0 to display the Edit Configuration dialog, or select the configuration from the popup and press ⌘↓.

  2. In the corresponding run/debug configuration dialog, change parameters as required.

If a project has been created in an earlier version of AppCode, its run/debug configurations can be lost, when such a project is added to another project, already opened in the same window.

To avoid the loss of run/debug configurations, it is recommended that you open such a project once in the latest version, and only after being added to another project.

Enable the Services tool window

You can manage multiple run/debug configurations in the Services tool window. For example, you can start, pause, and stop several applications, track their status, and examine application-specific details.

  1. From the main menu, select Run | Edit Configurations or use the selector on the toolbar.

  2. In the Run/Debug Configurations dialog, select Templates from the list on the left.

  3. In the right-hand pane, expand the Configurations available in Services section.

  4. Click the Add button in the Configurations available in Services section and select the necessary run configuration type.

    You can add or remove multiple configuration types one by one.

    Enabling the Services tool window

    Note that the tool window will only display the configuration types for which you have created one or more configurations.

    Thus, if you add a configuration type for which no configurations exist in the project, this type will not be displayed in the tool window until you create a configuration of this type.

  5. Apply the changes and close the dialog.

    The selected configurations will be available on the Services tool window. To open this tool window, select View | Tool Windows | Services from the main menu.

    Run/Debug configurations in the Services tool window
Last modified: 20 May 2020