From b890729216ca805af02c7620c060b34ec6ea46aa Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Thu, 10 Mar 2016 09:43:36 -0800 Subject: [PATCH] docs: Update install/uninstall procedure for Nexus & non-Nexus devices Include download links for seed device. Adjust various references to DP device range. Change-Id: I01ecaaf46e128fec811e8142395cfa8f09758fd6 --- docs/html-intl/intl/es/index.jd | 2 +- docs/html-intl/intl/ja/index.jd | 2 +- docs/html-intl/intl/ko/index.jd | 2 +- docs/html-intl/intl/pt-br/index.jd | 2 +- docs/html-intl/intl/ru/index.jd | 2 +- docs/html-intl/intl/zh-cn/index.jd | 2 +- docs/html-intl/intl/zh-tw/index.jd | 2 +- docs/html/index.jd | 2 +- docs/html/preview/download.jd | 220 ++++++++++++++++++----------- docs/html/preview/index.jd | 2 +- docs/html/preview/overview.jd | 2 +- docs/html/preview/support.jd | 2 +- 12 files changed, 147 insertions(+), 95 deletions(-) diff --git a/docs/html-intl/intl/es/index.jd b/docs/html-intl/intl/es/index.jd index 985ace3235c37..66f9bf0281d0e 100644 --- a/docs/html-intl/intl/es/index.jd +++ b/docs/html-intl/intl/es/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html-intl/intl/ja/index.jd b/docs/html-intl/intl/ja/index.jd index 1176bf508b3f8..755ec6205bfe4 100644 --- a/docs/html-intl/intl/ja/index.jd +++ b/docs/html-intl/intl/ja/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html-intl/intl/ko/index.jd b/docs/html-intl/intl/ko/index.jd index ee43ab47b96bf..01c85873c6c64 100644 --- a/docs/html-intl/intl/ko/index.jd +++ b/docs/html-intl/intl/ko/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html-intl/intl/pt-br/index.jd b/docs/html-intl/intl/pt-br/index.jd index 5aaa60ae1d70b..f5e1569dc8466 100644 --- a/docs/html-intl/intl/pt-br/index.jd +++ b/docs/html-intl/intl/pt-br/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html-intl/intl/ru/index.jd b/docs/html-intl/intl/ru/index.jd index d3dd99e4a22c8..e917a8dba7893 100644 --- a/docs/html-intl/intl/ru/index.jd +++ b/docs/html-intl/intl/ru/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html-intl/intl/zh-cn/index.jd b/docs/html-intl/intl/zh-cn/index.jd index ec277654f7cf1..ca3a84b80eb2b 100644 --- a/docs/html-intl/intl/zh-cn/index.jd +++ b/docs/html-intl/intl/zh-cn/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html-intl/intl/zh-tw/index.jd b/docs/html-intl/intl/zh-tw/index.jd index d3fe8381e7629..a5772ef0fab01 100644 --- a/docs/html-intl/intl/zh-tw/index.jd +++ b/docs/html-intl/intl/zh-tw/index.jd @@ -22,7 +22,7 @@ page.customHeadTag=Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html/index.jd b/docs/html/index.jd index 129564cf7ae5d..2f67c58412a0e 100644 --- a/docs/html/index.jd +++ b/docs/html/index.jd @@ -23,7 +23,7 @@ nonavpage=true

Android N Developer Preview

Get ready for the next version of Android! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html/preview/download.jd b/docs/html/preview/download.jd index 72228a2631839..614c274689aed 100644 --- a/docs/html/preview/download.jd +++ b/docs/html/preview/download.jd @@ -1,7 +1,6 @@ -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" +page.title=Test on a Device +meta.tags="preview", "nexus","system image" +page.tags="preview", "androidn" page.image=images/cards/card-n-downloads_2x.png @jd:body @@ -170,94 +169,120 @@ This is the Android SDK Preview License Agreement (the “License Agreement”).

In this document

    -
  1. Install on a Device +
  2. Set up a hardware device
    1. Get over-the-air updates
      2. -
    2. Download the system image
      3. -
    3. Revert to factory specifications
      4. +
    4. Manually flash a device
      5. +
    5. Uninstalling
    3. -
  3. Use the Emulator
    4. +
  4. Set up an emulator
- - - - - - -

To run the Android N Preview and 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, see -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. +

+ To run and test your app on the new platform you need to set up an Android N + runtime environment. You can do that in either of these ways:

-

- Warning: The Android system images are previews - and are subject to change. Your use of the system images is governed by the - Android SDK Preview License Agreement. The Android preview system images are - not stable releases, and may contain errors and defects that can result in - damage to your computer systems, devices, and data. The preview Android - system images are not subject to the same testing as the factory OS and can - cause your phone and installed services and applications to stop working. +

+ +

+ If you want an environment for basic compatibility testing of your app on the + new platform, all you need is your current APK and a hardware device or + emulator. You don't necessarily need to update your full development + environment to do basic testing. +

+ +

+ If you want to modify your app to target Android N or use new Android N APIs, + you need to set up a development environment that's updated to support + Android N. Set Up to Develop for + Android N has details.

-

Get over-the-air updates

+

Set up a hardware device

-

You can receive over-the-air updates to preview versions of Android by -enrolling your compatible device in the Android Beta Program. -These updates are automatically downloaded and will update your device just like -official system updates.

+

+ The N Developer Preview offers system updates for a range of hardware devices + that you can use for testing your app, from phones to tablets and TV. +

+ +

+ If you have access to a supported device, you can update it to a Developer + Preview milestone build in one of these ways: +

+ + + +

Enroll the device in automatic OTA updates

+ +

+ If you have access to a supported device (see the list in the Downloads + table), you can receive over-the-air updates to preview versions of Android + by enrolling that device in the Android Beta Program. These updates are + automatically downloaded and will update your device just like official + system updates. +

+ +

+ You can un-enroll a device at any time. The device will receive an OTA update + to the most recent production version of Android available for that device + (for example, Android 6.0 Marshmallow). The update requires a full device + reset, so user data on the device will be removed. Make sure to back + up important data before un-enrolling a device. +

For more information and to enroll your device, see the Android Beta Program web site.

-

- Warning: If you enroll a device in the Android Beta Program, - then later opt-out of receiving updates on - the device, all user data on that device will be removed. +

Note: + Un-enrolling requires a full device reset. Back up + important data first.

+

Flashing a device manually

-

Download the system image

+

+ At any time you can download the latest Developer Preview system image and + manually flash it to your device. See the table below to download the system + image for your test device. +

-

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.

+

+ Installing a system image on a device removes all data from the + device, so you should back up your data first. +

-

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

-

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

Note: + Manually flashed system images will not + automatically receive subsequent OTA updates to later Developer Preview + milestone builds. Make sure to keep your environment up-to-date and flash a + new system image at each Developer Preview milestone.

@@ -328,30 +353,56 @@ preview system image, you must perform another manual installation. SHA-1: 335a86a435ee51f18464de343ad2e071c38f0e92 + + + +
General Mobile 4G (Android One)
"seed"		seed_l8150-npc56p-preview-82472ebc.tgz
+ MD5: 983e083bc7cd0c4a2d39d6ebaa20202a
+ SHA-1: 82472ebc9a6054a103f53cb400a1351913c95127 +
- -

Revert to factory specifications

+

Uninstalling the Preview from a device

- If you want to uninstall the preview and revert the device to factory - specifications, go to - developers.google.com/android/nexus - 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. -

+ If you want to uninstall the preview from a device, you can do so in one of + these ways:

+ -

- Warning: Just like when flashing a preview image, - installing a factory image removes all user data on the device. +

Note: + Uninstalling a Developer Preview system image prior to + the end of the program requires a full device reset and removes all user data + on the device.

- - -

Use the Emulator

+

Set up an 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 @@ -414,9 +465,10 @@ with much faster performance compared to the Emulator in Android Studio 1.5.

Note: -If you're currently using Android Studio 2.0 Beta, there's a known issue -that prevents you from creating AVDs with the N Preview system images, so -you currently need to use the Android Studio 2.1 preview to create AVDs.

+ If you're currently using Android Studio 2.0 Beta, there's a known issue + that prevents you from creating AVDs with the N Preview system images, so + you currently need to use the Android Studio 2.1 preview to create AVDs. +

For more information about creating virtual devices, see Managing Virtual Devices. diff --git a/docs/html/preview/index.jd b/docs/html/preview/index.jd index 5ad72da23f0c1..fddb9505716a7 100644 --- a/docs/html/preview/index.jd +++ b/docs/html/preview/index.jd @@ -25,7 +25,7 @@ footer.hide=1

Android N Developer Preview

Get ready for Android N! - Test your apps on Nexus devices. Support new system + Test your apps on Nexus and other devices. Support new system behaviors to save power and memory. Extend your apps with multi-window UI, direct reply notifications and more. diff --git a/docs/html/preview/overview.jd b/docs/html/preview/overview.jd index 0bc55954bb049..c542e1884ffe6 100644 --- a/docs/html/preview/overview.jd +++ b/docs/html/preview/overview.jd @@ -234,7 +234,7 @@ page.tags="preview", "developer", "android"

Hardware system images

- The N Developer Preview includes Nexus hardware system images that you can use when + The N Developer Preview includes Nexus and other hardware system images that you can use when testing and developing on physical devices. See the Device Images page for the full list of hardware images. diff --git a/docs/html/preview/support.jd b/docs/html/preview/support.jd index 35d07e7ddbb42..ecf48416dea93 100644 --- a/docs/html/preview/support.jd +++ b/docs/html/preview/support.jd @@ -40,7 +40,7 @@ For issues in other apps, please contact the developer directly.

  • Battery life may be regressed in this release for screen-on and screen-off use cases.
  • Some apps may not function normally on Developer Preview 1. This includes Google’s apps as well as other apps.
  • This early build is not Compatibility Test Suite (CTS) approved. Apps that depend on CTS approved builds (Android Pay for example) won’t work.
    • -
  • This preview release supports the following devices: Nexus 5X, Nexus 6, Nexus 6P, Nexus 9, Nexus Player, and Pixel C.
    • +
  • This preview release supports the following devices: Nexus 5X, Nexus 6, Nexus 6P, Nexus 9, Nexus Player, and Pixel C, as well as General Mobile 4G (Android One).

    • Platform Issues