diff options
Diffstat (limited to 'docs/html/guide/developing/debugging/debugging-devtools.jd')
| -rw-r--r-- | docs/html/guide/developing/debugging/debugging-devtools.jd | 85 |
1 files changed, 0 insertions, 85 deletions
diff --git a/docs/html/guide/developing/debugging/debugging-devtools.jd b/docs/html/guide/developing/debugging/debugging-devtools.jd deleted file mode 100644 index 157d62e..0000000 --- a/docs/html/guide/developing/debugging/debugging-devtools.jd +++ /dev/null @@ -1,85 +0,0 @@ -page.title=Using the Dev Tools App -parent.title=Debugging -parent.link=index.html -@jd:body - -<p>The Dev Tools application is installed by default on all system images included with the SDK, - so you can use it with the Android Emulator. With the Dev Tools application, you can enable a - number of settings on your device that will make it easier to test and debug your applications.</p> - - <p> If you'd like to install the Dev Tools application - on a real development device, you can copy the application from your emulator and then install it - on your device using ADB. To copy the application from a running emulator, execute:</p> - <pre> -adb -e pull /system/app/Development.apk ./Development.apk -</pre> - - <p>This copies the .apk file into the current directory. Then install it on your connected device - with:</p> - <pre> -adb -d install Development.apk -</pre> - - <p>To get started, launch the Dev Tools application and select <strong>Development Settings</strong>. This will - open the Development Settings page with the following options (among others):</p> - - <dl> - <dt><strong>Debug app</strong></dt> - - <dd> - Lets you select the application to debug. You do not need to set this to attach a debugger, - but setting this value has two effects: - - <ul> - <li>It will prevent Android from throwing an error if you pause on a breakpoint for a long - time while debugging.</li> - - <li>It will enable you to select the <em>Wait for Debugger</em> option to pause application - startup until your debugger attaches (described next).</li> - </ul> - </dd> - - <dt><strong>Wait for debugger</strong></dt> - - <dd>Blocks the selected application from loading until a debugger attaches. This way you can - set a breakpoint in {@link android.app.Activity#onCreate onCreate()}, - which is important to debug the startup process of an Activity. - When you change this option, any currently running instances of the selected application will - be killed. In order to check this box, you must have selected a debug application as described - in the previous option. You can do the same thing by adding {@link - android.os.Debug#waitForDebugger()} to your code.</dd> - - <dt><strong>Show screen updates</strong></dt> - - <dd>Flashes a momentary pink rectangle on any screen sections that are being redrawn. This is - very useful for discovering unnecessary screen drawing.</dd> - - <dt><strong>Immediately destroy activities</strong></dt> - - <dd>Tells the system to destroy an activity as soon as it is stopped (as if Android had to - reclaim memory). This is very useful for testing the {@link - android.app.Activity#onSaveInstanceState} / {@link - android.app.Activity#onCreate(android.os.Bundle)} code path, which would otherwise be difficult - to force. Choosing this option will probably reveal a number of problems in your application - due to not saving state. For more information about saving an activity's state, see the - <a href="{@docRoot}guide/topics/fundamentals/activities.html#SavingActivityState">Activities</a> -document.</dd> - - <dt><strong>Show CPU usage</strong></dt> - - <dd>Displays CPU meters at the top of the screen, showing how much the CPU is being used. The - top red bar shows overall CPU usage, and the green bar underneath it shows the CPU time spent - in compositing the screen. - <p class="note">Note: You cannot turn this feature off once it is on, without - restarting the emulator.</p></dd> - - <dt><strong>Show background</strong></dt> - - <dd>Displays a background pattern when no activity screens are visible. This typically does not - happen, but can happen during debugging.</dd> - </dl> - - <p>These settings will be remembered across emulator restarts.</p> - - - |