Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge device flashing and emulator setup docs together and retitle.

Browse Source 
Change-Id: Iafc6c58e7d7d57846561555ff87c8aebd485812b
This commit is contained in:
smain@google.com
2016-03-08 17:25:50 -08:00
parent 8e0a0e6306
commit 3254f8cc7d
4 changed files with 119 additions and 165 deletions
Download Patch File Download Diff File Expand all files Collapse all files

174
docs/html/preview/download.jd
View File

@@ -1,4 +1,4 @@
page.title=Device Images
page.title=Test on an Android N Device
page.image=images/cards/card-download_16-9_2x.png
meta.tags="preview", "system image"
page.tags="preview", "developer preview"
@@ -170,34 +170,41 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
<div id="qv">
<h2>In this document</h2>
<ol>
<li><a href="#device-preview">Getting Android N on Devices</a>
<li><a href="#device-preview">Install on a Device</a>
<ol>
<li><a href="#ota">Over the air updates</a></li>
<li><a href="#flash">Installing system images</a></li>
<li><a href="#ota">Get over-the-air updates</a></li>
<li><a href="#flash">Download the system image</a></li>
<li><a href="#revertDevice">Revert to factory specifications</a></li>
</ol>
</li>
<li><a href="#revertDevice">Revert to Factory Specifications</a></li>
<li><a href="#setupAVD">Use the Emulator</a></li>
</ol>
</div>
</div>
<p>
The Android N Developer Preview includes device system images to help you
test your app and the new APIs coming in the next release of the platform.
This document describes how to get Android N system images on a device for
testing.
</p>
<h2 id="device-preview">Getting Android N on Devices</h2>
<p>
In order to effectively test your apps with Android N, use
an Android N emulator provided with the N Preview SDK or configure a device
with an Android N system image. Android N allows you to update
devices for use in testing the functionality of the Android N APIs and system
behaviors with your apps. You can get Android N on a device by opting a
device into the Android Beta Program or by downloading an Android N system
<p>To run the Android N Preview so you can test your apps, you can either
install the Android N Preview on one of several supported devices or run it on
the Android Emulator.</p>
<p>Simply installing your app onto Android N this way does not require
any changes to your app source code. If, however, you want to update your
app to use new Android N APIs and Java 8 language features,
then you need to download Android Studio 2.1 (preview) as described in
<a href="{@docRoot}preview/setup-sdk.html">Set Up to Develop for Android N</a>.
<h2 id="device-preview">Install on a Device</h2>
<p>You can get the Android N Preview on a device by opting into
the Android Beta Program to receive over-the-air updates to your device
or by downloading an Android N Preview system
image and installing it on a device.
</p>
@@ -211,14 +218,8 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
cause your phone and installed services and applications to stop working.
</p>
<p>
You can create emulators containing Android N within the Preview SDK.
For more information about getting the Preview SDK, see
<a href="{@docRoot}preview/setup-sdk.html">Set Up the SDK</a>.
</p>
<h3 id="ota">Over the air updates</h3>
<h3 id="ota">Get over-the-air updates</h3>
<p>
You can receive preview versions of Android on compatible devices by
@@ -236,19 +237,30 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
<p class="warning">
<strong>Warning:</strong> If you enroll a device for receiving a preview
version of Android, and then later opt-out of receiving those updates on
the device, all user data on that device is removed.
the device, all user data on that device will be removed.
</p>
<h3 id="flash">Installing system images</h3>
<h3 id="flash">Download the system image</h3>
<p>
These system images allow you to install a preview version of the platform on
a physical device for testing. By configuring a device with one of these
images, you can install and test your app to see how it performs on the next
version of the platform. The process of installing a system image on a device
<em>removes all data from the device</em>, so you should back up your data
before installing a system image.
<p>To instead manually flash the system image to your device and control
the updates yourself, you can download the appropriate system image for your
device from the table below.</p>
<p>The process of installing a system image on a device <em>removes all data
from the device</em>, so you should back up your data before installing a
system image.</p>
<p>After you back up your device data and download the system image below that
matches your device, 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.</p>
<p class="note">
<strong>Note:</strong> If you manually install a preview system image on a
device, that device <em>will not</em> receive additional over-the-air updates
(either production or preview). If you want to update a device with a new
preview system image, you must perform another manual installation.
</p>
<table>
@@ -323,30 +335,7 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
</table>
<h4 id="install-image">Install an Image to a Device</h4>
<p>
In order to use a device image for testing, you must install it on a
compatible device. Follow the instructions below to install a system image:
</p>
<ol>
<li>Download and uncompress one of the system image packages listed here.</li>
<li>Backup any data you want to preserve from the device.</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>
<p class="note">
<strong>Note:</strong> If you manually install a preview system image on a
device, that device <em>does not</em> automatically receive additional preview
updates. If you want to update a device with a new preview system image, you
must perform another manual installation.
</p>
<h2 id="revertDevice">Revert to Factory Specifications</h2>
<h3 id="revertDevice">Revert to factory specifications</h3>
<p>
If you want to uninstall the preview and revert the device to factory
@@ -362,6 +351,73 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
</p>
<h2 id="setupAVD">Use the Emulator</h2>
<p>To use the Android Emulator to run the Android N Preview you need to download
the Android N Preview SDK and create a virtual device for the emulator.
</p>
<p>First, download the Android N Preview SDK as follows (if you
already got it while <a href="{@docRoot}preview/setup-sdk.html">setting up
Android Studio 2.1</a>, you can skip this part):
<ol>
<li>In Android Studio, open the Settings dialog
(<strong>File &gt; Settings</strong> on Windows/Linux, or
<strong>Android Studio &gt; Preferences</strong> on Mac). In the left
panel, select <strong>Appearance &amp; Behavior &gt;
System Settings &gt; Android SDK</strong>.
<li>Click the <strong>SDK Platforms</strong> tab, then select the
<strong>Android N Preview</strong> check box.</li>
<li>Click the <strong>SDK Tools</strong> tab, then select the
<strong>Android SDK Build Tools</strong>, <strong>Android SDK
Platform-Tools</strong>, and <strong>Android SDK Tools</strong> check
boxes.
</li>
<li>Click <strong>OK</strong> and accept the license
agreements for any packages to be installed.
</li>
</ol>
<p>Now create a virtual device with the Android N system image:</p>
<ol>
<li>Open the AVD Manager by selecting <strong>Tools > Android >
AVD Manager</strong>.</li>
<li>Click <strong>Create Virtual Device</strong>.</li>
<li>Select a device such as Nexus 5X, Nexus 6P, Nexus 9, or Android TV,
then click <strong>Next</strong>.</li>
<li>Select the <strong>N</strong> system image (with the
<strong>x86</strong> ABI), then click <strong>Next</strong>.
<li>Complete the rest of the AVD configuration and click
<strong>Finish</strong>.</li>
</ol>
<p>You can now launch the Android Emulator with the Android N Preview AVD.</p>
<p>For more information about creating virtual devices, see <a href=
"{@docRoot}tools/devices/index.html">Managing Virtual Devices</a>.
</p>
</div><!-- landing -->
</div><!-- relative wrapper -->

9
docs/html/preview/preview_toc.cs
View File

@@ -23,8 +23,8 @@
Set Up to Develop</a></div>
</li>
<li class="nav-section">
<div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/run-app.html">
Run Your App</a></div>
<div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/download.html">
Test on a Device</a></div>
</li>
@@ -104,11 +104,6 @@
Samples</a></div>
</li>
<li class="nav-section">
<div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/download.html"
>Device Images</a></div>
</li>
<li class="nav-section">
<div class="nav-section-header empty"><a href="<?cs var:toroot ?>preview/support.html">

97
docs/html/preview/run-app.jd
View File

@@ -1,97 +0,0 @@
page.title=Run Your App on Android N
meta.keywords="preview", "android"
page.tags="preview", "developer preview"
page.image=images/cards/card-n-sdk_2x.png
@jd:body
<div id="qv-wrapper">
<div id="qv">
<ol>
<li><a href="#setupAVD">Set up a Virtual Device</a></li>
<li><a href="#setup-device">Set Up a Hardware Device</a></li>
</ol>
</div>
</div>
<p>If you have an existing Android app and you simply want to run it on the
Android N system image, then you need either a virtual device or a supported
hardware device configured with an Android N system image.</p>
<p>Simply installing your app onto Android N this way does not require
any changes to your app source code. If, however, you want to update your
app to use new APIs in Android N and new language features of Java 8,
then you need to download Android Studio 2.1 (preview) as described in
<a href="{@docRoot}preview/setup-sdk.html">Set Up to Develop for Android N</a>.
<p>So, although Android Studio 2.1 is required for development with Android N
APIs, you can use Android Studio 1.5 or higher if you simply want to run your
app in the emulator or a connected device.</p>
<h2 id="setupAVD">Set up a Virtual Device</h2>
<p>To use the Android Emulator to run Android N you need to download
the Android N Preview SDK and create a virtual device for the emulator.
</p>
<p>First, download the Android N Preview SDK as follows (if you
already got it while <a href="{@docRoot}preview/setup-sdk.html">setting up
Android Studio 2.1</a>, you can skip this part):
<ol>
<li>In Android Studio, open the Settings dialog
(<strong>File &gt; Settings</strong> on Windows/Linux, or
<strong>Android Studio &gt; Preferences</strong> on Mac). In the left
panel, select <strong>Appearance &amp; Behavior &gt;
System Settings &gt; Android SDK</strong>.
<li>Click the <strong>SDK Platforms</strong> tab, then select the
<strong>Android N Preview</strong> check box.</li>
<li>Click the <strong>SDK Tools</strong> tab, then select the
<strong>Android SDK Build Tools</strong>, <strong>Android SDK
Platform-Tools</strong>, and <strong>Android SDK Tools</strong> check
boxes.
</li>
<li>Click <strong>OK</strong> and accept the license
agreements for any packages to be installed.
</li>
</ol>
<p>Now create a virtual device with the Android N system image:</p>
<ol>
<li>Open the AVD Manager by selecting <strong>Tools > Android >
AVD Manager</strong>.</li>
<li>Click <strong>Create Virtual Device</strong>.</li>
<li>Select your device, then click <strong>Next</strong>.</li>
<li>Select the <strong>N</strong> system image (with the
<strong>x86</strong> ABI), then click <strong>Next</strong>.
<li>Complete the rest of the AVD configuration and click
<strong>Finish</strong>.</li>
</ol>
<p>You can now launch the Android Emulator with the Android N Preview AVD.</p>
<p>For more information about creating virtual devices, see <a href=
"{@docRoot}tools/devices/index.html">Managing Virtual Devices</a>.
</p>
<h2 id="setup-device">Set Up a Hardware Device</h2>
<p>
If you have a supported device, you can install Android N for testing your
app. For full instructions, including the current list of supported devices,
see the <a href="{@docRoot}preview/download.html">Device Images</a> page.
</p>
<p class="caution">
<strong>Important:</strong> Installing a preview image on a device
<em>removes all data from it</em>, so you should backup any data before
installing a preview image.
</p>

4
docs/html/preview/setup-sdk.jd
View File

@@ -25,7 +25,7 @@ on this page.</p>
<p>If you instead want to simply test your app's forward-compatibility on the
Android N system image, you can instead follow the guide to <a
href="{@docRoot}preview/run-app.html">Run Your App on Android N</a>.</p>
href="{@docRoot}preview/download.html">Test on an Android N Device</a>.</p>
<h2 id="get-as13">Get Android Studio 2.1 (preview)</h2>
@@ -199,7 +199,7 @@ android {
<p>Now that you've set up Android Studio 2.1 (preview), follow the guide
to <a
href="{@docRoot}preview/run-app.html">Run Your App on Android N</a>.
href="{@docRoot}preview/download.html">Test on an Android N Device</a>.
And learn more about the Android N platform with
<a href="{@docRoot}preview/behavior-changes.html">Behavior Changes</a>
and <a href="{@docRoot}preview/api-overview.html">Android N APIs