diff --git a/docs/html/preview/behavior-changes.jd b/docs/html/preview/behavior-changes.jd index 9b3dbabecfc00..5ddac7a8eca16 100644 --- a/docs/html/preview/behavior-changes.jd +++ b/docs/html/preview/behavior-changes.jd @@ -50,20 +50,21 @@ some of the key changes that you should understand and account for in your apps. might be affected by these changes in the platform.

Runtime Permissions

-

This preview introduces a new runtime permissions model, where users can now directly manage -their app permissions at runtime. This model gives users improved visibility and control over +

This preview introduces a new permissions model, where users can now directly manage +app permissions at runtime. This model gives users improved visibility and control over permissions, while streamlining the installation and auto-update processes for app developers. -Users can set permissions on or off for all apps running on the M Preview. However, apps that -don’t target the M Preview cannot request permissions at runtime.

+Users can grant or revoke permissions individually for installed apps.

On your apps that target the M Preview, make sure to check and request for permissions at runtime. To determine if your app has been granted a permission, call the new {@code Context.checkSelfPermission()} method. To request for a permission, call the new -{@code Activity.requestPermission()} method.

+{@code Activity.requestPermission()} method. Even if your app is not targeting M, you +should test your app under the new permissions model.

-

For more information on supporting the new permissions model in your app, see +

For details on supporting the new permissions model in your app, see the -Android M Preview Runtime Permissions.

+Permissions developer preview page. For tips on how to assess the impact on your app, +see the Testing Guide

Power-Saving Optimizations

This preview introduces new power-saving optimizations for idle devices and apps.

@@ -103,6 +104,10 @@ high-priority messages. If your app receives high-priority GCM messages, it’s brief network access even when the device is in doze.

+

See the +Testing Guide for tips on how +to test Doze in your apps.

+

App standby

With this preview, the system may determine that apps are idle when they are not in active use. Your app is considered idle after a period of time, unless the system detects @@ -140,6 +145,10 @@ designate high-priority messages. If your app receives high-priority GCM message brief network access even when the app is idle.

+

See the +Testing Guide for tips on how +to test App Standby in your apps.

+

Adoptable Storage Devices

With this preview, users can adopt external storage devices such as SD cards. Adopting an diff --git a/docs/html/preview/overview.jd b/docs/html/preview/overview.jd index d6bafb1ed9f81..36b177d4a07a3 100644 --- a/docs/html/preview/overview.jd +++ b/docs/html/preview/overview.jd @@ -116,7 +116,7 @@ page.tags="preview", "developer", "android" Preview program timeline

- The M Developer Preview runs from May 27 until the final Android M SDK, which + The M Developer Preview runs from May 28 until the final Android M SDK, which we’ll release shortly before the public release during Q3 2015.

@@ -326,7 +326,7 @@ page.tags="preview", "developer", "android"

- How to get started? + How to get started

@@ -336,10 +336,12 @@ page.tags="preview", "developer", "android"

  1. Review the API Overview and Behavior Changes to get an - idea of what's new and how it affects your apps. + idea of what's new and how it affects your apps. In particular, learn about + the new runtime + permissions model, power-saving features, and auto backup.
  2. -
  3. Setup for testing and development by following the instructions for +
  4. Set up your environment by following the instructions for Setting up the Preview SDK and configuring test devices.
  5. diff --git a/docs/html/preview/testing/guide.jd b/docs/html/preview/testing/guide.jd index 07a25a29744f3..56bb4d994476d 100644 --- a/docs/html/preview/testing/guide.jd +++ b/docs/html/preview/testing/guide.jd @@ -57,7 +57,7 @@ page.keywords=previewresources,androidm,testing,permissions app features from working, or they may work in a degraded state.

    -

    +

    This change affects all apps running on the new platform, even those not targeting the new platform version. The platform provides a limited compatibility behavior for legacy apps, but you should begin planning your app’s migration to the new permissions model now, with a goal of