IntelliJ IDEA 11.1 Web Help

11.0+
Some features described here are available in Ultimate edition only.

Use this dialog box to configure running and debugging of Android applications and activities on actual and virtual devices.

Click here for the description of the common options.

The dialog box consists of three tabs:

General tab

Item Description
Name In this text box, specify the name of the current run/debug configuration.
Module From this drop-down list, select the module to apply the configuration to.
Do not launch activity Select this option to run the application on a virtual or physical device without launching any activities.
Launch default activity Select this option to have the activity marked as start-up launched on application start.
Launch Select this option to specify the activity to be launched upon the application start. Type the activity name manually or click the Browse button browseButton and select the desired activity in the Select Activity Class dialog box, that opens.

The list of available activities is determined by the choice of the module.
Deploy application
  • When this check box is selected, the current application is deployed on the selected target device and launched according to the launch settings.
  • When this check box is cleared, the previously deployed application is launched. If no application is deployed on the device, an error is reported.
Target Device In this area, choose the type of device to run/debug the application on. The available options are:
  • Show chooser dialog: choose this option have IntelliJ IDEA display the Choose Device dialog box when the application is already started.
  • USB device: choose this option to have IntelliJ IDEA detect a plugged in USB device upon the application start.
  • Emulator: choose this option to use one of the configured emulators and choose the relevant configuration in the Prefer Android Virtual Device drop-down list.

Note

Selecting the Show chooser dialog or USB device option may be helpful if you are going to run the application on a physical device which will be plugged in later and therefore the set of available devices cannot be foreseen.

Prefer Android Virtual Device From this drop-down box, select the virtual device configuration to run or debug the specified activity.

The drop-down list is available only if the Emulator check box is cleared.

Browse browseButton Click this button to open the Select Android Virtual Device dialog box, where you can appoint a device to launch upon the future session start-up with the configuration being specified

Emulator tab

In this tab, specify additional configuration settings for launching the Android emulator.

Item Description
Network Speed From this drop-down list, select the network transfer rate to be simulated.
Network Latency Use this drop-down list to specify the time delay between the initial input and the output.
Wipe user data Select this check box to have the contents of the user-data image copied to the new user-data disk image while resetting the image. By default, the <system>/userdata.img is copied.
Disable boot animation Select this check box if you do not want an animated boot screen displayed upon the emulator start-up.
Additional command line options In this text box, type the additional options to be passed to the emulator via the command line. For lengthy command lines, click the editorIcon button and type the text in the Additional Command Line Options dialog box, that opens.

Logcat tab

Item Description
Clear log before launch Select this check box to have the data from previous sessions removed from the log file before starting the application.

Toolbar

Item Keyboard shortcut Description
add InsertInsert Click this button to add new configuration to the list.
delete DeleteDelete Click this button to remove the selected configuration from the list.
copy Ctrl+DCommand D Click this button to create a copy of the selected configuration.
settings Edit Defaults Click this button to edit the default configuration templates. The defaults are used for the newly created configurations.
arrowUp arrowDown UpUp
DownDown 		Use these buttons to move the selected configuration up and down in the list. The order of configurations in the list defines the order, in which configurations appear in the Run/Debug drop-down list on the main toolbar.

Common options

Item Description
Name In this text box, specify the name of the current run/debug configuration.
Defaults This node in the left-hand pane of the dialog box contains the default run/debug configuration settings. Select the desired configuration to change its default settings in the right-hand pane. The defaults are applied to all newly created run/debug configurations.
Temporary configurations limit Specify here the maximum number of temporary configurations to be stored and shown in the Select Run/Debug Configuration drop-down list.
Before Launch In this area, specify the activities to be performed before starting the current configuration. The available options are:
  • Make - if this check box is selected, the project is compiled automatically, prior to running or debugging. This option helps you ensure that all changes are included and compiled. If there are no changes, the program will just run.
  • Build Artifacts - if this check box is selected, the specified artifacts will be built prior to running or debugging. To define the artifacts to be built, click the Browse button browseButton and select the desired artifact from the list of artifacts configured for the current module. To learn more about configuring artifacts, refer to Artifacts section.
  • Run Ant target - if this check box is selected, the specified Ant target will be built prior to running or debugging. To define an Ant target, click Browse button browseButton and select the desired target from the list of existing targets. To learn more about Ant support, refer to Ant Support section.
  • Run Maven goal - if this check box is selected, the specified Maven goal will be executed prior to running or debugging. To define a Maven goal to be executed, click Browse button browseButton and select the desired goal from the list. To learn more about Maven support, refer to Maven Support section.
  • Run Phing target - if this check box is selected, the specified Phing target will be executed prior to running or debugging. To appoint a Phing target, click the Browse button browseButton and select the desired target in the Choose Phing Target to Execute dialog box, that opens.
  • Show Settings - select this check box to have the Run/Debug Configurations dialog box shown every time you launch this run/debug configuration. If this check box is cleared, the run/debug configuration starts silently.
Share configuration If this check box is selected, the run/debug configurations become available to the other team members.

In case of the standard project format, the run/debug configurations will be stored in the .ipr file, which is usually shared through the version control, rather than .iws.

In case of the directory-based project format, the shared run/debug configurations are kept in separate xml files under .idea\runConfigurations folder, while the local run/debug configurations are kept in the .idea\workspace.xml.

See Also

Concepts:

Procedures:

Reference:

Web Resources: