blob: 065468503411b8bef07bd72923bb9ad305451441 [file] [log] [blame]
Robert Ly20555292014-06-13 23:28:19 -07001page.title=Setting Up Hardware and AVDs
Robert Ly20555292014-06-13 23:28:19 -07002@jd:body
3
Robert Lyb8cabe92014-06-15 13:04:43 -07004<p>The Android L developer preview provides you with 32-bit system images
Robert Ly20555292014-06-13 23:28:19 -07005to flash the following devices:
6</p>
7
8<ul>
9 <li>Nexus 5</li>
10 <li>Nexus 7 Wi-Fi (version 2, released in 2013)</li>
11</ul>
12
13<p>In addition, you also get the emulator system images, which includes
14experimental 64-bit system images along with standard 32-bit system images.
15</p>
16
Robert Lyb8cabe92014-06-15 13:04:43 -070017<h2>Installing the L Preview System Image</h2>
Robert Ly20555292014-06-13 23:28:19 -070018
Robert Lyb8cabe92014-06-15 13:04:43 -070019<!-- Will we get an official warning text from the lawyercats? Is this it? -->
Robert Ly20555292014-06-13 23:28:19 -070020<p class="warning"><b>Warning</b>: This is a preview version of the Android
21system image, and is subject to change. Your use of this system image is
22governed by the Android SDK Preview License Agreement. The Android preview
23system image is not a stable release, and may contain errors and defects that
24can result in damage to your computer systems, devices, and data. The preview
25Android system image is not subject to the same testing as the factory OS and
26can cause your phone and installed services and applications to stop working.
27</p>
28
Robert Lyb8cabe92014-06-15 13:04:43 -070029<p><!-- Will this link change before we publish (to a clean version of the doc)?
30 Or will we scrub the doc's comments & revision history? -->
31<a href="https://docs.google.com/a/google.com/document/d/1OixnM1Q890ExOzDB3Z-FDD6Sb2kF4uZQiMxsYVII8F0/edit?usp=sharing">L
32Preview Terms of Service</a>
Robert Ly20555292014-06-13 23:28:19 -070033</p>
34
Robert Lyb8cabe92014-06-15 13:04:43 -070035
Robert Ly20555292014-06-13 23:28:19 -070036<ol>
37 <li>Download and extract the Android Developer Preview package to a directory
Robert Lyb8cabe92014-06-15 13:04:43 -070038 (which we'll call <code>&lt;l_download_dir&gt;</code> in these
39 instructions).</li>
40 <li>Connect your powered-off Android device to your development machine. Put
41 the device in fastboot mode by pressing and holding the following buttons:
Robert Ly20555292014-06-13 23:28:19 -070042 <ul>
Robert Lyb8cabe92014-06-15 13:04:43 -070043 <li><strong>Nexus 5:</strong> <i>volume down</i> + <i>volume up</i> +
44 <i>power</i></li>
45 <li><strong>Nexus 7:</strong> <i>volume down</i> + <i>power</i> </li>
Robert Ly20555292014-06-13 23:28:19 -070046 </ul>
Robert Lyb8cabe92014-06-15 13:04:43 -070047 <p class="note">Alternatively, you can enter fastboot mode by booting up
48 the device and running <code>adb reboot bootloader</code> with USB debugging
49 turned on.</p>
Robert Ly20555292014-06-13 23:28:19 -070050 </li>
51 <li>Follow the instructions at
Robert Lyb8cabe92014-06-15 13:04:43 -070052 <a href="https://developers.google.com/android/nexus/images#instructions">developers.google.com/android</a>
Robert Ly20555292014-06-13 23:28:19 -070053 to set up your system for flashing devices.</li>
Robert Lyb8cabe92014-06-15 13:04:43 -070054 <li>Run the <code>&lt;l_download_dir&gt;/flash-all</code> script
Robert Ly20555292014-06-13 23:28:19 -070055 corresponding to your platform. This script flashes all of the system data
Robert Lyb8cabe92014-06-15 13:04:43 -070056 onto the phone.</li> <!-- Confirm names of flash scripts -->
57 <li>(Optional) After flashing is complete, lock your device's bootloader by
58 putting it in fastboot mode and running <code>fastboot oem lock</code>.
59 (This does not wipe your device.) Once you do this, you will not be able to
60 flash your device until you run run <code>fastboot oem unlock</code>,
61 which unlocks the bootloader and wipes your device. We recommend you leave the
Robert Ly20555292014-06-13 23:28:19 -070062 bootloader unlocked until you are done with flashing the device.</li>
63</ol>
64
Robert Lyb8cabe92014-06-15 13:04:43 -070065<h3>Reverting a Device to Factory Specifications</h3>
Robert Ly20555292014-06-13 23:28:19 -070066
Robert Lyb8cabe92014-06-15 13:04:43 -070067 <p>If you want to uninstall the L Preview and revert the device to factory
68specifications, go to <a href="http://developers.google.com/android
69/nexus/images">developers.google.com/android</a> and download the image you want
70to flash to for your device. Follow the instructions on that page to flash the
71image to your device.</p>
Robert Ly20555292014-06-13 23:28:19 -070072
73
74<h2>Setting up an AVD</h2>
Robert Lyb8cabe92014-06-15 13:04:43 -070075
76<p>You can set up <a href="{@docRoot}tools/devices/">Android Virtual Devices
77(AVD)</a> and use the emulator to build and test apps with the L Preview.</p>
78
79<p>To create an AVD with the AVD Manager:</p>
Robert Ly20555292014-06-13 23:28:19 -070080
81<ol>
Robert Lyb8cabe92014-06-15 13:04:43 -070082 <li>Install the L Preview SDK in your development environment, as described
83 in <a href="{@docRoot}preview/setup-sdk.html">Setting Up the Preview
84 SDK.</a></li>
85 <li>Follow the steps in
86 <a href="{@docRoot}tools/devices/managing-avds.html">Managing AVDs with AVD
87 Manager</a>. Use the following settings:
88 <ul>
89 <li><b>Device:</b> Either Nexus 5 or Nexus 7</li>
90 <li><b>Target:</b> <!-- Confirm exact text when we have final distro -->
91 Android L (Preview) - API Level L</li>
92 </ul>
93 <!-- Confirm this works when you can download image through SDK manager! -->
94 </li>
95</ol>
96