From bd4ed32ffa25e860b6212cff31510c801fffc39f Mon Sep 17 00:00:00 2001 From: Joe Fernandez Date: Sun, 16 Aug 2015 16:56:02 -0700 Subject: [PATCH] docs: Preview 3 - Support page updates - Add Key changes - Add Known issues Change-Id: I080b191a6609a4216e7521afa951b53f33609b90 --- docs/html/preview/api-overview.jd | 38 ++++++++++++++---------- docs/html/preview/download_mp1.jd | 2 +- docs/html/preview/download_mp2.jd | 2 +- docs/html/preview/setup-sdk.jd | 62 +++++++++++---------------------------- docs/html/preview/support.jd | 35 ++++++++++++---------- 5 files changed, 61 insertions(+), 78 deletions(-) diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd index e15a6579e725..55829d3906d2 100644 --- a/docs/html/preview/api-overview.jd +++ b/docs/html/preview/api-overview.jd @@ -45,7 +45,7 @@ page.image=images/cards/card-api-overview_16-9_2x.png

API Differences

    -
  1. API level 22 to M Preview »
    2. +
  2. API level 22 to 23 (Preview 3) »
@@ -55,21 +55,27 @@ page.image=images/cards/card-api-overview_16-9_2x.png for the Android platform, which offers new features for users and app developers. This document provides an introduction to the most notable APIs.

-

The M Developer Preview is intended for developer early -adopters and testers. If you are interested in -influencing the direction of the Android framework, -give the M Developer Preview a -try and send us your feedback!

- -

Caution: Do not publish apps -that use the M Developer Preview to the Google Play store.

- -

Note: This document often refers to classes and -methods that do not yet have reference material available on developer.android.com. These API elements are -formatted in {@code code style} in this document (without hyperlinks). For the -preliminary API documentation for these elements, download the preview reference.

+

+ The M Developer Preview 3 release includes the final APIs for Android 6.0 (API level + 23). If you are preparing an app for use on Android 6.0, + download the latest SDK and to complete your + final updates and release testing. You can review the final APIs in the + API Reference and see the API differences in + the Android API Differences Report. +

+ +

+ +

Important: + You may now publish apps that target Android 6.0 (API level 23) to the Google Play store. +

+ +

Note: + If you have been working with previous preview releases and want to see the differences + between the final API and previous preview versions, download the additional difference + reports included in the preview docs + reference. +

Important behavior changes

diff --git a/docs/html/preview/download_mp1.jd b/docs/html/preview/download_mp1.jd index cb4d300be1a1..5838f205dbd9 100644 --- a/docs/html/preview/download_mp1.jd +++ b/docs/html/preview/download_mp1.jd @@ -1,4 +1,4 @@ -page.title=Developer Preview Archive +page.title=Developer Preview 1 Archive page.image=images/cards/card-download_16-9_2x.png @jd:body diff --git a/docs/html/preview/download_mp2.jd b/docs/html/preview/download_mp2.jd index 0dfabefe51e2..0208b5e8f5af 100644 --- a/docs/html/preview/download_mp2.jd +++ b/docs/html/preview/download_mp2.jd @@ -1,4 +1,4 @@ -page.title=Downloads +page.title=Developer Preview 2 Archive page.image=images/cards/card-download_16-9_2x.png @jd:body diff --git a/docs/html/preview/setup-sdk.jd b/docs/html/preview/setup-sdk.jd index d3327e8dbbe1..a4d9418d7c15 100644 --- a/docs/html/preview/setup-sdk.jd +++ b/docs/html/preview/setup-sdk.jd @@ -16,56 +16,30 @@ page.image=images/cards/card-set-up_16-9_2x.png -

The M Developer Preview SDK is available from the Android SDK Manager. -This document assumes that you are familiar with Android app development, such +

With Developer Preview 3, the official Android 6.0 SDK is now available from the Android SDK +Manager. This document assumes that you are familiar with Android app development, such as using the Android SDK Manager and creating projects. If you are new to Android, see Building Your First -App training lesson first.

+App training lesson first.

-

Get Android Studio 1.3

- -

The Developer Preview is best used with Android Studio 1.3, which is in -preview status. It is highly recommended that you install the preview version of -Android Studio 1.3 to work with the Preview SDK.

- -

Caution: The canary preview of Android -Studio 1.3 is still in active development. If you are using your primary development -machine to test the developer preview, you can create a second installation -of Android Studio to use for testing.

-

To install the Android Studio 1.3 preview:

- -
    -
  1. Download and launch Android - Studio. -
    2. - -
  2. Open the Settings window (on Windows, you can do this - by choosing File > Settings). Choose the - Appearance & Behavior > System - Settings > Updates panel. - -

    On OSX, you can find the Appearance & - Behavior panel - in Android Studio's Preferences window.

    -
    3. +

    Get Android Studio 1.3

    -
  3. On the Updates panel, choose the option - Automatically check updates for: Canary Channel. -
    4. +

    + The Developer Preview is best used with Android Studio 1.3. It is highly recommended that + you install the Android Studio 1.3 to work with the Preview SDK and the final Android 6.0 SDK + provided with Preview 3. Please update your Android Studio installation to version 1.3 or + higher, or follow the instructions for + Installing Android Studio. +

    -
  4. On the Updates panel, select Check Now - to check for the latest canary build. Download and install the build when you - are prompted. -
    5. -

Get the Preview SDK

To add the Preview SDK components to your development environment:

    -
  1. Launch the Android Studio 1.3 preview. +
  2. Launch Android Studio 1.3 or higher.
  3. Open the Settings window (on Windows, you can do this @@ -73,13 +47,12 @@ of Android Studio to use for testing.

    Appearance & Behavior > System Settings > Updates panel. -

    On OSX, you can find the Appearance & +

    On Mac OS X, you can find the Appearance & Behavior panel in Android Studio's Preferences window.

    4. -
  4. On the Updates panel, choose the options - Automatically check updates for: Canary Channel and +
  5. On the Updates panel, choose the option for Automatically check updates for Android SDK: Preview Channel.
    6. @@ -135,7 +108,7 @@ of Android Studio to use for testing.

    • Check Phone and Tablet.
      • -
    • Select MNC: Android M (Preview) in Minimum +
    • Select API 23: Android 6.0 (Marshmallow) in Minimum SDK.
    @@ -149,9 +122,8 @@ of Android Studio to use for testing.

      -
    • compileSdkVersion is set to 'android-MNC'
      • -
    • minSdkVersion is set to 'MNC'
      • -
    • targetSdkVersion is set to 'MNC'
      • +
    • compileSdkVersion is set to '23'
      • +
    • targetSdkVersion is set to '23'
    diff --git a/docs/html/preview/support.jd b/docs/html/preview/support.jd index a3bfe7eb501d..49d4906f1dad 100644 --- a/docs/html/preview/support.jd +++ b/docs/html/preview/support.jd @@ -57,7 +57,7 @@ page.image=images/cards/card-support_16-9_2x.png

    Date: August 2015
    - Builds: XXXXXX (Nexus 5, 6, 9), XXXXXX (Nexus Player)
    + Build: MPA44G
    Hardware support: Nexus 5, 6, 9, Player
    Emulator support: x86 & ARM 32/64-bit
    Google Play services: 7.8     @@ -70,7 +70,7 @@ page.image=images/cards/card-support_16-9_2x.png Developer Preview 3 is the final incremental update to the Android M preview platform that was originally released in May 2015. The update includes final APIs and the official Android 6.0 SDK, - as well as near-final system images for testing your apps. The + as well as near-final system images for testing your apps. The updated system images bring a variety of fixes and enhancements across the system, including those related to issues reported by developers through the external issue tracker. @@ -95,7 +95,7 @@ page.image=images/cards/card-support_16-9_2x.png

    - Developer Preview 3 includes the official Android 6.0 + Developer Preview 3 includes the official Android 6.0 SDK as well as updated preview system images, documentation, and samples for developing against the Android 6.0 development platform. @@ -134,7 +134,7 @@ page.image=images/cards/card-support_16-9_2x.png

  6. RuntimePermissions - / RuntimePermissionsBasic are updated to reflect latest permissions API changes, including shouldShowRequestPermissionRationale(). @@ -151,16 +151,18 @@ page.image=images/cards/card-support_16-9_2x.png
      -
    • Add here +
    • Permission changes
        -
      • +
      • The {@link android.Manifest.permission#GET_ACCOUNTS} permission is now a member of the + {@link android.Manifest.permission_group#CONTACTS} permission group and it has a + {@code android:protectionLevel} of {@code dangerous}. This change means that when + targeting Android 6.0 (API level 23), you must check for and request this permission if + your app requires it.
        • -
      -
      • -
    • Other changes -
        -
      • +
      • The {@code android.permission.READ_PROFILE} and {@code android.permission.WRITE_PROFILE} + permissions have been removed from the {@link android.Manifest.permission_group#CONTACTS} + permission group.
      • @@ -178,7 +180,10 @@ page.image=images/cards/card-support_16-9_2x.png
      • General issues:
          -
        • Add +
        • On LTE devices, including volantis, GPS is not functioning properly, which may + interfere with navigation services. +
          • +
        • During Hangouts calls, users may experience distorted or low audio on some devices.
        • @@ -314,7 +319,7 @@ page.image=images/cards/card-support_16-9_2x.png
      -

      +

      Key changes

      @@ -405,7 +410,7 @@ page.image=images/cards/card-support_16-9_2x.png "{@docRoot}preview/download.html#docs">Developer Documentation download package.

      -

      +

      Known issues

      @@ -463,7 +468,7 @@ page.image=images/cards/card-support_16-9_2x.png Developer Preview 2 system images for supported Nexus devices are available by download and by over-the-air (OTA) update. The OTA update is available only to supported devices that are currently running Developer Preview 1. If - your devices is running Developer Preview 1, you should automatically receive + your devices are running Developer Preview 1, you should automatically receive the OTA update within a few days of availability.

      -- 2.11.0