diff --git a/docs/html/preview/index.jd b/docs/html/preview/index.jd
index 826dc502eb8c3..778487da55283 100644
--- a/docs/html/preview/index.jd
+++ b/docs/html/preview/index.jd
@@ -7,15 +7,25 @@ header.hide=1
footer.hide=1
@jd:body
+
+
- Get ready for the next version of Android!
- Test your apps on a variety of Nexus devices. Support new system
+ Get ready for Android N!
+ Test your apps Nexus and other devices. Support new system
behaviors to save power and memory.
Extend your apps with multiwindow UI,
direct reply notifications and more.
@@ -30,7 +40,7 @@ footer.hide=1
Update to Developer Preview (final SDK)
- Welcome to the Android N Developer Preview, a program that gives you
- everything you need to test and optimize your apps for the next version of
- Android. It's free, and you can get started right away just by downloading
- the Preview tools.
+ Welcome to the Android N Developer Preview, a program that
+ gives you everything you need to test and optimize your apps for the next
+ version of Android. It's free, and you can get started right away just by
+ downloading the N Developer Preview tools.
- Run and test your apps on Nexus 5X, 6P, 9, and Player (for TV), as well
- as emulator.
+ Run and test your apps on Nexus 5X, 6, 6P, 9,
+ Pixel C, and Player, as well as other hardware
+ devices and emulator.
+
- We’ll provide multiple updates during the Preview, so you’ll be testing
- against the latest platform changes.
+ We’ll provide monthly updates during the Preview, so you’ll be testing against the latest platform changes.
- You can get updates over-the-air, once you’ve flashed a
- device to the initial preview.
+ During the first several weeks we’ll give priority to developer-reported
+ issues, so test and give feedback as soon as possible.
- Start work early to support new platform behaviors such as
- the new runtime permissions model and power-saving features.
+ Start work early to support new platform behaviors and develop with new features.
- During the first several weeks we’ll give priority to developer-reported
- issues, so test and give feedback as soon as possible.
+ Seamless over-the-air updates for any supported device through the Android Beta Program. No flashing is needed.
- Report issues and give us feedback using our issue tracker.
- Connect with other developers in the Developer Community.
-
+ Report issues and give us feedback using our issue tracker.
+ Connect with other developers in the N Developer Community.
- With the Preview, you'll get an early start on testing your apps,
- with enough time to make adjustments before the public platform release later
- in the year. We'll provide several updates to the Preview tools in the weeks
- ahead, so you can keep in sync with the latest changes as the platform moves
- toward launch.
+ The N Developer Preview runs from 9 March 2016 until the final Android N
+ public release to AOSP and OEMs, planned for Q3 2016.
- You can help us improve the platform by reporting issues
- through our feedback channels. This is especially
- critical in the first month of the preview, when we’ll be giving priority to
- developer-reported issues and feedback.
-
- The Preview runs from March 9 until the final Android N public release planned for Q3
- 2016.
+ Each update includes SDK tools, preview system images, emulators, reference
+ documentation, and API diffs.
+
+ The first three preview milestones provide an early
+ test and development environment that help you identify
+ compatibility issues in your current apps and plan migration or feature work
+ needed to target the new platform. This is the priority period in which to
+ give us your feedback on features and APIs and file compatibility issues
+ — for all of these, please use the issue tracker [link]. You can expect
+ some API changes across these updates.
+
+ At previews 4 and 5 you’ll have access to the final
+ N APIs and SDK to develop with, as well as near-final system images
+ to test system behaviors and features. Android N will provide a standard API
+ level at this time. You can begin final compatibility testing of your legacy
+ apps and refine any new code that is using the N APIs or features.
+
+ Also starting in preview 4, you’ll be able to publish apps to
+ devices running Android N at the official API level, such as
+ consumer devices that have opted into the Android Beta program. You can
+ publish into the Google Play alpha and beta channels first, so you can test
+ your apps with Android Beta consumers before distributing broadly on the
+ store.
As you test and develop on Android N, we strongly recommend keeping
- your development environment up-to-date as Preview updates are released.
- To make the process easier, we'll deliver updates over-the-air
- (OTA) to devices already flashed to a Preview build, as well as
- providing system images that you can download and flash manually.
+ your development environment up-to-date as preview updates are
+ released. To make the process easier, you can enroll your test devices in the
+ Android Beta program and get updates over-the-air (OTA) at
+ each milestone. Alternatively, updated preview images are available that you
+ download and flash manually.
- We’ll notify you when Preview updates are available via the Android Developers Blog, as
- well as this site and the Android N Developer Community.
+ well as this site and the Android
+ N Developer Community.
- The Preview includes everything you need to test your existing
+ The N Developer Preview includes everything you need to test your existing
apps on a variety of screen sizes, network technologies, CPU/GPU chipsets,
and hardware architectures.
You can download these components through the SDK Manager in Android Studio:
- You can download these components through the SDK Manager in Android Studio:
+ We’ll provide updates to these development tools at each milestone as needed.
+
+ The N Developer Preview includes hardware system images that you can use when
+ testing and developing on physical devices.
+
+ You can download these Nexus hardware system images from the Downloads page:
- You can download these hardware system images for Nexus devices from the
- Downloads page:
- In addition, you can download these hardware system images from our Developer
+Preview partners:
- These documentation resources help you learn about the Preview:
+ We’ll deliver updated system images for these devices at each milestone. You
+ can download and flash the updated system images to your test devices
+ manually, as frequently as you need. This is especially useful for automated
+ testing environments where you might need to reflash your device multiple
+ times.
- Use these support resources as you test and develop on the Preview:
+ Note:
+ Devices flashed manually will not get OTA updates like in
+ last year’s preview. This year, you can get OTAs by enrolling devices in the
+ Android Beta Program — see details in the next section.
- To get started testing your app with the Preview:
+ New for Android N is an Over-the-Air (OTA) update program that automatically
+ delivers the latest preview updates of Android N directly to devices enrolled
+ in the program. The program is free, and it’s open to anyone who has a
+ supported device that’s registered to their Google account.
+
+ To enroll in the program visit the Android Beta Program site [LINK]. You’ll
+ see all of the devices registered to your account that are eligible to enroll
+ in Android Beta.
+ Once you’ve enrolled, your device will soon receive an update. In most cases,
+ you will not need to do a full reset of your data to move to Android N, but
+ it’s recommended that you back up any data you don’t want to lose before
+ enrolling the device.
+
+ As updates are delivered to your device, we recommend downloading and
+ installing them as soon as possible. You’ll want to stay current with the
+ latest changes in system UI, behavior, APIs, and features.
+
+ At the conclusion of the Developer Preview, your enrolled devices will
+ receive an update to the official Android N release.
+
+ You can un-enroll your devices from the Android Beta program at any time from
+ the Android Beta site. Before un-enrolling, make sure to back-up your data on
+ the device.
+ Note:
+ When you un-enroll, your device will be factory reset
+ to the latest version
+ of Android 6.0 Marshmallow (not necessarily the version that you had
+ installed prior to enrolling the device). To ensure a clean installation,
+ your data will be erased from the device, including contacts, messages,
+ photos, and so on.
+
+ These documentation resources are available on the Developer Preview site to
+ help you learn about the Android N:
+
+ During the early preview updates, you can download the latest API reference
+ for the Android N platform as a separate zip archive. [LINK] The reference
+ download also includes a diff report that helps you identify API changes from
+ API 23 and the previous update.
+
+ When the Android N APIs are final and an official API level is assigned,
+ we’ll provide the API reference to you online at https://developer.android.com.
+
+ As you test and develop on the N Developer Preview, please use these channels
+ to report issues and give feedback.
+
+ The N Developer Preview provides a development-only system and Android
+ library that does not have a standard API level. If you want
+ to opt out of compatibility behaviors to test your app (which is strongly
+ recommended), you can target the preview version of Android N by setting your
+ app's
+ The Android N Developer Preview delivers preview APIs
+ — the APIs will not be official until the final SDK is released,
+ currently planned for the third quarter of 2016. This means that you can
+ expect minor API changes over time, especially during
+ initial weeks of the program. We’ll provide a summary of changes to you with
+ each update of the Android N Developer Preview.
+
+ Note: Although preview APIs may change, underlying
+ system behaviors are stable and ready for testing against
+ right away.
+
+ Google Play prevents publishing of apps targeting the N Developer
+ Preview. When the Android N final SDK is available, you’ll be able
+ to target the official Android N API level and publish your app to Google
+ Play via the alpha and beta release channels. Meanwhile, if you want to
+ distribute an app targeting Android M to testers, you can do so via email or
+ by direct download from your site.
+
+ At the full release of Android N to AOSP and OEMs, planned for Q3 2016,
+ you’ll be able to publish your apps targeting Android N to the public release
+ channel in Google Play.
+
+ To get started testing your app with Android N:
+
Thank you for your participation in the Android N Developer Preview program!
-
Android N Developer Preview
-->
@@ -45,30 +55,67 @@ footer.hide=1
Resources
-
- Hardware and emulator system images
+ Hardware and emulator images
- Updates delivered by OTA
+ Priority for developer issues
- Priority window for developer-reported issues
+
+ Updates delivered by OTA
Timeline and updates
+
+
+
-
- Timeline and updates
-
- What’s in the Preview?
-
+
+What's in the N Developer Preview?
- SDK tools
-
+SDK tools
+
+
+
Hardware system images
+
+
-
-
- Hardware system images
-
-
-
-
-
- Documentation and sample code
-
-
-
-
-
- Support resources
-
-
-
-
-
-
-
- How to get started
-
+OTA Updates through Android Beta Program
-
- Documentation and sample code
+
+
+
+
+Downloadable API Reference
+
+
+ Support resources
+
+
+
+
+
+Targeting, preview APIs, and publishing
+
+targetSdkVersion
+ to “N”.
+How to get started
+
+
+