Android Tool Window
In this tool window, you can view and analyze the system debug output when running or debugging Android applications.
The tool window consists of a toolbar and the following nested tabs:
Select a physical or a virtual device from the devices drop-down list, and a process running on the selected device from the processes drop-down list. The information in each tab is filtered in accordance with your selection.
The toolbar that is common for all nested tabs, provides quick access to the following actions:
|Screen Capture||Click this button to make a screenshot of the virtual or the connected physical device where the application is running. You can rotate the screenshot and add some visual effects in the dialog that opens, and save the capture.|
|Screen Record||Click this button to start video recording of the application output on a physical device. This button only becomes available when you connect a physical Android device to your computer.|
Click this button to view system information on the selected process provided by the
Dumpsys tool. Logs open as text files
in separate editor tabs. Select which type of information you want to view from the popup menu that opens:
|Terminate Application||Click this icon to stop the application execution.|
This tab shows all system debug output messages related to the selected process on the selected device.
Use the toolbar controls and buttons to configure the scope and the presentation of log data, and to navigate through the log.
|Item||Tooltip and shortcut||Description|
From this drop-down list, select the priority of log messages to be displayed.
The available options are:
|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 button.|
From this list, select an existing filter configuration, or create a new one.
A filter configuration is a set of filtering parameters. The use of 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.
|Clear logcat||Click this button to remove log data from previous sessions on the selected device.|
|Scroll to the end||Click this button to move the caret to the last line of the console output.|
Up the Stack Trace|
|Click this button to navigate up in the stack trace and have the cursor jump to the corresponding location in the source code.|
Down the Stack Trace|
|Click this button to navigate down in the stack trace and have the cursor jump to the corresponding location in the source code.|
|Use Soft Wraps||Click this button to toggle the soft wrap mode of the output.|
|Click this button to print the logs.|
|Restart||Click this button to restart logging.|
ADB logs tab
This tab shows the Android Debugging Bridge log messages.
The Memory tab shows in real-time how your application allocates memory. It displays available and used memory in a graph, which is good for testing purposes and helps detect whether performance issues are related to garbage collection events:
|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).|
|Dump Java Heap||Click this button to dump the contents of the Java heap memory to a file.|
|Start Allocation Tracking||
Click this button to start recording your application's memory allocations. Then interact with your application and click the
same button to stop allocation tracking. A pane with the recorded data will open as a separate editor tab.
Allocation tracking is helpful to identify where similar object types are allocated and deallocated over a short period of time, and to detect places in your code that may cause inefficient memory usage.
The CPU tab shows in real time how much CPU is being used in a graph:
|Start Method Tracing||
Click this button to invoke profiling of a method, see Starting method profiling.
Interact with the application, and then click the same button to stop method tracing. A pane with the recorded
data will open as a separate editor tab.
Method tracking is useful to track down performance issues.