blob: 5f7b5ce9a19b021cfedc6d45e36193ae869753bb [file] [log] [blame]
Joe Fernandezcb58e6b2012-07-20 08:42:26 -07001page.title=Device Monitor
Joe Fernandez3e820be2012-06-19 15:48:29 -07002@jd:body
3
Scott Maina3f0e012013-09-19 17:45:40 -07004 <div id="qv-wrapper">
5 <div id="qv">
6 <h2>See also</h2>
7
8 <ol>
9 <li><a href="{@docRoot}tools/debugging/debugging-memory.html"
10 >Investigating Your RAM Usage</a></li>
11 </ol>
12 </div>
13 </div>
14
15
Joe Fernandezcb58e6b2012-07-20 08:42:26 -070016<p>Android Device Monitor is a stand-alone tool that provides a graphical user interface for
Joe Fernandez3e820be2012-06-19 15:48:29 -070017several Android application debugging and analysis tools. The Monitor tool does not
Rich Slogar2c35e922015-03-31 16:30:02 -070018require installation of an integrated development environment, such as Android Studio, and
19encapsulates the following tools:</p>
Joe Fernandez3e820be2012-06-19 15:48:29 -070020
21<ul>
22 <li><a href="{@docRoot}tools/debugging/ddms.html">DDMS</a></li>
23 <li><a href="gltracer.html">Tracer for OpenGL ES</a></li>
24 <li><a href="hierarchy-viewer.html">Hierarchy Viewer</a></li>
Joe Fernandez25ef2082013-09-16 11:31:25 -070025 <li><a href="systrace.html">Systrace</a></li>
Joe Fernandez3e820be2012-06-19 15:48:29 -070026 <li><a href="traceview.html">Traceview</a></li>
27 <li>Pixel Perfect magnification viewer</li>
28</ul>
29
Scott Maina3f0e012013-09-19 17:45:40 -070030
Joe Fernandez3e820be2012-06-19 15:48:29 -070031<h2 id="usage">Usage</h2>
32
Rich Slogar2c35e922015-03-31 16:30:02 -070033<p>To start Device Monitor:</p>
34
35<ul>
36 <li>From Android Studio, choose <strong>Tools &gt; Android Device Monitor</strong> or click
37 the Android Device Monitor icon
38 <img src="{@docRoot}images/tools/hierarchicalviewer-icon.png" alt=""/>.
39 </li>
40 <li>From the command line, in the SDK <code>tools/</code> directory, enter the following command:
Joe Fernandez3e820be2012-06-19 15:48:29 -070041 <pre>monitor</pre>
Rich Slogar2c35e922015-03-31 16:30:02 -070042 </li>
43</ul>
44
45
Joe Fernandez3e820be2012-06-19 15:48:29 -070046
Joe Fernandezcb58e6b2012-07-20 08:42:26 -070047<p>Start an Android emulator or connect an Android device via USB cable, and connect Device
Joe Fernandez3e820be2012-06-19 15:48:29 -070048Monitor to the device by selecting it in the <strong>Devices</strong> window.</p>
Scott Maina3f0e012013-09-19 17:45:40 -070049
50<p class="note"><strong>Note:</strong> Only one debugger can be connected to your device at a time.
51If you're using ADT, you may need to close the debugging tool before launching the Device Monitor
52in order for the device to be fully debuggable.</p>