diff --git a/docs/html/guide/developing/device.jd b/docs/html/guide/developing/device.jd index d390ec1474d18..d22dca1fee41b 100644 --- a/docs/html/guide/developing/device.jd +++ b/docs/html/guide/developing/device.jd @@ -51,19 +51,13 @@ would on the emulator. Before you can start, there are just a few things to do:<
  1. Declare your application as "debuggable" in your Android Manifest. -

    In Eclipse, you can do this from the Application tab when viewing the Manifest - (on the right side, set Debuggable to true). Otherwise, in the -AndroidManifest.xml - file, add android:debuggable="true" to the <application> -element.

    -
    2. -
  2. Set up your device to allow installation of non-Market applications.

    On -the device, go to Settings > Applications and enable - -Unknown sources (on an Android 4.0 device, the setting is -located in Settings > Security).

    - -
    3. +

    When using Eclipse, you can skip this step, because running your app directly from +the Eclipse IDE automatically enables debugging.

    +

    In the AndroidManifest.xml file, add android:debuggable="true" to +the <application> element.

    +

    Note: If you manually enable debugging in the manifest + file, be sure to disable it before you build for release (your published application +should usually not be debuggable).

  3. Turn on "USB Debugging" on your device.

    On the device, go to Settings > Applications > Development and enable USB debugging @@ -72,13 +66,10 @@ located in Settings > Developer options).

  4. Set up your system to detect your device.
-

You can verify that your device is connected by executing adb +

When plugged in over USB, can verify that your device is connected by executing adb devices from your SDK {@code platform-tools/} directory. If connected, you'll see the device name listed as a "device."

diff --git a/docs/html/sdk/oem-usb.jd b/docs/html/sdk/oem-usb.jd index b81be71dc079f..f98257df00274 100644 --- a/docs/html/sdk/oem-usb.jd +++ b/docs/html/sdk/oem-usb.jd @@ -3,9 +3,21 @@ page.title=OEM USB Drivers
@@ -18,8 +30,185 @@ where you can download the appropriate USB driver for your device. However, this not exhaustive for all available Android-powered devices.

If you're developing on Mac OS X or Linux, then you probably don't need to install a USB driver. -Refer to Setting up a Device to -start development with a device.

+To start developing with your device, read Using Hardware Devices.

+ +

Note: If your device is one of the Android Developer Phones +(purchased from the Android Market publisher site), a Nexus One, or a Nexus S, then you need +the Google USB Driver, instead of an OEM driver. The Galaxy +Nexus driver, however, is distributed by Samsung +(listed as model SCH-I515).

+ + +

Installing a USB Driver

+ +

First, find the appropriate driver for your device from the OEM drivers +table below.

+ +

Once you've downloaded your USB driver, follow the instructions below to install or upgrade the +driver, based on your version of Windows and whether you're installing for the first time +or upgrading an existing driver.

+ +

Tip: When you finish the USB driver installation, +see Using Hardware Devices for +other important information about using an Android-powered device for +development.

+ +
    +
  1. Windows 7
    2. +
  2. Windows XP
    3. +
  3. Windows Vista
    4. +
+ + +

Caution: +You may make changes to android_winusb.inf file found inside +usb_driver\ (for example, to add support for other devices), +however, this will lead to security warnings when you install or upgrade the +driver. Making any other changes to the driver files may break the installation +process.

+ + +

Windows 7

+ + +

To install the Android USB driver on Windows 7 for the first time:

+
    +
  1. Connect your Android-powered device to your computer's USB port.
    2. +
  2. Right-click on Computer from your desktop or Windows Explorer, + and select Manage.
    3. +
  3. Select Devices in the left pane.
    4. +
  4. Locate and expand Other device in the right pane.
    5. +
  5. Right-click the device name (such as Nexus S) and select Update + Driver Software. + This will launch the Hardware Update Wizard.
    6. +
  6. Select Browse my computer for driver software and click + Next.
    7. +
  7. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    8. +
  8. Click Next to install the driver.
    9. +
+ +

Or, to upgrade an existing Android USB driver on Windows 7 with the new +driver:

+ +
    +
  1. Connect your Android-powered device to your computer's USB port.
    2. +
  2. Right-click on Computer from your desktop or Windows Explorer, + and select Manage.
    3. +
  3. Select Device Manager in the left pane of the Computer Management + window.
    4. +
  4. Locate and expand Android Phone in the right pane.
    5. +
  5. Right-click Android Composite ADB Interface and select Update + Driver. + This will launch the Hardware Update Wizard.
    6. +
  6. Select Install from a list or specific location and click + Next.
    7. +
  7. Select Search for the best driver in these locations; un-check +Search removable media; and check Include this location in the +search.
    8. +
  8. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    9. +
  9. Click Next to upgrade the driver.
    10. +
+ + + + + +

Windows XP

+ +

To install the Android USB driver on Windows XP for the first time:

+ +
    +
  1. Connect your Android-powered device to your computer's USB port. Windows + will detect the device and launch the Hardware Update Wizard.
    2. +
  2. Select Install from a list or specific location and click + Next.
    3. +
  3. Select Search for the best driver in these locations; un-check +Search + removable media; and check Include +this location in the search.
    4. +
  4. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    5. +
  5. Click Next to install the driver.
    6. +
+ +

Or, to upgrade an existing Android USB driver on Windows XP with the new +driver:

+ +
    +
  1. Connect your Android-powered device to your computer's USB port.
    2. +
  2. Right-click on My Computer from your desktop or Windows Explorer, + and select Manage.
    3. +
  3. Select Device Manager in the left pane.
    4. +
  4. Locate and expand Android Phone in the right pane.
    5. +
  5. Right-click Android Composite ADB Interface and select Update + Driver. + This will launch the Hardware Update Wizard.
    6. +
  6. Select Install from a list or specific location and click + Next.
    7. +
  7. Select Search for the best driver in these locations; un-check Search + removable media; and check Include +this location in the search.
    8. +
  8. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    9. +
  9. Click Next to upgrade the driver.
    10. +
+ + + +

Windows Vista

+ +

To install the Android USB driver on Windows Vista for the first time:

+ +
    +
  1. Connect your Android-powered device to your computer's USB port. Windows + will detect the device and launch the Found New Hardware wizard.
    2. +
  2. Select Locate and install driver software.
    3. +
  3. Select Don't search online.
    4. +
  4. Select I don't have the disk. Show me other options.
    5. +
  5. Select Browse my computer for driver software.
    6. +
  6. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\extras\google\usb_driver\}.) As long as you specified the +exact location of the + installation package, you may leave Include subfolders checked or + unchecked—it doesn't matter.
    7. +
  7. Click Next. Vista may prompt you to confirm the privilege elevation + required for driver installation. Confirm it.
    8. +
  8. When Vista asks if you'd like to install the Google ADB Interface device, + click Install to install the driver.
    9. +
+ +

Or, to upgrade an existing Android USB driver on Windows Vista with the new +driver:

+ +
    +
  1. Connect your Android-powered device to your computer's USB port.
    2. +
  2. Right-click on Computer from your desktop or Windows Explorer, + and select Manage.
    3. +
  3. Select Device Manager in the left pane.
    4. +
  4. Locate and expand ADB Interface in the right pane.
    5. +
  5. Right-click on HTC Dream Composite ADB Interface, and select Update + Driver Software.
    6. +
  6. When Vista starts updating the driver, a prompt will ask how you want to + search for the driver + software. Select Browse my computer for driver software.
    7. +
  7. Click Browse and locate the USB driver folder. (The Google USB +Driver is located in {@code <sdk>\extras\google\usb_driver\}.) As long as you specified the +exact location of the + installation package, you may leave Include subfolders checked or + unchecked—it doesn't matter.
    8. +
  8. Click Next. Vista might prompt you to confirm the privilege elevation + required for driver installation. Confirm it.
    9. +
  9. When Vista asks if you'd like to install the Google ADB Interface device, + click Install to upgrade the driver.
    10. +
+ + +

OEM Drivers

Note: If your device is one of the Android Developer Phones (purchased from the Android Market publisher site), a Nexus One, or a Nexus S, then you need @@ -28,10 +217,7 @@ Nexus driver, however, is distributed by Samsung (listed as model SCH-I515).

-

For instructions about how to install the driver on Windows, follow the guide for Installing the USB Driver.

-

Table 1. Links to OEM USB drivers

@@ -92,7 +278,7 @@ href="http://www.huaweidevice.com/worldwide/downloadCenter.do?method=index">http +href="http://www.kttech.co.kr/cscenter/download05.asp">http://www.kttech.co.kr/cscenter/download05.asp for EV-S100 (Take)
OEM Driver URL
KT Tech http://www.kttech.co.kr/cscenter/download05.asp for EV-S100(Take)
diff --git a/docs/html/sdk/win-usb.jd b/docs/html/sdk/win-usb.jd index 2d1435b8d4b5f..2bd031ebb8b36 100644 --- a/docs/html/sdk/win-usb.jd +++ b/docs/html/sdk/win-usb.jd @@ -7,19 +7,12 @@ page.title=Google USB Driver
  1. Revisions
  2. Downloading the Google USB Driver
    3. -
  3. Installing the USB Driver -
      -
    1. Windows 7
      2. -
    2. Windows XP
      3. -
    3. Windows Vista
      4. -
    -

See also

    -
  1. Developing on a Device
    2. +
  2. Installing a USB Driver
    3. +
  3. Using Hardware Devices
  4. Adding SDK Components
    5. -
  5. OEM USB Drivers
@@ -43,9 +36,9 @@ href="http://www.samsung.com/us/support/downloads/verizon-wireless/SCH-I515MSAVZ (listed as model SCH-I515).

Note: -If you're developing on Mac OS X or Linux, then you do not need to install a USB driver. Refer to Setting up a Device to start -development with a device.

+If you're developing on Mac OS X or Linux, then you do not need to install a USB driver. To start +developing with your device, also read Using +Hardware Devices.

The sections below provide instructions on how to download and install the Google USB Driver for Windows.

@@ -170,174 +163,10 @@ included with the Android SDK:

  1. Launch the SDK and AVD Manager by double-clicking SDK Manager.exe, at the root of your SDK directory.
    2. -
  2. Expand the Third party Add-ons and Google Inc. add-ons.
    3. -
  3. Check Google Usb Driver package and click Install selected.
    4. +
  4. Expand Extras.
    5. +
  5. Check Google USB Driver package and click Install.
  6. Proceed to install the package. When done, the driver files are downloaded into the <sdk>\extras\google\usb_driver\ directory.
- - -

Installing the USB Driver

- -

Once you've downloaded your USB driver, follow the instructions below to install or upgrade the -driver, based on your version of Windows and whether you're installing for the first time -or upgrading an existing driver.

- -

Tip: When you finish the USB driver installation, -see Developing on a Device for -other important information about using an Android-powered device for -development.

- -
    -
  1. Windows 7
    2. -
  2. Windows XP
    3. -
  3. Windows Vista
    4. -
- - -

Caution: -You may make changes to android_winusb.inf file found inside -usb_driver\ (for example, to add support for other devices), -however, this will lead to security warnings when you install or upgrade the -driver. Making any other changes to the driver files may break the installation -process.

- - -

Windows 7

- - -

To install the Android USB driver on Windows 7 for the first time:

-
    -
  1. Connect your Android-powered device to your computer's USB port.
    2. -
  2. Right-click on Computer from your desktop or Windows Explorer, - and select Manage.
    3. -
  3. Select Devices in the left pane.
    4. -
  4. Locate and expand Other device in the right pane.
    5. -
  5. Right-click the device name (such as Nexus S) and select Update - Driver Software. - This will launch the Hardware Update Wizard.
    6. -
  6. Select Browse my computer for driver software and click - Next.
    7. -
  7. Click Browse and locate the USB driver folder. (The Google USB -Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    8. -
  8. Click Next to install the driver.
    9. -
- -

Or, to upgrade an existing Android USB driver on Windows 7 with the new -driver:

- -
    -
  1. Connect your Android-powered device to your computer's USB port.
    2. -
  2. Right-click on Computer from your desktop or Windows Explorer, - and select Manage.
    3. -
  3. Select Device Manager in the left pane of the Computer Management - window.
    4. -
  4. Locate and expand Android Phone in the right pane.
    5. -
  5. Right-click Android Composite ADB Interface and select Update - Driver. - This will launch the Hardware Update Wizard.
    6. -
  6. Select Install from a list or specific location and click - Next.
    7. -
  7. Select Search for the best driver in these locations; un-check -Search removable media; and check Include this location in the -search.
    8. -
  8. Click Browse and locate the USB driver folder. (The Google USB -Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    9. -
  9. Click Next to upgrade the driver.
    10. -
- - - - - -

Windows XP

- -

To install the Android USB driver on Windows XP for the first time:

- -
    -
  1. Connect your Android-powered device to your computer's USB port. Windows - will detect the device and launch the Hardware Update Wizard.
    2. -
  2. Select Install from a list or specific location and click - Next.
    3. -
  3. Select Search for the best driver in these locations; un-check -Search - removable media; and check Include -this location in the search.
    4. -
  4. Click Browse and locate the USB driver folder. (The Google USB -Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    5. -
  5. Click Next to install the driver.
    6. -
- -

Or, to upgrade an existing Android USB driver on Windows XP with the new -driver:

- -
    -
  1. Connect your Android-powered device to your computer's USB port.
    2. -
  2. Right-click on My Computer from your desktop or Windows Explorer, - and select Manage.
    3. -
  3. Select Device Manager in the left pane.
    4. -
  4. Locate and expand Android Phone in the right pane.
    5. -
  5. Right-click Android Composite ADB Interface and select Update - Driver. - This will launch the Hardware Update Wizard.
    6. -
  6. Select Install from a list or specific location and click - Next.
    7. -
  7. Select Search for the best driver in these locations; un-check Search - removable media; and check Include -this location in the search.
    8. -
  8. Click Browse and locate the USB driver folder. (The Google USB -Driver is located in {@code <sdk>\extras\google\usb_driver\}.)
    9. -
  9. Click Next to upgrade the driver.
    10. -
- - - -

Windows Vista

- -

To install the Android USB driver on Windows Vista for the first time:

- -
    -
  1. Connect your Android-powered device to your computer's USB port. Windows - will detect the device and launch the Found New Hardware wizard.
    2. -
  2. Select Locate and install driver software.
    3. -
  3. Select Don't search online.
    4. -
  4. Select I don't have the disk. Show me other options.
    5. -
  5. Select Browse my computer for driver software.
    6. -
  6. Click Browse and locate the USB driver folder. (The Google USB -Driver is located in {@code <sdk>\extras\google\usb_driver\}.) As long as you specified the -exact location of the - installation package, you may leave Include subfolders checked or - unchecked—it doesn't matter.
    7. -
  7. Click Next. Vista may prompt you to confirm the privilege elevation - required for driver installation. Confirm it.
    8. -
  8. When Vista asks if you'd like to install the Google ADB Interface device, - click Install to install the driver.
    9. -
- -

Or, to upgrade an existing Android USB driver on Windows Vista with the new -driver:

- -
    -
  1. Connect your Android-powered device to your computer's USB port.
    2. -
  2. Right-click on Computer from your desktop or Windows Explorer, - and select Manage.
    3. -
  3. Select Device Manager in the left pane.
    4. -
  4. Locate and expand ADB Interface in the right pane.
    5. -
  5. Right-click on HTC Dream Composite ADB Interface, and select Update - Driver Software.
    6. -
  6. When Vista starts updating the driver, a prompt will ask how you want to - search for the driver - software. Select Browse my computer for driver software.
    7. -
  7. Click Browse and locate the USB driver folder. (The Google USB -Driver is located in {@code <sdk>\extras\google\usb_driver\}.) As long as you specified the -exact location of the - installation package, you may leave Include subfolders checked or - unchecked—it doesn't matter.
    8. -
  8. Click Next. Vista might prompt you to confirm the privilege elevation - required for driver installation. Confirm it.
    9. -
  9. When Vista asks if you'd like to install the Google ADB Interface device, - click Install to upgrade the driver.
    10. -
- +

For installation information, read Installing a USB Driver.