Diff for "AndroidScreenshots"

Differences between revisions 1 and 2
⇤ ← Revision 1 as of 2009-06-17 14:11:55 →
Size: 2634
Editor: modemcable065
Comment: Draft, without images
← Revision 2 as of 2009-06-17 14:17:12 → ⇥
Size: 2891
Editor: modemcable065
Comment:
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
There is no functionality to take screen captures from your Android phone as part of the default setup. You will need a separate computer running the Davik Debug Monitor (DDMS). This guide explains how to install. There is no functionality to take screen captures from your Android phone as part of the default setup. You will need a separate computer running the Davik Debug Monitor (DDMS). This guide explains how to install the required software and prepare Ubuntu to take screenshots of your phone.
Line 6: Line 6:
== Installing the Android SDK ==
Line 8: Line 9:
 1. Install the Android SDK
  1. Download the [[http://guide.opendns.com/track/click.php?q=android+SDK&curl=http%3A%2F%2Fcode.google.com%2Fandroid%2Fdownload.html&search_grp=MAINRESULTS&search_pos=1|Android SDK]] for Linux. The current version as of this writing is ''Android 1.5 SDK, Release 2''. You should have a file named {{{android-sdk-linux_x86-1.5_r2.zip}}} or similar
  1. Uncompress the file by right-clicking on the archive file and clicking {{{Extract Here}}}, or use {{{unzip android-sdk-linux_x86-1.5_r2.zip}}} from command line.
 1. Setup UDEV rules to grant access to your phone.
  1. Ubuntu won't allow the DDMS access to the Android phone via USB unless the appropriate udev rule is set. This is [[https://bugs.launchpad.net/ubuntu/+source/hal/+bug/316215|Bug #316215]]]. In order to provide such rule, you need to create a rule file as root. From {{{Applications > Accessories > Terminal}}}: {{{		  1. Download the [[http://guide.opendns.com/track/click.php?q=android+SDK&curl=http%3A%2F%2Fcode.google.com%2Fandroid%2Fdownload.html&search_grp=MAINRESULTS&search_pos=1|Android SDK]] for Linux. The current version as of this writing is ''Android 1.5 SDK, Release 2''. You should have a file named {{{android-sdk-linux_x86-1.5_r2.zip}}} or similar
 1. Uncompress the file by right-clicking on the archive file and clicking {{{Extract Here}}}, or use {{{unzip android-sdk-linux_x86-1.5_r2.zip}}} from command line.

== Setting up UDEV rules to grant access to your phone. ==
 1. Ubuntu won't allow the DDMS access to the Android phone via USB unless the appropriate udev rule is set. This is [[https://bugs.launchpad.net/ubuntu/+source/hal/+bug/316215|Bug #316215]]. In order to provide such rule, you need to create a rule file as root. From {{{Applications > Accessories > Terminal}}}: {{{
Line 14: Line 15:
  1. Once the text editor comes up, insert the following in that file:{{{  1. Once the text editor comes up, insert the following in that file: {{{
Line 16: Line 17:
 1. Enable USB debugging mode on your phone
  1. Go to the '''Settings''' application, then {{{Applications > Development}}}. Mark the {{{USB Debugging}}} checkbox: *PLACEHOLDER*
 1. Connect your phone via USB, without mounting the SD card as mass storage. Your notification area should look like this: *PLACEHOLDER*
 1. Start DDMS
  1. Navigate to the directory where you extracted the Android SDK, locate the {{{tools}}} directory
  1. Double-click on {{{ddms}}}. After answering to the data-gathering question, DDMS should start and show your device on the left pane: *placeholder*		  1. Save the file and exit the terminal
Line 23: Line 19:
Once DDMS has been installed and your device is visible withing it, you can click on it and then go to {{{Device > Screen Capture}}} or simply press Ctrl-S and the capture dialog will show your current phone display, allowing to {{{Refresh}}}, {{{Save}}} or quit by clicking {{{Done}}}: *Placeholder* == Enabling USB debugging mopde on your phone ==
 1. Go to the '''Settings''' application, then {{{Applications > Development}}}.
 1. Mark the {{{USB Debugging}}} checkbox: *PLACEHOLDER*

== Connecting the phone via USB ==
 1. Connect your phone via USB, without mounting the SD card as mass storage. Only the original cable will work.

Your notification area should look like this: *PLACEHOLDER*

== Starting DDMS for the first time, taking screenshots ==
 1. Navigate to the directory where you extracted the Android SDK, locate the {{{tools}}} directory
 1. Double-click on {{{ddms}}}. After answering to the data-gathering question, DDMS should start and show your device on the left pane: *placeholder*

Once DDMS has been installed and your device is visible within it, you can click on it and then go to {{{Device > Screen Capture}}} or simply press Ctrl-S and the capture dialog will show your current phone display, allowing to {{{Refresh}}}, {{{Save}}} or quit by clicking {{{Done}}}: *Placeholder*

Taking Android phones screenshots from Ubuntu

Note: this guide has been tested with Ubuntu 9.04 (Jaunty) only. If you have information for other versions, please add it.

There is no functionality to take screen captures from your Android phone as part of the default setup. You will need a separate computer running the Davik Debug Monitor (DDMS). This guide explains how to install the required software and prepare Ubuntu to take screenshots of your phone.

Installing the Android SDK

IMPORTANT: Other guides mention installing Eclipse and Android development plugins, however this is not necessary if you only want to get screenshots from your device (as opposed to actually develop an application for it).

  1. Download the Android SDK for Linux. The current version as of this writing is Android 1.5 SDK, Release 2. You should have a file named android-sdk-linux_x86-1.5_r2.zip or similar

  2. Uncompress the file by right-clicking on the archive file and clicking Extract Here, or use unzip android-sdk-linux_x86-1.5_r2.zip from command line.

Setting up UDEV rules to grant access to your phone.

  1. Ubuntu won't allow the DDMS access to the Android phone via USB unless the appropriate udev rule is set. This is Bug #316215. In order to provide such rule, you need to create a rule file as root. From Applications > Accessories > Terminal: 

    gksudo /etc/udev/rules.d/90-android.rules

  2. Once the text editor comes up, insert the following in that file: 

    SUBSYSTEM=="usb", ATTRS{idVendor}=="0bb4", MODE="0666"
  3. Save the file and exit the terminal

Enabling USB debugging mopde on your phone

  1. Go to the Settings application, then Applications > Development.

  2. Mark the USB Debugging checkbox: *PLACEHOLDER*

Connecting the phone via USB

  1. Connect your phone via USB, without mounting the SD card as mass storage. Only the original cable will work.

Your notification area should look like this: *PLACEHOLDER*

Starting DDMS for the first time, taking screenshots

  1. Navigate to the directory where you extracted the Android SDK, locate the tools directory

  2. Double-click on ddms. After answering to the data-gathering question, DDMS should start and show your device on the left pane: *placeholder*

Once DDMS has been installed and your device is visible within it, you can click on it and then go to Device > Screen Capture or simply press Ctrl-S and the capture dialog will show your current phone display, allowing to Refresh, Save or quit by clicking Done: *Placeholder*

AndroidScreenshots (last edited 2012-03-03 17:07:07 by 174-20-225-5)