diff options
Diffstat (limited to 'docs/html/guide/developing/debugging')
5 files changed, 81 insertions, 5 deletions
diff --git a/docs/html/guide/developing/debugging/ddms.jd b/docs/html/guide/developing/debugging/ddms.jd index 218ea44370d4..d22ad2fb0c33 100644 --- a/docs/html/guide/developing/debugging/ddms.jd +++ b/docs/html/guide/developing/debugging/ddms.jd @@ -1,4 +1,4 @@ -page.title=Using the Dalvik Debug Monitor Server +page.title=Using DDMS @jd:body <div id="qv-wrapper"> diff --git a/docs/html/guide/developing/debugging/debugging-devtools.jd b/docs/html/guide/developing/debugging/debugging-devtools.jd index d0af1c554b7f..88e6005c00c9 100644 --- a/docs/html/guide/developing/debugging/debugging-devtools.jd +++ b/docs/html/guide/developing/debugging/debugging-devtools.jd @@ -1,4 +1,4 @@ -page.title=Debugging with the Dev Tools App +page.title=Using the Dev Tools App @jd:body <p>The Dev Tools application is installed by default on all system images included with the SDK, diff --git a/docs/html/guide/developing/debugging/debugging-projects-cmdline.jd b/docs/html/guide/developing/debugging/debugging-projects-cmdline.jd index f7be0d64b08d..72bb16dd4c6c 100644 --- a/docs/html/guide/developing/debugging/debugging-projects-cmdline.jd +++ b/docs/html/guide/developing/debugging/debugging-projects-cmdline.jd @@ -1,4 +1,4 @@ -page.title=Debugging Projects in other IDEs +page.title=Debugging in other IDEs @jd:body diff --git a/docs/html/guide/developing/debugging/debugging-projects.jd b/docs/html/guide/developing/debugging/debugging-projects.jd index d4818ce0572a..0e14999e24ea 100644 --- a/docs/html/guide/developing/debugging/debugging-projects.jd +++ b/docs/html/guide/developing/debugging/debugging-projects.jd @@ -1,4 +1,4 @@ -page.title=Debugging Android Projects in Eclipse +page.title=Debugging in Eclipse @jd:body <div id="qv-wrapper"> diff --git a/docs/html/guide/developing/debugging/index.jd b/docs/html/guide/developing/debugging/index.jd index 0107621bb0be..362f45974132 100644 --- a/docs/html/guide/developing/debugging/index.jd +++ b/docs/html/guide/developing/debugging/index.jd @@ -10,6 +10,8 @@ page.title=Debugging <li><a href="#stack">Debugging Environment</a></li> <li><a href="#addltools">Additional Debugging Tools</a></li> + + <li><a href="#tips">Debugging Tips</a></li> </ol> </div> </div> @@ -106,4 +108,78 @@ page.title=Debugging <dd>The Dev Tools application included in the emulator system image exposes several settings that provide useful information such as CPU usage and frame rate. You can also transfer the application to a hardware device.</dd> - </dl>
\ No newline at end of file + </dl> + + + <h2 id="tips">Debugging Tips</h2> + +<p>While debugging, keep these helpful tips in mind to help you figure out common problems with your +applications:</p> + +<dl> +<dt><strong>Dump the stack trace</strong></dt> +<dd>To obtain a stack dump from emulator, you can log +in with <code>adb shell</code>, use <code>ps</code> to find the process you +want, and then <code>kill -3</code>. The stack trace appears in the log file. +</dd> + +<dt><strong>Display useful info on the emulator screen</strong></dt> +<dd>The device can display useful information such as CPU usage or highlights +around redrawn areas. Turn these features on and off in the developer settings +window as described in <a href="{@docRoot}guide/developing/debugging/debugging-devtools.html"> +Debugging with the Dev Tools App</a>. +</dd> + +<dt><strong>Get application and system state information from the emulator</strong></dt> +<dd>You can access dumpstate information from the <code>adb shell</code> commands. See +<a href="{@docRoot}guide/developing/tools/adb.html#dumpsys">dumpsys and +dumpstate</a> on the adb topic page.</dd> + + + +<dt><strong>Get wireless connectivity information</strong></dt> +<dd>You can get information about wireless connectivity using DDMS. +From the <strong>Device</strong> menu, select <strong>Dump +radio state</strong>.</dd> + +<dt><strong>Log trace data</strong></dt> +<dd>You can log method calls and other tracing data in an activity by calling +{@link android.os.Debug#startMethodTracing(String) startMethodTracing()}. See <a +href="{@docRoot}guide/developing/debugging/debugging-tracing.html">Profiling with Traceview and +dmtracedump</a> for details. </dd> + +<dt><strong>Log radio data</strong></dt> +<dd>By default, radio information is not logged to the system (it is a lot of +data). However, you can enable radio logging using the following commands: + +<pre class="no-pretty-print"> +adb shell +logcat -b radio +</pre> +</dd> + +<dt><strong>Capture screenshots</strong></dt> +<dd>The Dalvik Debug Monitor Server (DDMS) can capture screenshots from the emulator. Select +<strong>Device > Screen capture</strong>.</dd> + +<dt><strong>Use debugging helper classes</strong></dt> +<dd>Android provides debug helper classes such as {@link android.util.Log + util.Log} and {@link android.os.Debug} for your convenience. </dd> +</dl> + +<p>See the <a href="{@docRoot}resources/faq/troubleshooting.html">Troubleshooting</a> document +for answers to some common developing and debugging issues.</p> + + + + + + + + + + + + + + |