Skip to content

Commit 2a1d191

Browse files
scottamainAndroid (Google) Code Review
scottamain
authored and
Android (Google) Code Review
committed
Merge "docs: move USB installation info into the OEM USB Drivers document because the Google USB Driver is deprecated, so consolidating the USB info makes more sense for the common case of needing an OEM driver A few changes to the device setup doc also; such as removing the "unknown sources" step, because that doesn't apply to adb installs." into ics-mr1
2 parents 2670332 + 811aca5 commit 2a1d191

File tree

3 files changed

+212
-206
lines changed

3 files changed

+212
-206
lines changed

‎docs/html/guide/developing/device.jd‎

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -51,19 +51,13 @@ would on the emulator. Before you can start, there are just a few things to do:<
5151

5252
<ol>
5353
<li>Declare your application as "debuggable" in your Android Manifest.
54-
<p>In Eclipse, you can do this from the <b>Application</b> tab when viewing the Manifest
55-
(on the right side, set <b>Debuggable</b> to <em>true</em>). Otherwise, in the
56-
<code>AndroidManifest.xml</code>
57-
file, add <code>android:debuggable="true"</code> to the <code>&lt;application></code>
58-
element.</p>
59-
</li>
60-
<li>Set up your device to allow installation of non-Market applications. <p>On
61-
the device, go to <strong>Settings > Applications</strong> and enable
62-
63-
<strong>Unknown sources</strong> (on an Android 4.0 device, the setting is
64-
located in <strong>Settings > Security</strong>).</p>
65-
66-
</li>
54+
<p>When using Eclipse, you can skip this step, because running your app directly from
55+
the Eclipse IDE automatically enables debugging.</p>
56+
<p>In the <code>AndroidManifest.xml</code> file, add <code>android:debuggable="true"</code> to
57+
the <code>&lt;application></code> element.</p>
58+
<p class="note"><strong>Note:</strong> If you manually enable debugging in the manifest
59+
file, be sure to disable it before you build for release (your published application
60+
should usually <em>not</em> be debuggable).</p></li>
6761
<li>Turn on "USB Debugging" on your device.
6862
<p>On the device, go to <strong>Settings > Applications > Development</strong>
6963
and enable <strong>USB debugging</strong>
@@ -72,13 +66,10 @@ located in <strong>Settings > Developer options</strong>).</p>
7266
</li>
7367
<li>Set up your system to detect your device.
7468
<ul>
75-
<li>If you're developing on Windows, you need to install a USB driver
76-
for adb. If you're using an Android Developer Phone (ADP), Nexus One, or Nexus S,
77-
see the <a href="{@docRoot}sdk/win-usb.html">Google Windows USB
78-
Driver</a>. Otherwise, you can find a link to the appropriate OEM driver in the
79-
<a href="{@docRoot}sdk/oem-usb.html">OEM USB Drivers</a> document.</li>
69+
<li>If you're developing on Windows, you need to install a USB driver for adb. For an
70+
installation guide and links to OEM drivers, see the <a href="{@docRoot}sdk/oem-usb.html">OEM USB
71+
Drivers</a> document.</li>
8072
<li>If you're developing on Mac OS X, it just works. Skip this step.</li>
81-
8273
<li>If you're developing on Ubuntu Linux, you need to add a
8374
<code>udev</code> rules file that contains a USB configuration for each type of device
8475
you want to use for development. In the rules file, each device manufacturer
@@ -114,7 +105,7 @@ rules</a>.</p>
114105
</li>
115106
</ol>
116107

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

‎docs/html/sdk/oem-usb.jd‎

Lines changed: 193 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,21 @@ page.title=OEM USB Drivers
33

44
<div id="qv-wrapper">
55
<div id="qv">
6+
<h2>In this document</h2>
7+
<ol>
8+
<li><a href="#InstallingDriver">Installing a USB Driver</a>
9+
<ol>
10+
<li><a href="#Win7">Windows 7</a></li>
11+
<li><a href="#WinXp">Windows XP</a></li>
12+
<li><a href="#WinVista">Windows Vista</a></li>
13+
</ol>
14+
</li>
15+
<li><a href="#Drivers">OEM Drivers</a></li>
16+
</ol>
17+
618
<h2>See also</h2>
719
<ol>
8-
<li><a href="{@docRoot}guide/developing/device.html">Developing on a Device</a></li>
20+
<li><a href="{@docRoot}guide/developing/device.html">Using Hardware Devices</a></li>
921
<li><a href="{@docRoot}sdk/win-usb.html">Google USB Driver</a></li>
1022
</ol>
1123
</div>
@@ -18,8 +30,185 @@ where you can download the appropriate USB driver for your device. However, this
1830
not exhaustive for all available Android-powered devices.</p>
1931

2032
<p>If you're developing on Mac OS X or Linux, then you probably don't need to install a USB driver.
21-
Refer to <a href="{@docRoot}guide/developing/device.html#setting-up">Setting up a Device</a> to
22-
start development with a device.</p>
33+
To start developing with your device, read <a
34+
href="{@docRoot}guide/developing/device.html">Using Hardware Devices</a>.</p>
35+
36+
<p class="note"><strong>Note:</strong> If your device is one of the Android Developer Phones
37+
(purchased from the Android Market publisher site), a Nexus One, or a Nexus S, then you need
38+
the <a href="{@docRoot}sdk/win-usb.html">Google USB Driver</a>, instead of an OEM driver. The Galaxy
39+
Nexus driver, however, is distributed by <a
40+
href="http://www.samsung.com/us/support/downloads/verizon-wireless/SCH-I515MSAVZW">Samsung</a>
41+
(listed as model SCH-I515).</p>
42+
43+
44+
<h2 id="InstallingDriver">Installing a USB Driver</h2>
45+
46+
<p>First, find the appropriate driver for your device from the <a href="#Drivers">OEM drivers</a>
47+
table below.</p>
48+
49+
<p>Once you've downloaded your USB driver, follow the instructions below to install or upgrade the
50+
driver, based on your version of Windows and whether you're installing for the first time
51+
or upgrading an existing driver.</p>
52+
53+
<p class="note"><strong>Tip:</strong> When you finish the USB driver installation,
54+
see <a
55+
href="{@docRoot}guide/developing/device.html">Using Hardware Devices</a> for
56+
other important information about using an Android-powered device for
57+
development.</p>
58+
59+
<ol class="nolist">
60+
<li><a href="#Win7">Windows 7</a></li>
61+
<li><a href="#WinXp">Windows XP</a></li>
62+
<li><a href="#WinVista">Windows Vista</a></li>
63+
</ol>
64+
65+
66+
<p class="caution"><strong>Caution:</strong>
67+
You may make changes to <code>android_winusb.inf</code> file found inside
68+
<code>usb_driver\</code> (for example, to add support for other devices),
69+
however, this will lead to security warnings when you install or upgrade the
70+
driver. Making any other changes to the driver files may break the installation
71+
process.</p>
72+
73+
74+
<h3 id="Win7">Windows 7</h3>
75+
76+
77+
<p>To install the Android USB driver on Windows 7 for the first time:</p>
78+
<ol>
79+
<li>Connect your Android-powered device to your computer's USB port.</li>
80+
<li>Right-click on <em>Computer</em> from your desktop or Windows Explorer,
81+
and select <strong>Manage</strong>.</li>
82+
<li>Select <strong>Devices</strong> in the left pane.</li>
83+
<li>Locate and expand <em>Other device</em> in the right pane.</li>
84+
<li>Right-click the device name (such as <em>Nexus S</em>) and select <strong>Update
85+
Driver Software</strong>.
86+
This will launch the Hardware Update Wizard.</li>
87+
<li>Select <strong>Browse my computer for driver software</strong> and click
88+
<strong>Next</strong>.</li>
89+
<li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
90+
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
91+
<li>Click <strong>Next</strong> to install the driver.</li>
92+
</ol>
93+
94+
<p>Or, to <em>upgrade</em> an existing Android USB driver on Windows 7 with the new
95+
driver:</p>
96+
97+
<ol>
98+
<li>Connect your Android-powered device to your computer's USB port.</li>
99+
<li>Right-click on <em>Computer</em> from your desktop or Windows Explorer,
100+
and select <strong>Manage</strong>.</li>
101+
<li>Select <strong>Device Manager</strong> in the left pane of the Computer Management
102+
window.</li>
103+
<li>Locate and expand <em>Android Phone</em> in the right pane.</li>
104+
<li>Right-click <em>Android Composite ADB Interface</em> and select <strong>Update
105+
Driver</strong>.
106+
This will launch the Hardware Update Wizard.</li>
107+
<li>Select <strong>Install from a list or specific location</strong> and click
108+
<strong>Next</strong>.</li>
109+
<li>Select <strong>Search for the best driver in these locations</strong>; un-check
110+
<strong>Search removable media</strong>; and check <strong>Include this location in the
111+
search</strong>.</li>
112+
<li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
113+
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
114+
<li>Click <strong>Next</strong> to upgrade the driver.</li>
115+
</ol>
116+
117+
118+
119+
120+
121+
<h3 id="WinXp">Windows XP</h3>
122+
123+
<p>To install the Android USB driver on Windows XP for the first time:</p>
124+
125+
<ol>
126+
<li>Connect your Android-powered device to your computer's USB port. Windows
127+
will detect the device and launch the Hardware Update Wizard.</li>
128+
<li>Select <strong>Install from a list or specific location</strong> and click
129+
<strong>Next</strong>.</li>
130+
<li>Select <strong>Search for the best driver in these locations</strong>; un-check
131+
<strong>Search
132+
removable media</strong>; and check <strong>Include
133+
this location in the search</strong>.</li>
134+
<li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
135+
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
136+
<li>Click <strong>Next</strong> to install the driver.</li>
137+
</ol>
138+
139+
<p>Or, to <em>upgrade</em> an existing Android USB driver on Windows XP with the new
140+
driver:</p>
141+
142+
<ol>
143+
<li>Connect your Android-powered device to your computer's USB port.</li>
144+
<li>Right-click on <em>My Computer</em> from your desktop or Windows Explorer,
145+
and select <strong>Manage</strong>.</li>
146+
<li>Select <strong>Device Manager</strong> in the left pane.</li>
147+
<li>Locate and expand <em>Android Phone</em> in the right pane.</li>
148+
<li>Right-click <em>Android Composite ADB Interface</em> and select <strong>Update
149+
Driver</strong>.
150+
This will launch the Hardware Update Wizard.</li>
151+
<li>Select <strong>Install from a list or specific location</strong> and click
152+
<strong>Next</strong>.</li>
153+
<li>Select <strong>Search for the best driver in these locations</strong>; un-check <strong>Search
154+
removable media</strong>; and check <strong>Include
155+
this location in the search</strong>.</li>
156+
<li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
157+
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.)</li>
158+
<li>Click <strong>Next</strong> to upgrade the driver.</li>
159+
</ol>
160+
161+
162+
163+
<h3 id="WinVista">Windows Vista</h3>
164+
165+
<p>To install the Android USB driver on Windows Vista for the first time:</p>
166+
167+
<ol>
168+
<li>Connect your Android-powered device to your computer's USB port. Windows
169+
will detect the device and launch the Found New Hardware wizard.</li>
170+
<li>Select <strong>Locate and install driver software</strong>.</li>
171+
<li>Select <strong>Don't search online</strong>.</li>
172+
<li>Select <strong>I don't have the disk. Show me other options</strong>.</li>
173+
<li>Select <strong>Browse my computer for driver software</strong>.</li>
174+
<li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
175+
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.) As long as you specified the
176+
exact location of the
177+
installation package, you may leave <strong>Include subfolders</strong> checked or
178+
unchecked&mdash;it doesn't matter.</li>
179+
<li>Click <strong>Next</strong>. Vista may prompt you to confirm the privilege elevation
180+
required for driver installation. Confirm it.</li>
181+
<li>When Vista asks if you'd like to install the Google ADB Interface device,
182+
click <strong>Install</strong> to install the driver.</li>
183+
</ol>
184+
185+
<p>Or, to <em>upgrade</em> an existing Android USB driver on Windows Vista with the new
186+
driver:</p>
187+
188+
<ol>
189+
<li>Connect your Android-powered device to your computer's USB port.</li>
190+
<li>Right-click on <em>Computer</em> from your desktop or Windows Explorer,
191+
and select <strong>Manage</strong>.</li>
192+
<li>Select <strong>Device Manager</strong> in the left pane.</li>
193+
<li>Locate and expand <em>ADB Interface</em> in the right pane.</li>
194+
<li>Right-click on <em>HTC Dream Composite ADB Interface</em>, and select <strong>Update
195+
Driver Software</strong>.</li>
196+
<li>When Vista starts updating the driver, a prompt will ask how you want to
197+
search for the driver
198+
software. Select <strong>Browse my computer for driver software</strong>.</li>
199+
<li>Click <strong>Browse</strong> and locate the USB driver folder. (The Google USB
200+
Driver is located in {@code &lt;sdk&gt;\extras\google\usb_driver\}.) As long as you specified the
201+
exact location of the
202+
installation package, you may leave <strong>Include subfolders</strong> checked or
203+
unchecked&mdash;it doesn't matter.</li>
204+
<li>Click <strong>Next</strong>. Vista might prompt you to confirm the privilege elevation
205+
required for driver installation. Confirm it.</li>
206+
<li>When Vista asks if you'd like to install the Google ADB Interface device,
207+
click <strong>Install</strong> to upgrade the driver.</li>
208+
</ol>
209+
210+
211+
<h2 id="Drivers">OEM Drivers</h2>
23212

24213
<p class="note"><strong>Note:</strong> If your device is one of the Android Developer Phones
25214
(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 <a
28217
href="http://www.samsung.com/us/support/downloads/verizon-wireless/SCH-I515MSAVZW">Samsung</a>
29218
(listed as model SCH-I515).</p>
30219

31-
<p>For instructions about how to install the driver on Windows, follow the guide for <a
32-
href="{@docRoot}sdk/win-usb.html#InstallingDriver">Installing the USB Driver</a>.</p>
33220

34-
<p class="table-caption"><strong>Table 1.</strong> Links to OEM USB drivers</p>
35221
<table><tr>
36222
<th>OEM</th>
37223
<th>Driver URL</th></tr>
@@ -92,7 +278,7 @@ href="http://www.huaweidevice.com/worldwide/downloadCenter.do?method=index">http
92278
</tr>
93279

94280
<tr><td>KT Tech</td> <td><a
95-
href="http://www.kttech.co.kr/cscenter/download05.asp">http://www.kttech.co.kr/cscenter/download05.asp</a> for EV-S100(Take)</td>
281+
href="http://www.kttech.co.kr/cscenter/download05.asp">http://www.kttech.co.kr/cscenter/download05.asp</a> for EV-S100 (Take)</td>
96282
</tr>
97283
<tr>
98284
<td>

0 commit comments

Comments
 (0)