docs/html/preview/setup-sdk.jd

page.title=Setting Up the Preview SDK
@jd:body

<p>The Preview SDK is available from the Android SDK Manager. <!-- Not yet! -->
This document assumes that you are familiar with Android app development, such
as using the Android SDK Manager and creating projects. If you're new to
Android, see <a href="/training/basics/firstapp/index.html">Building Your First
App</a> training lesson first.</a></p>

<h2 id="downloadSdk">Download the SDK</h2>

<ol>
  <li>Start the Android SDK Manager.</li>
  <li>In the <b>Tools</b> section, select the latest Android <b>SDK Tools</b>,
    <b>Platform-tools</b>, and <b>Build-tools</b>.</li>
    <!-- Android L not yet showing up in Android SDK Manager...  -->
  <li>Select everything under the <b>Android L Developer Preview</b> section and
    click <b>Install packages...</b></li>
  <li>Accept the Licensing Agreement for all of the packages and click
    <b>Install</b>.</li>
</ol>

<h2 id="setupHardware">Set Up Hardware and AVDs</h2>

<p>The Android L developer preview provides you with 32-bit system images
to flash the following devices:
</p>

<ul>
  <li>Nexus 5</li>
  <li>Nexus 7 Wi-Fi (version 2, released in 2013)</li>
</ul>

<p>In addition, you also get the emulator system images, which includes
experimental 64-bit system images along with standard 32-bit system images.
</p>

<h3 id="installImage">Install the L Preview System Image</h3>

<p class="warning"><b>Warning:</b> This is a preview version of the Android
system image, and is subject to change. Your use of this system image is
governed by the Android SDK Preview License Agreement. The Android preview
system image is not a stable release, and may contain errors and defects that
can result in damage to your computer systems, devices, and data. The preview
Android system image is not subject to the same testing as the factory OS and
can cause your phone and installed services and applications to stop working.
</p>


<ol>
  <li>Download and uncompress the Android Developer Preview package.
    <p class="table-caption" id="table1">
      <strong>Table 1.</strong> L Developer Preview system images.</p>
    <table>
      <tr>
        <th scope="col">Device</th>
        <th scope="col">Download</th>
        <th scope="col">MD5 Checksum</th>
        <th scope="col">SHA-1 Checksum</th>
      </tr>
      <tr id="hammerhead">
        <td>Nexus 5 (GSM/LTE) "hammerhead"</td>
        <td><!-- TODO --></td>
        <td><code>5a6ae77217978cb7b958a240c2e80b57</code></td>
        <td><code>ac1d8a8e4f4a1dca5864dc733caa940bffc28616</code></td>
      </tr>
      <tr id="razor">
        <td>Nexus 7 (Wifi) "razor"</td>
        <td><!-- TODO --></td>
        <td><code>b293a5d3a4e07beabebcc0be85ad68a2</code></td>
        <td><code>d0ddf8ce733ba2a34279cdff8827fd604762c2342d</code></td>
      </tr>
    </table>
  </li>

  <li>Follow the instructions at
  <a href="https://developers.google.com/android/nexus/images#instructions">developers.google.com/android</a>
  to flash the image onto your device.</li>
</ol>

<h3 id="revertDevice">Revert a Device to Factory Specifications</h3>

  <p>If you want to uninstall the L Preview and revert the device to factory
specifications, go to <a href="http://developers.google.com/android
/nexus/images">developers.google.com/android</a> and download the image you want
to flash to for your device. Follow the instructions on that page to flash the
image to your device.</p>

<h3 id="setupAVD">Set up an AVD</h3>

<p>You can set up <a href="{@docRoot}tools/devices/">Android Virtual Devices
(AVD)</a> and use the emulator to build and test apps with the L Preview.</p>

<p>To create an AVD with the AVD Manager:</p>

<ol>
  <li>Install the L Preview SDK in your development environment, as described
      in <a href="{@docRoot}preview/setup-sdk.html">Setting Up the Preview
      SDK.</a></li>
  <li>Follow the steps in
      <a href="{@docRoot}tools/devices/managing-avds.html">Managing AVDs with AVD
      Manager</a>. Use the following settings:
    <ul>
      <li><b>Device:</b> Either Nexus 5 or Nexus 7</li>
      <li><b>Target:</b> <!-- Confirm exact text when we have final distro -->
       Android L (Preview) - API Level L</li>
    </ul>
    <!-- Confirm this works when you can download image through SDK manager! -->
  </li>
</ol>

<h2 id="createProject">Create a Project</h2>

<p>Android Studio makes it easy to create a project for the L Developer Preview. Follow
the steps described in <a href="{@docRoot}sdk/installing/create-project.html">Creating a
Project</a>. In the <strong>Form Factors</strong> screen:</p>

<ul>
  <li>Check <strong>Phone and Tablet</strong>.</li>
  <li>Select <strong>API 20+: Android L (Preview)</strong> in <strong>Minimum SDK</strong>.</li>
</ul>

<p>On the development environment, open the <code>build.gradle</code> file for your module
and make sure that:</p>

<ul>
  <li><code>compileSdkVersion</code> is set to <code>'android-L'</code></li>
  <li><code>minSdkVersion</code> is set to <code>'L'</code></li>
  <li><code>targetSdkVersion</code> is set to <code>'L'</code></li>
</ul>

<p>To use the material theme, open the <code>values/styles.xml</code> in your project and make
sure that you theme extends the material theme:</p>

<pre>
&lt;resources>
    &lt;style name="AppTheme" parent="android:Theme.Material">
        &lt;!-- Customize your theme here -->
    &lt;/style>
&lt;/resources>
</pre>