Loading docs/html/guide/developing/debugging/ddms.jd +1 −1 Original line number Original line Diff line number Diff line Loading @@ -280,5 +280,5 @@ page.title=Using DDMS </ul> </ul> For more information about providing mock location data, see For more information about providing mock location data, see <a href="guide/topics/location/obtaining-user-location.html#MockData">Obtaining User Location</a>. <a href="{@docRoot}guide/topics/location/obtaining-user-location.html#MockData">Obtaining User Location</a>. docs/html/guide/developing/debugging/debugging-tracing.jd +4 −6 Original line number Original line Diff line number Diff line Loading @@ -204,9 +204,9 @@ clock=global <h2 id="creatingtracefiles">Creating Trace Files</h2> <h2 id="creatingtracefiles">Creating Trace Files</h2> <p>To use Traceview, you need to generate log files containing the trace information you want to <p>To use Traceview, you need to generate log files containing the trace information you want to analyze.<p> analyze.</p> <p>There are two ways to generate trace logs:<p> <p>There are two ways to generate trace logs:</p> <ul> <ul> <li>Include the {@link android.os.Debug} class in your code and call its <li>Include the {@link android.os.Debug} class in your code and call its methods to start and stop logging of trace information to disk. This method is very precise because methods to start and stop logging of trace information to disk. This method is very precise because Loading Loading @@ -293,7 +293,7 @@ traceview /tmp/calc <p class="note"><strong>Note:</strong> If you are trying to view the trace logs of an application <p class="note"><strong>Note:</strong> If you are trying to view the trace logs of an application that is built with ProGuard enabled (release mode build), some method and member names might be obfuscated. that is built with ProGuard enabled (release mode build), some method and member names might be obfuscated. You can use the Proguard <code>mapping.txt</code> file to figure out the original unobfuscated names. For more information You can use the Proguard <code>mapping.txt</code> file to figure out the original unobfuscated names. For more information on this file, see the <a href="{@docRoot}/guide/developing/tools/proguard.html>Proguard</a> documentation.</p> on this file, see the <a href="{@docRoot}guide/developing/tools/proguard.html">Proguard</a> documentation.</p> <h2 id="dmtracedump">Using dmtracdedump</h2> <h2 id="dmtracedump">Using dmtracdedump</h2> Loading @@ -308,7 +308,7 @@ traceview /tmp/calc "{@docRoot}images/tracedump.png" "{@docRoot}images/tracedump.png" width="485" width="485" height="401" /> height="401" /> <p class="image-caption><strong>Figure 3.</strong> Screenshot of dmtracedump</p> <p class="image-caption"><strong>Figure 3.</strong> Screenshot of dmtracedump</p> <p>For each node, dmtracedump shows <code><ref> <p>For each node, dmtracedump shows <code><ref> <em>callname</em> (<inc-ms>, <exc-ms>,<numcalls>)</code>, where</p> <em>callname</em> (<inc-ms>, <exc-ms>,<numcalls>)</code>, where</p> Loading Loading @@ -378,8 +378,6 @@ dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] <trace-base is 20%.</td> is 20%.</td> </tr> </tr> </table> </table> </dd> </dl> Loading docs/html/guide/developing/device.jd +1 −1 Original line number Original line Diff line number Diff line Loading @@ -41,7 +41,7 @@ Dev Phone, see the <a href="http://market.android.com/publish">Android Market</a <p class="note"><strong>Note:</strong> When developing on a device, keep in mind that you should <p class="note"><strong>Note:</strong> When developing on a device, keep in mind that you should still use the <a still use the <a href="{@docRoot}guide/developing/tools/emulator.html">Android emulator</a> to test your application href="{@docRoot}guide/developing/devices/emulator.html">Android emulator</a> to test your application on configurations that are not equivalent to those of your real device. Although the emulator on configurations that are not equivalent to those of your real device. Although the emulator does not allow you to test every device feature (such as the accelerometer), it does does not allow you to test every device feature (such as the accelerometer), it does allow you to verify that your application functions properly on different versions of the Android allow you to verify that your application functions properly on different versions of the Android Loading docs/html/guide/developing/tools/index.jd +45 −44 Original line number Original line Diff line number Diff line Loading @@ -10,75 +10,76 @@ includes a variety of other tools for debugging, packaging, and installing your applications on the emulator. </p> applications on the emulator. </p> <dl> <dl> <dt><a href="{@docRoot}sdk/eclipse-adt.html">Android Development Tools Plugin</a> (for the Eclipse IDE)</dt> <dt><a href="adb.html">Android Debug Bridge</a></dt> <dd>The ADT plugin adds powerful extensions to the Eclipse integrated environment, <dd>A versatile tool lets you manage the state of an emulator instance making creating and debugging your Android applications easier and faster.</dd> or Android-powered device.</dd> <dt><a href="emulator.html">Android Emulator</a></dt> <dd>A QEMU-based device-emulation tool that you can use to design, debug, and test your applications in an actual Android run-time environment. </dd> <dt><a href="android.html">android</a></dt> <dd>Lets you manage AVDs, projects, and the installed components of the SDK. </dd> <dt><a href="bmgr.html">bmgr</a></dt> <dt><a href="bmgr.html">bmgr</a></dt> <dd>A shell tool you can use to interact with the Backup Manager on Android devices <dd>Lets you interact with the Backup Manager on Android devices supporting API Level 8 or greater. It provides commands to invoke backup and restore operations supporting API Level 8 or greater. It provides commands to invoke backup and restore operations so that you don't need to repeatedly wipe data or take similar intrusive steps in order to test so that you don't need to repeatedly wipe data or take similar intrusive steps in order to test your application's backup agent. These commands are accessed via the adb shell. your application's backup agent. These commands are accessed via the adb shell. </dd> </dd> <dt><a href="layoutopt.html">layoutopt</a></dt> <dt><a href="dmtracedump.html">dmtracedump</a></dt> <dd>This tool lets you quickly analyze your application's layouts in order to optimize them for efficiency. </dd> <dd>Generates graphical call-stack diagrams from trace log files. The tool uses the Graphviz Dot utility to create the graphical output, so you need to install Graphviz before running <code>dmtracedump</code>. For more information on using <code>dmtracedump</code>, see <a href="{@docRoot}guide/developing/debugging/debugging-tracing.html#dmtracedump">Profiling with Traceview and dmtracedump</a> </dd> <dt><a href="draw9patch.html">Draw 9-patch</a></dt> <dt><a href="draw9patch.html">Draw 9-patch</a></dt> <dd>The Draw 9-patch tool allows you to easily create a <dd>Allows you to easily create a {@link android.graphics.NinePatch} graphic using a WYSIWYG editor. {@link android.graphics.NinePatch} graphic using a WYSIWYG editor. It also previews stretched It also previews stretched versions of the image, and highlights the area in which content is allowed. versions of the image, and highlights the area in which content is allowed. </dd> </dd> <dt><a href="emulator.html">Android Emulator</a></dt> <dt><a href="adb.html" >Android Debug Bridge</a> (adb)</dt> <dd>A QEMU-based device-emulation tool that you can use to design, <dd>The adb tool lets you install your application's .apk files on an debug, and test your applications in an actual Android run-time environment. </dd> emulator or device and access the emulator or device from a command line. You can also use it to link a standard debugger to application code running on an Android emulator or device. <p>This is located in {@code <sdk>/platform-tools/}.</p></dd> <dt><a href="hprof-conv.html">hprof-conv</a></dt> <dt><a href="hprof-conv.html">hprof-conv</a></dt> <dd>A tool that converts the HPROF file that is generated by the Android SDK tools to a <dd>Converts the HPROF file that is generated by the Android SDK tools to a standard format so you can view the file in a profiling tool of your choice.</dd> standard format so you can view the file in a profiling tool of your choice.</dd> <dt><a href="sqlite3.html">sqlite3</a></dt> <dt><a href="layoutopt.html">layoutopt</a></dt> <dd>Included as a convenience, this tool lets you access the SQLite data <dd>Lets you quickly analyze your application's layouts in order to files created and used by Android applications.</dd> optimize them for efficiency. </dd> <dt><a href="mksdcard.html">logcat</a></dt> <dd>Lets you read system log messages that are output on an Android device or emulator.</dd> <dt><a href="mksdcard.html">mksdcard</a></dt> <dt><a href="mksdcard.html">mksdcard</a></dt> <dd>Helps you create a disk image that you can use with the emulator, <dd>Helps you create a disk image that you can use with the emulator, to simulate the presence of an external storage card (such as an SD card).</dd> to simulate the presence of an external storage card (such as an SD card).</dd> <dt><a href="monkey.html">UI/Application <dt><a href="monkey.html">Monkey</a></dt> <dd>Runs on your emulator or device and generates pseudo-random Exerciser Monkey</a></dt> <dd>A program that runs on your emulator or device and generates pseudo-random streams of user events such as clicks, touches, or gestures, as well as a number of system-level events. streams of user events such as clicks, touches, or gestures, as well as a number of system-level events. You can use the Monkey to stress-test applications that you are developing, in a random yet repeatable manner.</dd> You can use the Monkey to stress-test applications that you are developing, in a random yet repeatable manner.</dd> <dt><a href="monkeyrunner_concepts.html">monkeyrunner</a></dt> <dd>Provides an API for writing programs that control an Android device or emulator from outside of Android code.</dd> <dt><a href="android.html">android</a></dt> <dt><a href="proguard.html">ProGuard</a></dt> <dd>A script that lets you manage AVDs and generate <a <dd>Shrinks, optimizes, and obfuscates your code by removing unused code and renaming classes, href="http://ant.apache.org/" title="Ant">Ant</a> build files that fields, and methods with semantically obscure names.</dd> you can use to compile your Android applications. </dd> <dt><a href="sqlite3.html">sqlite3</a></dt> <dd>Lets you access the SQLite data files created and used by Android applications.</dd> <dt><a href="zipalign.html">zipalign</a></dt> <dt><a href="zipalign.html">zipalign</a></dt> <dd>An important .apk optimization tool. This tool ensures that all uncompressed data starts <dd>Optimizes <code>.apk</code> files by ensuring that all uncompressed data starts with a particular alignment relative to the start of the file. This should always be used with a particular alignment relative to the start of the file. This should always be used to align .apk files after they have been signed.</dd> to align .apk files after they have been signed.</dd> </dl> </dl> docs/html/guide/developing/tools/monkey.jd +1 −1 Original line number Original line Diff line number Diff line Loading @@ -185,7 +185,7 @@ transitions invoked by your application.</td> <td>If set, this option will generate profiling reports immediately before and after <td>If set, this option will generate profiling reports immediately before and after the Monkey event sequence. the Monkey event sequence. This will generate large (~5Mb) files in data/misc, so use with care. See This will generate large (~5Mb) files in data/misc, so use with care. See <a href="{@docRoot}guide/developing/tools/traceview.html" title="traceview">Traceview</a> for more information <a href="{@docRoot}guide/developing/debugging/debugging-tracing.html" title="traceview">Traceview</a> for more information on trace files.</td> on trace files.</td> </tr> </tr> Loading Loading
docs/html/guide/developing/debugging/ddms.jd +1 −1 Original line number Original line Diff line number Diff line Loading @@ -280,5 +280,5 @@ page.title=Using DDMS </ul> </ul> For more information about providing mock location data, see For more information about providing mock location data, see <a href="guide/topics/location/obtaining-user-location.html#MockData">Obtaining User Location</a>. <a href="{@docRoot}guide/topics/location/obtaining-user-location.html#MockData">Obtaining User Location</a>.
docs/html/guide/developing/debugging/debugging-tracing.jd +4 −6 Original line number Original line Diff line number Diff line Loading @@ -204,9 +204,9 @@ clock=global <h2 id="creatingtracefiles">Creating Trace Files</h2> <h2 id="creatingtracefiles">Creating Trace Files</h2> <p>To use Traceview, you need to generate log files containing the trace information you want to <p>To use Traceview, you need to generate log files containing the trace information you want to analyze.<p> analyze.</p> <p>There are two ways to generate trace logs:<p> <p>There are two ways to generate trace logs:</p> <ul> <ul> <li>Include the {@link android.os.Debug} class in your code and call its <li>Include the {@link android.os.Debug} class in your code and call its methods to start and stop logging of trace information to disk. This method is very precise because methods to start and stop logging of trace information to disk. This method is very precise because Loading Loading @@ -293,7 +293,7 @@ traceview /tmp/calc <p class="note"><strong>Note:</strong> If you are trying to view the trace logs of an application <p class="note"><strong>Note:</strong> If you are trying to view the trace logs of an application that is built with ProGuard enabled (release mode build), some method and member names might be obfuscated. that is built with ProGuard enabled (release mode build), some method and member names might be obfuscated. You can use the Proguard <code>mapping.txt</code> file to figure out the original unobfuscated names. For more information You can use the Proguard <code>mapping.txt</code> file to figure out the original unobfuscated names. For more information on this file, see the <a href="{@docRoot}/guide/developing/tools/proguard.html>Proguard</a> documentation.</p> on this file, see the <a href="{@docRoot}guide/developing/tools/proguard.html">Proguard</a> documentation.</p> <h2 id="dmtracedump">Using dmtracdedump</h2> <h2 id="dmtracedump">Using dmtracdedump</h2> Loading @@ -308,7 +308,7 @@ traceview /tmp/calc "{@docRoot}images/tracedump.png" "{@docRoot}images/tracedump.png" width="485" width="485" height="401" /> height="401" /> <p class="image-caption><strong>Figure 3.</strong> Screenshot of dmtracedump</p> <p class="image-caption"><strong>Figure 3.</strong> Screenshot of dmtracedump</p> <p>For each node, dmtracedump shows <code><ref> <p>For each node, dmtracedump shows <code><ref> <em>callname</em> (<inc-ms>, <exc-ms>,<numcalls>)</code>, where</p> <em>callname</em> (<inc-ms>, <exc-ms>,<numcalls>)</code>, where</p> Loading Loading @@ -378,8 +378,6 @@ dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] <trace-base is 20%.</td> is 20%.</td> </tr> </tr> </table> </table> </dd> </dl> Loading
docs/html/guide/developing/device.jd +1 −1 Original line number Original line Diff line number Diff line Loading @@ -41,7 +41,7 @@ Dev Phone, see the <a href="http://market.android.com/publish">Android Market</a <p class="note"><strong>Note:</strong> When developing on a device, keep in mind that you should <p class="note"><strong>Note:</strong> When developing on a device, keep in mind that you should still use the <a still use the <a href="{@docRoot}guide/developing/tools/emulator.html">Android emulator</a> to test your application href="{@docRoot}guide/developing/devices/emulator.html">Android emulator</a> to test your application on configurations that are not equivalent to those of your real device. Although the emulator on configurations that are not equivalent to those of your real device. Although the emulator does not allow you to test every device feature (such as the accelerometer), it does does not allow you to test every device feature (such as the accelerometer), it does allow you to verify that your application functions properly on different versions of the Android allow you to verify that your application functions properly on different versions of the Android Loading
docs/html/guide/developing/tools/index.jd +45 −44 Original line number Original line Diff line number Diff line Loading @@ -10,75 +10,76 @@ includes a variety of other tools for debugging, packaging, and installing your applications on the emulator. </p> applications on the emulator. </p> <dl> <dl> <dt><a href="{@docRoot}sdk/eclipse-adt.html">Android Development Tools Plugin</a> (for the Eclipse IDE)</dt> <dt><a href="adb.html">Android Debug Bridge</a></dt> <dd>The ADT plugin adds powerful extensions to the Eclipse integrated environment, <dd>A versatile tool lets you manage the state of an emulator instance making creating and debugging your Android applications easier and faster.</dd> or Android-powered device.</dd> <dt><a href="emulator.html">Android Emulator</a></dt> <dd>A QEMU-based device-emulation tool that you can use to design, debug, and test your applications in an actual Android run-time environment. </dd> <dt><a href="android.html">android</a></dt> <dd>Lets you manage AVDs, projects, and the installed components of the SDK. </dd> <dt><a href="bmgr.html">bmgr</a></dt> <dt><a href="bmgr.html">bmgr</a></dt> <dd>A shell tool you can use to interact with the Backup Manager on Android devices <dd>Lets you interact with the Backup Manager on Android devices supporting API Level 8 or greater. It provides commands to invoke backup and restore operations supporting API Level 8 or greater. It provides commands to invoke backup and restore operations so that you don't need to repeatedly wipe data or take similar intrusive steps in order to test so that you don't need to repeatedly wipe data or take similar intrusive steps in order to test your application's backup agent. These commands are accessed via the adb shell. your application's backup agent. These commands are accessed via the adb shell. </dd> </dd> <dt><a href="layoutopt.html">layoutopt</a></dt> <dt><a href="dmtracedump.html">dmtracedump</a></dt> <dd>This tool lets you quickly analyze your application's layouts in order to optimize them for efficiency. </dd> <dd>Generates graphical call-stack diagrams from trace log files. The tool uses the Graphviz Dot utility to create the graphical output, so you need to install Graphviz before running <code>dmtracedump</code>. For more information on using <code>dmtracedump</code>, see <a href="{@docRoot}guide/developing/debugging/debugging-tracing.html#dmtracedump">Profiling with Traceview and dmtracedump</a> </dd> <dt><a href="draw9patch.html">Draw 9-patch</a></dt> <dt><a href="draw9patch.html">Draw 9-patch</a></dt> <dd>The Draw 9-patch tool allows you to easily create a <dd>Allows you to easily create a {@link android.graphics.NinePatch} graphic using a WYSIWYG editor. {@link android.graphics.NinePatch} graphic using a WYSIWYG editor. It also previews stretched It also previews stretched versions of the image, and highlights the area in which content is allowed. versions of the image, and highlights the area in which content is allowed. </dd> </dd> <dt><a href="emulator.html">Android Emulator</a></dt> <dt><a href="adb.html" >Android Debug Bridge</a> (adb)</dt> <dd>A QEMU-based device-emulation tool that you can use to design, <dd>The adb tool lets you install your application's .apk files on an debug, and test your applications in an actual Android run-time environment. </dd> emulator or device and access the emulator or device from a command line. You can also use it to link a standard debugger to application code running on an Android emulator or device. <p>This is located in {@code <sdk>/platform-tools/}.</p></dd> <dt><a href="hprof-conv.html">hprof-conv</a></dt> <dt><a href="hprof-conv.html">hprof-conv</a></dt> <dd>A tool that converts the HPROF file that is generated by the Android SDK tools to a <dd>Converts the HPROF file that is generated by the Android SDK tools to a standard format so you can view the file in a profiling tool of your choice.</dd> standard format so you can view the file in a profiling tool of your choice.</dd> <dt><a href="sqlite3.html">sqlite3</a></dt> <dt><a href="layoutopt.html">layoutopt</a></dt> <dd>Included as a convenience, this tool lets you access the SQLite data <dd>Lets you quickly analyze your application's layouts in order to files created and used by Android applications.</dd> optimize them for efficiency. </dd> <dt><a href="mksdcard.html">logcat</a></dt> <dd>Lets you read system log messages that are output on an Android device or emulator.</dd> <dt><a href="mksdcard.html">mksdcard</a></dt> <dt><a href="mksdcard.html">mksdcard</a></dt> <dd>Helps you create a disk image that you can use with the emulator, <dd>Helps you create a disk image that you can use with the emulator, to simulate the presence of an external storage card (such as an SD card).</dd> to simulate the presence of an external storage card (such as an SD card).</dd> <dt><a href="monkey.html">UI/Application <dt><a href="monkey.html">Monkey</a></dt> <dd>Runs on your emulator or device and generates pseudo-random Exerciser Monkey</a></dt> <dd>A program that runs on your emulator or device and generates pseudo-random streams of user events such as clicks, touches, or gestures, as well as a number of system-level events. streams of user events such as clicks, touches, or gestures, as well as a number of system-level events. You can use the Monkey to stress-test applications that you are developing, in a random yet repeatable manner.</dd> You can use the Monkey to stress-test applications that you are developing, in a random yet repeatable manner.</dd> <dt><a href="monkeyrunner_concepts.html">monkeyrunner</a></dt> <dd>Provides an API for writing programs that control an Android device or emulator from outside of Android code.</dd> <dt><a href="android.html">android</a></dt> <dt><a href="proguard.html">ProGuard</a></dt> <dd>A script that lets you manage AVDs and generate <a <dd>Shrinks, optimizes, and obfuscates your code by removing unused code and renaming classes, href="http://ant.apache.org/" title="Ant">Ant</a> build files that fields, and methods with semantically obscure names.</dd> you can use to compile your Android applications. </dd> <dt><a href="sqlite3.html">sqlite3</a></dt> <dd>Lets you access the SQLite data files created and used by Android applications.</dd> <dt><a href="zipalign.html">zipalign</a></dt> <dt><a href="zipalign.html">zipalign</a></dt> <dd>An important .apk optimization tool. This tool ensures that all uncompressed data starts <dd>Optimizes <code>.apk</code> files by ensuring that all uncompressed data starts with a particular alignment relative to the start of the file. This should always be used with a particular alignment relative to the start of the file. This should always be used to align .apk files after they have been signed.</dd> to align .apk files after they have been signed.</dd> </dl> </dl>
docs/html/guide/developing/tools/monkey.jd +1 −1 Original line number Original line Diff line number Diff line Loading @@ -185,7 +185,7 @@ transitions invoked by your application.</td> <td>If set, this option will generate profiling reports immediately before and after <td>If set, this option will generate profiling reports immediately before and after the Monkey event sequence. the Monkey event sequence. This will generate large (~5Mb) files in data/misc, so use with care. See This will generate large (~5Mb) files in data/misc, so use with care. See <a href="{@docRoot}guide/developing/tools/traceview.html" title="traceview">Traceview</a> for more information <a href="{@docRoot}guide/developing/debugging/debugging-tracing.html" title="traceview">Traceview</a> for more information on trace files.</td> on trace files.</td> </tr> </tr> Loading