From 3254f8cc7dbf575658f4080b83fff51a833c1ea8 Mon Sep 17 00:00:00 2001 From: "smain@google.com" Date: Tue, 8 Mar 2016 17:25:50 -0800 Subject: [PATCH] Merge device flashing and emulator setup docs together and retitle. Change-Id: Iafc6c58e7d7d57846561555ff87c8aebd485812b --- docs/html/preview/download.jd | 174 ++++++++++++++++++++----------- docs/html/preview/preview_toc.cs | 9 +- docs/html/preview/run-app.jd | 97 ----------------- docs/html/preview/setup-sdk.jd | 4 +- 4 files changed, 119 insertions(+), 165 deletions(-) delete mode 100644 docs/html/preview/run-app.jd diff --git a/docs/html/preview/download.jd b/docs/html/preview/download.jd index ac70b3ed74f21..ae8351951e24b 100644 --- a/docs/html/preview/download.jd +++ b/docs/html/preview/download.jd @@ -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”).

In this document

    -
  1. Getting Android N on Devices +
  2. Install on a Device
      -
    1. Over the air updates
      2. -
    2. Installing system images
      3. +
    3. Get over-the-air updates
      4. +
    4. Download the system image
      5. +
    5. Revert to factory specifications
    3. -
  3. Revert to Factory Specifications
    4. +
  4. Use the Emulator
-

- 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. -

-

Getting Android N on Devices

-

- 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 + + + +

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.

+ +

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 +Set Up to Develop for Android N. + + + +

Install on a Device

+ +

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.

@@ -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.

-

- You can create emulators containing Android N within the Preview SDK. - For more information about getting the Preview SDK, see - Set Up the SDK. -

- -

Over the air updates

+

Get over-the-air updates

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”).

Warning: 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.

-

Installing system images

+

Download the system image

-

- 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 - removes all data from the device, so you should back up your data - before installing a system image. +

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.

+ +

The process of installing a system image on a device removes all data +from the device, so you should back up your data before installing a +system image.

+ +

After you back up your device data and download the system image below that +matches your device, follow the instructions at developers.google.com/android +to flash the image onto your device.

+ +

+Note: If you manually install a preview system image on a +device, that device will not 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.

@@ -323,30 +335,7 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).
-

Install an Image to a Device

- -

- 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: -

- -
    -
  1. Download and uncompress one of the system image packages listed here.
    2. -
  2. Backup any data you want to preserve from the device.
    3. -
  3. Follow the instructions at - - developers.google.com/android to flash the image onto your device.
    4. -
- -

- Note: If you manually install a preview system image on a - device, that device does not automatically receive additional preview - updates. If you want to update a device with a new preview system image, you - must perform another manual installation. -

- - -

Revert to Factory Specifications

+

Revert to factory specifications

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”).

+ + +

Use the Emulator

+ +

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. +

+ +

First, download the Android N Preview SDK as follows (if you +already got it while setting up +Android Studio 2.1, you can skip this part): + +

    +
  1. In Android Studio, open the Settings dialog + (File > Settings on Windows/Linux, or + Android Studio > Preferences on Mac). In the left + panel, select Appearance & Behavior > + System Settings > Android SDK. + +
  2. Click the SDK Platforms tab, then select the + Android N Preview check box.
    3. + +
  3. Click the SDK Tools tab, then select the + Android SDK Build Tools, Android SDK + Platform-Tools, and Android SDK Tools check + boxes. +
    4. + +
  4. Click OK and accept the license + agreements for any packages to be installed. +
    5. +
+ + +

Now create a virtual device with the Android N system image:

+ +
    +
  1. Open the AVD Manager by selecting Tools > Android > + AVD Manager.
    2. +
  2. Click Create Virtual Device.
    3. +
  3. Select a device such as Nexus 5X, Nexus 6P, Nexus 9, or Android TV, + then click Next.
    4. +
  4. Select the N system image (with the + x86 ABI), then click Next. +
  5. Complete the rest of the AVD configuration and click + Finish.
    6. +
+ +

You can now launch the Android Emulator with the Android N Preview AVD.

+ +

For more information about creating virtual devices, see Managing Virtual Devices. +

+ + + + + + + + + + + + + + diff --git a/docs/html/preview/preview_toc.cs b/docs/html/preview/preview_toc.cs index 715753298c0fc..b4106872f05c1 100644 --- a/docs/html/preview/preview_toc.cs +++ b/docs/html/preview/preview_toc.cs @@ -23,8 +23,8 @@ Set Up to Develop
  • -
    - Run Your App
    +
    + Test on a Device
    • @@ -104,11 +104,6 @@ Samples -
  • -
    Device Images
    -
    • -
  • diff --git a/docs/html/preview/run-app.jd b/docs/html/preview/run-app.jd deleted file mode 100644 index c04c4b511c5e3..0000000000000 --- a/docs/html/preview/run-app.jd +++ /dev/null @@ -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 - - - -

    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.

    - -

    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 -Set Up to Develop for Android N. - -

    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.

    - - -

    Set up a Virtual Device

    - -

    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. -

    - -

    First, download the Android N Preview SDK as follows (if you -already got it while setting up -Android Studio 2.1, you can skip this part): - -

      -
    1. In Android Studio, open the Settings dialog - (File > Settings on Windows/Linux, or - Android Studio > Preferences on Mac). In the left - panel, select Appearance & Behavior > - System Settings > Android SDK. - -
    2. Click the SDK Platforms tab, then select the - Android N Preview check box.
      3. - -
    3. Click the SDK Tools tab, then select the - Android SDK Build Tools, Android SDK - Platform-Tools, and Android SDK Tools check - boxes. -
      4. - -
    4. Click OK and accept the license - agreements for any packages to be installed. -
      5. -
    - - -

    Now create a virtual device with the Android N system image:

    - -
      -
    1. Open the AVD Manager by selecting Tools > Android > - AVD Manager.
      2. -
    2. Click Create Virtual Device.
      3. -
    3. Select your device, then click Next.
      4. -
    4. Select the N system image (with the - x86 ABI), then click Next. -
    5. Complete the rest of the AVD configuration and click - Finish.
      6. -
    - -

    You can now launch the Android Emulator with the Android N Preview AVD.

    - -

    For more information about creating virtual devices, see Managing Virtual Devices. -

    - - - -

    Set Up a Hardware Device

    - -

    - 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 Device Images page. -

    - -

    - Important: Installing a preview image on a device - removes all data from it, so you should backup any data before - installing a preview image. -

    diff --git a/docs/html/preview/setup-sdk.jd b/docs/html/preview/setup-sdk.jd index 0ca05a383d483..4099f3e481345 100644 --- a/docs/html/preview/setup-sdk.jd +++ b/docs/html/preview/setup-sdk.jd @@ -25,7 +25,7 @@ on this page.

    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 Run Your App on Android N.

    +href="{@docRoot}preview/download.html">Test on an Android N Device.

    Get Android Studio 2.1 (preview)

    @@ -199,7 +199,7 @@ android {

    Now that you've set up Android Studio 2.1 (preview), follow the guide to Run Your App on Android N. +href="{@docRoot}preview/download.html">Test on an Android N Device. And learn more about the Android N platform with Behavior Changes and Android N APIs