IntelliJ IDEA 14.0.0 Web Help

Android Tool Window

11.0+
View | Tool Windows | Android

In this tool window, you can view and analyze the system debug output when debugging Android applications. The tool window consists of the following areas:

Devices | Logcat Tab

The tab consists of three areas:

Devices

In this pane, select a virtual emulator or a physical device where the application you want to debug will be executed from the drop-down list that shows all running devices. After that, a list of all processes on the selected device is shown in this area.

Logcat

The pane shows a log of all processes that are currently running on the device selected in the Devices pane. If you only want messages related to a specific process to be displayed, select this process in the Devices pane and click the Only Show Logcat From Selected Process button android_logcat_show_only_selected_process_messages.

Toolbar

Use the toolbar buttons to configure the scope and presentation of log data and to navigate through the log.

Item Tooltip and shortcut Description
android_logcat_show_only_selected_process_messages Only Show Logcat From Selected Process
  • Click this toggle button if you only want the Logcat pane to display messages related to a specific process selected in the Devices pane.
  • Release this toggle button if you want the Logcat pane to display a log of all processes running on the selected device.
Log Level N/A In this drop-down list, select the priority of log messages to be displayed. The available options are:
  • Verbose
  • Debug
  • Info
  • Warn
  • Error
  • Assert
find1.gif Find Use this text box to search through the list of messages. As you type a search string, the messages that match the search pattern are displayed with the matching character strings highlighted. To finalize the search, press Enter. Search patterns are stored in the search history list. To clear the search history, click the clear button.
Filters N/A From this list, select an existing filter configuration, or create a new one.

A filter configuration is a set of filtering parameters. Applying filter configurations provides more flexible control over the type and amount of log data displayed than just specifying the information type by choosing a message priority in the Log level drop-down list.

  • To have complete log data displayed, select No Filters from the drop-down list.
  • To apply a filter, select it from the Filter drop-down list.
  • To create a new filter configuration, select Edit Filter Configuration. In the Create New Logcat Filter dialog box that opens, click the Add toolbar button add.png and specify the following filtering parameters:
    • Log Tag: use this parameter if you only want messages from a certain component to be displayed. Type the regular expression to specify the tag that indicates the relevant system component, such as activity, etc. For more details, see Filtering Log Output.
    • Log Message: use this parameter if you only want messages that contain certain elements or character strings to be displayed. Type the regular expression the defines specify the character string to detect.
    • Package Name:use this parameter if you only want messages that refer to a specific Java package (class path) to be displayed.
    • PID: use this parameter if you only want messages that refer to a specific process (process ID) to be displayed.
    • Log Level: use this parameter if you only want messages with a certain priority level to be displayed.

    To update a filter, select it from the list and edit the filter values.

  • To remove a filter configuration from the list, choose Edit Filter Configuration. In the Create New Logcat Filter dialog box that opens, select the filter and click the Delete toolbar button delete.png.
clear_all Clear logcat Click this button to remove log data from previous sessions on the selected device.
icon_end_of_output.png Scroll to the end Click this button to move the caret to the last line of the console output.
arrowUp Up the Stack Trace
Ctrl+Alt+Up
Click this button to navigate up in the stack trace and have the cursor jump to the corresponding location in the source code.
arrowDown Down the Stack Trace
Ctrl+Alt+Down
Click this button to navigate down in the stack trace and have the cursor jump to the corresponding location in the source code.
icon_softWrap Use Soft Wraps Click this button to toggle the soft wrap mode of the output.
print Print Click this button to print the logs.
rerunConsole.png Restart Click this button to restart logging.

ADB logs

This tab shows the Android Debugging Bridge log messages.

Toolbar

The toolbar is common for the Devices | Logcat and ADB tabs.

Item Tooltip and shortcut Description
android_logcat_screen_capture Screen Capture Click this button to capture a screenshot of the application output on an emulator or a physical device.
android_logcat_screen_record Screen Record Click this button to start video recording of the application output on an emulator or a physical device.
android_logcat_system_information System Information Click this button to view the information on the selected process provided by the Dumpsys tool. The logs are presented as text files and are shown in separate editor tabs. Choose the information type to view from the pop-up menu that opens:
  • Activity Manager State
  • Package Information
  • Memory Usage
  • Memory use over time
  • Graphics State
closeRedCircle Terminate Application Click this button to cancel application execution.
android_logcat_initiate_GC Initiate GC Click this button to start garbage collection, whereupon you can examine the amount of heap memory the selected process uses (see Viewing heap usage). The button is available only when a process is selected in the Devices pane.
dumpJavaHeap Dump Java Heap Click this button to dump the contents of the Java heap memory to a file.
android_logcat_start_method_tracing Start Method Tracing Click this button to invoke profiling of a method, see Starting method profiling. This button is available only when a process is selected in the Devices pane.

See Also

Procedures:

Reference:

Getting Started:

Web Resources:

Last modified: 12 November 2014
comments powered by Disqus