Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 1 | page.title=Setting Up Hardware and AVDs |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 2 | @jd:body |
| 3 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 4 | <p>The Android L developer preview provides you with 32-bit system images |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 5 | to 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 |
| 14 | experimental 64-bit system images along with standard 32-bit system images. |
| 15 | </p> |
| 16 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 17 | <h2>Installing the L Preview System Image</h2> |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 18 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 19 | <!-- Will we get an official warning text from the lawyercats? Is this it? --> |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 20 | <p class="warning"><b>Warning</b>: This is a preview version of the Android |
| 21 | system image, and is subject to change. Your use of this system image is |
| 22 | governed by the Android SDK Preview License Agreement. The Android preview |
| 23 | system image is not a stable release, and may contain errors and defects that |
| 24 | can result in damage to your computer systems, devices, and data. The preview |
| 25 | Android system image is not subject to the same testing as the factory OS and |
| 26 | can cause your phone and installed services and applications to stop working. |
| 27 | </p> |
| 28 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 29 | <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 |
| 32 | Preview Terms of Service</a> |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 33 | </p> |
| 34 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 35 | |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 36 | <ol> |
| 37 | <li>Download and extract the Android Developer Preview package to a directory |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 38 | (which we'll call <code><l_download_dir></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 Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 42 | <ul> |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 43 | <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 Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 46 | </ul> |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 47 | <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 Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 50 | </li> |
| 51 | <li>Follow the instructions at |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 52 | <a href="https://developers.google.com/android/nexus/images#instructions">developers.google.com/android</a> |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 53 | to set up your system for flashing devices.</li> |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 54 | <li>Run the <code><l_download_dir>/flash-all</code> script |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 55 | corresponding to your platform. This script flashes all of the system data |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 56 | 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 Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 62 | bootloader unlocked until you are done with flashing the device.</li> |
| 63 | </ol> |
| 64 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 65 | <h3>Reverting a Device to Factory Specifications</h3> |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 66 | |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 67 | <p>If you want to uninstall the L Preview and revert the device to factory |
| 68 | specifications, go to <a href="http://developers.google.com/android |
| 69 | /nexus/images">developers.google.com/android</a> and download the image you want |
| 70 | to flash to for your device. Follow the instructions on that page to flash the |
| 71 | image to your device.</p> |
Robert Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 72 | |
| 73 | |
| 74 | <h2>Setting up an AVD</h2> |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 75 | |
| 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 Ly | 2055529 | 2014-06-13 23:28:19 -0700 | [diff] [blame] | 80 | |
| 81 | <ol> |
Robert Ly | b8cabe9 | 2014-06-15 13:04:43 -0700 | [diff] [blame^] | 82 | <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 | |