From 70f1aadd4bc1bfc96ddee08c38a5ac67ae531344 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Tue, 7 Jul 2015 08:18:35 -0700 Subject: Doc change: add version notes for preview 2. Change-Id: Iacd3bf7bc3206f1a143bacbae5f3e7b7b5eefe7d --- docs/html/design/index.jd | 2 +- docs/html/preview/behavior-changes.jd | 36 +++- docs/html/preview/index.jd | 4 + docs/html/preview/support.jd | 366 +++++++++++++++++++++++++++++----- 4 files changed, 346 insertions(+), 62 deletions(-) (limited to 'docs') diff --git a/docs/html/design/index.jd b/docs/html/design/index.jd index 1ffb0a3..799a64f 100644 --- a/docs/html/design/index.jd +++ b/docs/html/design/index.jd @@ -17,7 +17,7 @@ footer.hide=1

Up and running with material design

Android uses a new design metaphor inspired by paper and ink that provides a reassuring - sense of tactility. Visit the material design site for more resources. + sense of tactility. Visit the material design site for more resources.

diff --git a/docs/html/preview/behavior-changes.jd b/docs/html/preview/behavior-changes.jd index 8a8ea05..cb526fa 100644 --- a/docs/html/preview/behavior-changes.jd +++ b/docs/html/preview/behavior-changes.jd @@ -396,18 +396,36 @@ outside of a managed context, the add account flow now prompts the user to insta appropriate WPC. This behavior also applies to accounts added via Settings > Accounts in the initial device setup wizard.
  • Changes to specific DevicePolicyManager API behaviors: -Calling the {@link android.app.admin.DevicePolicyManager#setCameraDisabled(android.content.ComponentName,boolean) setCameraDisabled()} +
      +
    • Calling the {@link android.app.admin.DevicePolicyManager#setCameraDisabled(android.content.ComponentName,boolean) setCameraDisabled()} method affects the camera for the calling user only; calling it from the managed profile doesn’t -affect camera apps running on the primary user. In addition, the +affect camera apps running on the primary user.
      • +
    • In addition, the {@link android.app.admin.DevicePolicyManager#setKeyguardDisabledFeatures(android.content.ComponentName,int) setKeyguardDisabledFeatures()} -method is now available for Profile Owners, in addition to Device Owners. A Profile Owner can set -these keyguard restrictions: -
        -
      • {@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_TRUST_AGENTS} and + method is now available for Profile Owners, in addition to Device Owners.
        • +
      • A Profile Owner can set these keyguard restrictions: +
          +
        • {@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_TRUST_AGENTS} and {@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_FINGERPRINT}, which affect the keyguard settings for the profile’s parent user.
          • -
        • {@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_UNREDACTED_NOTIFICATIONS}, which +
        • {@link android.app.admin.DevicePolicyManager#KEYGUARD_DISABLE_UNREDACTED_NOTIFICATIONS}, which only affects notifications generated by applications in the managed profile.
          • +
        +
        • +
      • The {@link android.app.admin.DevicePolicyManager#createAndInitializeUser(android.content.ComponentName, java.lang.String, java.lang.String, android.content.ComponentName, android.os.Bundle)} and {@link android.app.admin.DevicePolicyManager#createUser(android.content.ComponentName, java.lang.String) methods createAndInitializeUser have been deprecated.
        • +
      • Android for Work APIs are optimized for M runtime permssions, including Work profiles, assist layer, and others. DevicePolicyManager APIs support runtime permissions without affecting pre-M apps.
        • +
      +
    • Changes to global settings — the settings below can no longer be set via setGlobalSettings: +
        +
      • BLUETOOTH_ON
        • +
      • DEVELOPMENT_SETTINGS_ENABLED
        • +
      • MODE_RINGER
        • +
      • NETWORK_PREFERENCE
        • +
      • WIFI_ON
      -
      • -
    +
    • + + + + + diff --git a/docs/html/preview/index.jd b/docs/html/preview/index.jd index 68186bd..022838b 100644 --- a/docs/html/preview/index.jd +++ b/docs/html/preview/index.jd @@ -28,6 +28,10 @@ footer.hide=1 Get started
    + + + Update to Developer Preview 2 +
    diff --git a/docs/html/preview/support.jd b/docs/html/preview/support.jd index f05fa98..90da200 100644 --- a/docs/html/preview/support.jd +++ b/docs/html/preview/support.jd @@ -1,72 +1,334 @@ page.title=Support +page.tags="preview", "developer preview" page.image=images/cards/card-support_16-9_2x.png @jd:body +
    +

    + Developer Preview 2 is now available +

    + + +
    +

    - If you've encountered bugs or have feedback about the M Developer Preview, - create an issue - on our issue tracker. + Two primary support channels are available to you when developing and testing + with the Android M Developer Preview. If you've encountered bugs or have + feedback about the M Developer Preview, you can create an issue on + our issue tracker. We'll triage the issue for further review and provide + updates as needed.

    - For more support, join the - M Developer - Preview Google+ community to discuss your development experiences. + To discuss issues or ideas with other developers working with Android M, join + the M Developer Preview Google+ + community.

    -

    Release Notes

    - -
    -

    - M Developer Preview 2 (July 2015) -

    - -
    - -
    - -
    API Name Changes:
    -
    -
      -
    • Moved the {@code android.app.AssistContent} class into the new package, - {@code android.app.assist} in the Assist API. The full class - name is now {@code android.app.assist.AssistContent}.
      • -
    • Moved the {@code android.app.AssistStructure} class to the new package, - {@code android.app.assist} in the Assist API. The full class name - is now {@code android.app.assist.AssistStructure}.
      • -
    • Replaced the {@code ScanResult.PasspointNetwork} property with the - {@code ScanResult.isPasspointNetwork()} method for HotSpot 2.0 support.
      • -
    • Replaced the {@code InputDevice.hasMic()} method with {@code InputDevice.hasMicrophone()} - for the Audio API.
      • -
    • Renamed the {@code View.OnStylusButtonPressListener} class to - {@code View.OnContextClickListener} for Bluetooth Stylus support.
      • -
    • Renamed the {@code GestureDetector.OnStylusButtonPressListener} class to - {@code GestureDetector.OnContextClickListener} for Bluetooth Stylus support.
      • -
    • Renamed the {@code android.app.usage.NetworkUsageStats} class to - {@code android.app.usage.NetworkStats}.
      • -
    • Renamed the {@code android.app.usage.NetworkUsageStats.Bucket} class to - {@code android.app.usage.NetworkStats.Bucket}.
      • -
    -
    - -
    +

    + Developer Preview 2 +

    + +
    +
    +
    +

    + Date: July 2015
    + Build: MPZ79M
    + Hardware support: Nexus 5,6,9, Player
    + Emulator support: ARM 32/64-bit
    + Google Play services: 7.5     +

    +
    -
    -

    - M Developer Preview 1 (May 2015) -

    +

    + Android M Developer Preview 2 is an incremental update to + the Android M preview platform that was originally released in May 2015. The + update includes a variety of enhancements and bug fixes made across the + system, including those related to issues reported by developers through the + external issue tracker. +

    + +

    + If you are currently developing or testing on Android M, you should + update your environment to Developer Preview 2 as soon as + possible. This ensures that you are building with the latest platform APIs + and testing against the latest behaviors. If you are just getting started + with the Android M Developer Preview SDK, follow the instructions in Set up the Preview SDK, then update your + environment for Developer Preview 2. +

    + +

    + What's included +

    + +

    + Developer Preview 2 includes an updated SDK with system images, + documentation, and samples for developing against the latest Android M + platform. +

    + +
      +
    • + SDK platform and system images (Nexus and + emulator) for building and testing. You can download the updated tools from + the SDK Manager, and the system images are available by over-the-air (OTA) + update or download (see below). +
      • + +
    • + Updated documentation. The Behavior Changes, API Overview, and Permissions documents have + been updated to reflect the latest changes in the platform. An updated + Developer Documentation download + package is available, including full reference docs and API diff + reports. +
      • + +
    • + Translations of the documentation are now available. Use + the language selector at the bottom right corner of any page to switch + languages. Note that some of the translated docs are not yet updated for + Developer Preview 2 (coming soon). +
      • + +
    • The Android M code samples are also + updated to account for API and behavior changes: + +
      • +
    + +

    + Key changes +

    + +
      +
    • Permissions changes +
        +
      • The android.permission.USE_FINGERPRINT permission now + has "normal" protection level, so it is no longer necessary to request + this permission directly from the user. The USE_FINGERPRINT + permission enables fingerprints to be enabled for authentication, but + does not give the requesting app access to the enrollment/fingerprint + administration flow. +
        • + +
      • The android.permission.WRITE_EXTERNAL_STORAGE permission + has protection level "dangerous", meaning that apps wanting to write to + external storage will need to request permission from the user at + runtime. Both WRITE_EXTERNAL_STORAGE and + WRITE_EXTERNAL_STORAGE are members of the + STORAGE permission group. +
        • + +
      • Remote Bluetooth/Wi-Fi MAC's now require either the + android.permission.LOCATION_FINE or + android.permission.LOCATION_COURSE permission. +
        • + +
      • Some accounts and identity permissions are moved to + CONTACTS permissions group and others are removed or granted + based on account type. In particular, + android.permission.USE_CREDENTIALS, + android.permission.MANAGE_ACCOUNTS, and + android.permission.AUTHENTICATE_ACCOUNTS are ungrouped + pending further changes in a later release. +
        • + +
      • The Wi-Fi permissions + android.permission.CHANGE_WIFI_STATE, + android.permission.CHANGE_WIMAX_STATE, and + android.permission.CHANGE_WIFI_MULTICAST_STATE now have + protection level "normal". +
        • + +
      • The Bluetooth permissions android.permission.BLUETOOTH + and android.permission.BLUETOOTH_ADMIN now have protection + level "normal". +
        • + +
      • Bookmarks and subscribed feeds permissions are removed. +
        • + +
      • Apps included in the system image are no longer granted dangerous + permissions automatically. All apps should check for and request + permissions at runtime. +
        • + +
      • Introduces the utility method + Activity.shouldShowRequestPermissionRationale(String), which + lets your app see whether users have previously rejected a permission + request. This lets you know that your app should explain the the user why + it needs that permission. For more information see the Permissions + developer guide. +
        • +
      +
      • + +
    • Other changes +
        +
      • The android.app.AssistContent and + android.app.AssistStructure classes are moved into a new + package, android.app.assist. +
        • -
        +
      • Bluetooth Stylus APIs are updated and include new callback events. + The View.OnStylusButtonPressListener class is renamed to + View.OnContextClickListener and + GestureDetector.OnStylusButtonPressListener class to + GestureDetector.OnContextClickListener. +
        • +
      +
      • +
    -
    -
    Initial release.
    -
    +

    + For a complete list of changes, including renamed and removed APIs, please + refer to the API Diff Reports included in the Developer Documentation download package. +

    + +

    + Known issues +

    + +
      +
    • The system Messenger app crashes on the 64-bit emulator. +
      • + +
    • After updating to Developer Preview 2, Contacts sync experiences + intermittent issues. The workaround is to clear and re-sync Contact Storage + data after update. To clear data, go to Settings > Apps > Show + system > Contacts Storage. Select "Storage" and then + Clear data. +
      • + +
    • In YouTube app, it's not possible to share a video. The share window is + blank. +
      • + +
    • Android For Work Profile setup is not working properly, so you won't be + able to create a new Work Profile after you update. As a workaround, make + sure to create the Work Profiles you need in Developer Preview 1 before + updating to Developer Preview 2. +
      • +
    + +

    + For a complete list of reported issues, please refer to the open issues list on the + Developer Preview issue tracker. +

    + +

    + Get Developer Preview 2 +

    + +

    + You can download the Developer Preview 2 platform and emulator images from + the SDK Manager. +

    + +

    + 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 + the OTA update within a few days of availability. +

    + +

    + If you are just getting started with Android M Developer Preview you want to + receive Developer Preview 2 by OTA, first download Developer Preview 1 and + flash it to your device. Leave the device powered on for several hours until + the device is registered and receives the update. +

    + +

    + For instructions on how to download and flash your device to the Developer + Preview, see the links and instructions on the Downloads page. +

    + +

    + For instructions on how to start developing and testing with Android M, read + Setting up the SDK +

    + +

    + Developer Preview 1 +

    + +
    +
    +
    +

    + Date: May 2015
    + Build: MPZ44Q
    + Hardware support: Nexus 5,6,9, Player
    + Emulator support: x86 & ARM (32/64-bit)
    + Google Play services: 7.5     +

    +
    +

    + Initial release. +

    + -- cgit v1.1