Merge "docs: Migrated M Preview main landing, API overview, Behavior Changes,...

<ul id="nav">

    <li class="nav-section">

    <div class="nav-section-header"><a href="<?cs var:toroot ?>about/versions/marshmallow/index.html">

      <span class="en">Marshmallow</span></a></div>

      <ul>

        <li><a href="<?cs var:toroot ?>about/versions/marshmallow/android-6.0.html">

        Android 6.0 APIs</a></li>

        <li><a href="<?cs var:toroot ?>about/versions/marshmallow/android-6.0-changes.html">

        Android 6.0 Changes</a></li>

        <li><a href="<?cs var:toroot ?>about/versions/marshmallow/testing.html">Testing</a></li>

        <li><a href="<?cs var:toroot ?>about/versions/marshmallow/samples.html">Samples</a></li>

        <li><a href="<?cs var:toroot ?>about/versions/marshmallow/download.html">Downloads</a></li>

  </li>

      </ul>

  </li>

  <li class="nav-section">

    <div class="nav-section-header"><a href="<?cs var:toroot ?>about/versions/lollipop.html"

              zh-tw-lang="Lollipop"

page.title=Behavior Changes

page.keywords=preview,sdk,compatibility

sdk.platform.apiLevel=MNC

page.title=Android 6.0 Changes

page.keywords=androidm,sdk,compatibility,marshmallow

sdk.platform.apiLevel=23

@jd:body

<div id="qv-wrapper">

<h2>API Differences</h2>

<ol>

<li><a href="{@docRoot}preview/download.html">API level 22 to M Preview &raquo;</a> </li>

<li><a href="{@docRoot}about/versions/marshmallow/download.html">API level 22 to 23 &raquo;</a> </li>

</ol>

<h2>See Also</h2>

<ol>

<li><a href="{@docRoot}preview/api-overview.html">M Developer Preview API Overview</a> </li>

<li><a href="{@docRoot}about/versions/marshmallow/android-6.0.html">Android 6.0 API Overview</a> </li>

</ol>

</div>

</div>

<p>Along with new features and capabilities, the M Developer Preview includes a variety of

<p>Along with new features and capabilities, Android 6.0 (API level 23) includes a variety of

system changes and API behavior changes. This document highlights

some of the key changes that you should understand and account for in your apps.</p>

platform affect your app.</p>

<h2 id="behavior-runtime-permissions">Runtime Permissions</h1>

<p>This preview introduces a new permissions model, where users can now directly manage

<p>This release 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 grant or revoke permissions individually for installed apps. </p>

<p>On your apps that target the M Preview release or higher, make sure to check for and request

<p>On your apps that target Android 6.0 (API level 23) or higher, make sure to check for and request

permissions at runtime. To determine if your app has been granted a permission, call the

new {@link android.content.Context#checkSelfPermission(java.lang.String) checkSelfPermission()}

method. To request a permission, call the new

{@link android.app.Activity#requestPermissions(java.lang.String[], int) requestPermissions()}

method. Even if your app is not targeting the M Preview release, you should test your app under

method. Even if your app is not targeting Android 6.0 (API level 23), you should test your app under

the new permissions model.</p>

<p>For details on supporting the new permissions model in your app, see the

<a href="{@docRoot}preview/features/runtime-permissions.html">

Permissions</a> developer preview page. For tips on how to assess the impact on your app,

see the <a href="{@docRoot}preview/testing/guide.html#runtime-permissions">Testing Guide</a></p>

<a href="{@docRoot}training/permissions/index.html">

Permissions</a> training page. For tips on how to assess the impact on your app,

see the <a href="{@docRoot}about/versions/marshmallow/testing.html">Testing Guide</a></p>

<h2 id="behavior-power">Power-Saving Optimizations</h2>

<p>This preview introduces new power-saving optimizations for idle devices and apps.</p>

<p>This release introduces new power-saving optimizations for idle devices and apps.</p>

<ul>

<li><strong>Doze</strong>: If a user unplugs a device and leaves it stationary, with its screen off,

for a period of time, the device goes into <em>Doze</em> mode, where it attempts to keep the system

</ul>

<p>To learn more about these power-saving changes, see

<a href="{@docRoot}preview/features/power-mgmt.html">Power-Saving Optimizations</a>.</p>

<a href="{@docRoot}training/monitoring-device-state/battery-monitoring.html">Monitoring the

Battery Level and Charging State</a>.</p>

<h2 id="behavior-adoptable-storage">Adoptable Storage Devices</h2>

<p>

With this preview, users can <em>adopt</em> external storage devices such as SD cards. Adopting an

With this release, users can <em>adopt</em> external storage devices such as SD cards. Adopting an

external storage device encrypts and formats the device to behave like internal storage. This

feature allows users to move both apps and private data of those apps between storage devices. When

moving apps, the system respects the

</li>

</ul>

<p>To debug this feature in the developer preview, you can enable adoption of a USB drive that is

<p>To debug this feature, you can enable adoption of a USB drive that is

connected to an Android device through a USB On-The-Go (OTG) cable, by running this command:</p>

<pre class="no-prettyprint">

</pre>

<h2 id="behavior-apache-http-client">Apache HTTP Client Removal</h2>

<p>This preview removes support for the Apache HTTP client. If your app is using this client and

<p>This release removes support for the Apache HTTP client. If your app is using this client and

targets Android 2.3 (API level 9) or higher, use the {@link java.net.HttpURLConnection} class

instead. This API is more efficient because it reduces network use through transparent compression

and response caching, and minimizes power consumption. To continue using the Apache HTTP APIs, you

<h2 id="behavior-test-selection">Text Selection</h2>

<img src="{@docRoot}preview/images/text-selection.gif"

<img src="{@docRoot}images/android-6.0/text-selection.gif"

style="float:right; margin:0 0 20px 30px" width="360" height="640" />

<p>When users select text in your app, you can now display text selection actions such as

<p>If you are using <a href="{@docRoot}tools/support-library/index.html">

Android Support Library</a> revision 22.2, be aware that floating toolbars are not

backward-compatible and appcompat takes control over {@link android.view.ActionMode} objects by

backward-compatible and appcompat takes control over {@link android.view.ActionMode} objects bywith th

default. This prevents floating toolbars from being displayed. To enable

{@link android.view.ActionMode} support in an

{@link android.support.v7.app.AppCompatActivity}, call

setHandleNativeActionModesEnabled()} on the returned

{@link android.support.v7.app.AppCompatDelegate} object and set the input

parameter to {@code false}. This call returns control of {@link android.view.ActionMode} objects to

the framework. In devices running the M Preview, that allows the framework to support

{@link android.support.v7.app.ActionBar} or floating toolbar modes, while on pre-M Preview devices,

only the {@link android.support.v7.app.ActionBar} modes are supported.</p>

the framework. In devices running Android 6.0 (API level 23), that allows the framework to support

{@link android.support.v7.app.ActionBar} or floating toolbar modes, while on devices running

Android 5.1 (API level 22) or lower, only the {@link android.support.v7.app.ActionBar} modes are

supported.</p>

<h2 id="behavior-keystore">Android Keystore Changes</h2>

<p>With this preview, the

<p>With this release, the

<a href="{@docRoot}training/articles/keystore.html">Android Keystore provider</a> no longer supports

DSA. ECDSA is still supported.</p>

<h2 id="behavior-network">Wi-Fi and Networking Changes</h2>

<p>This preview introduces the following behavior changes to the Wi-Fi and networking APIs.</p>

<p>This release introduces the following behavior changes to the Wi-Fi and networking APIs.</p>

<ul>

<li>Your apps can now change the state of {@link android.net.wifi.WifiConfiguration} objects only

if you created these objects. You are not permitted to modify or delete

Previously, if an app forced the device to connect to a specific Wi-Fi network by using

{@link android.net.wifi.WifiManager#enableNetwork(int,boolean) enableNetwork()} with the

{@code disableAllOthers=true} setting, the device disconnected from other networks such as

cellular data. In this preview, the device no longer disconnects from such other networks. If

cellular data. In This release, the device no longer disconnects from such other networks. If

your app’s {@code targetSdkVersion} is {@code “20”} or lower, it is pinned to the selected

Wi-Fi network. If your app’s {@code targetSdkVersion} is {@code “21”} or higher, use the

multinetwork APIs (such as

</ul>

<h2 id="behavior-camera">Camera Service Changes</h2>

<p>In this preview, the model for accessing shared resources in the camera service has been changed

<p>In This release, the model for accessing shared resources in the camera service has been changed

from the previous “first come, first serve” access model to an access model where high-priority

processes are favored.  Changes to the service behavior include:</p>

<ul>

you must update your app to use to the latest versions of these libraries. Otherwise, make sure that

any custom classes referenced from XML are updated so that their class constructors are accessible.</p>

<p>This preview updates the behavior of the dynamic linker. The dynamic linker now understands the

<p>This release updates the behavior of the dynamic linker. The dynamic linker now understands the

difference between a library’s {@code soname} and its path

(<a href="https://code.google.com/p/android/issues/detail?id=6670" class="external-link">

public bug 6670</a>), and search by {@code soname} is now

{@link android.Manifest.permission#ACCESS_COARSE_LOCATION} permission.</li>

</ul>

<p class="note"><strong>Note</strong>: When a device running M Developer Preview initiates a

<p class="note"><strong>Note</strong>: When a device running Android 6.0 (API level 23) initiates a

background Wi-Fi or Bluetooth scan, the operation is visible to external devices as

originating from a randomized MAC address.</p>

</p>

<h2 id="behavior-afw">Android for Work Changes</h2>

<p>This preview includes the following behavior changes for Android for Work:</p>

<p>This release includes the following behavior changes for Android for Work:</p>

<ul>

  <li><strong>Work contacts in personal contexts.</strong> The Google Dialer

Call Log now displays work contacts when the user views past calls.

in future.

{@link android.app.admin.DevicePolicyManager#EXTRA_PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM}

now only accepts SHA-256.</li>

  <li>Device initializer APIs which existed in the M Developer Preview are now removed.</li>

  <li>Device initializer APIs which existed in the Android 6.0 (API level 23) are now removed.</li>

    <li><code>EXTRA_PROVISIONING_RESET_PROTECTION_PARAMETERS</code> is removed so NFC bump

provisioning cannot programmatically unlock a factory reset protected device.</li>

<li>You can now use the {@link android.app.admin.DevicePolicyManager#EXTRA_PROVISIONING_ADMIN_EXTRAS_BUNDLE}

page.title=API Overview

page.keywords=preview,sdk,compatibility

page.tags=previewresources, androidm

sdk.platform.apiLevel=22-mnc

page.title=Android 6.0 APIs

page.keywords=marshmallow,sdk,compatibility

page.tags=androidm

sdk.platform.apiLevel=23

page.image=images/cards/card-api-overview_16-9_2x.png

@jd:body

<h2>API Differences</h2>

<ol>

<li><a href="{@docRoot}sdk/api_diff/23/changes.html">API level 22 to 23 (Preview 3) &raquo;</a> </li>

<li><a href="{@docRoot}sdk/api_diff/23/changes.html">API level 22 to 23 &raquo;</a> </li>

</ol>

</div>

</div>

<p>The M Developer Preview gives you an advance look at the upcoming release

for the Android platform, which offers new features for users and app

developers. This document provides an introduction to the most notable APIs.</p>

<p>Android 6.0 (<a href="{@docRoot}reference/android/os/Build.VERSION_CODES.html#MARSHMALLOW">MARSHMALLOW</a>)

offers new features for users and app developers. This document provides an introduction to the

most notable APIs.</p>

<p>

  The M Developer Preview 3 release includes the <strong>final APIs for Android 6.0 (API level

  23)</strong>. If you are preparing an app for use on Android 6.0,

  <a href="{@docRoot}preview/setup-sdk.html">download the latest SDK</a> and to complete your

  final updates and release testing. You can review the final APIs in the

  <a href="{@docRoot}reference/packages.html">API Reference</a> and see the API differences in

  the <a href="{@docRoot}sdk/api_diff/23/changes.html">Android API Differences Report</a>.

</p>

<h3 id="Start">Start developing</h3>

</p>

<p>To start building apps for Android 6.0, you must first <a href="{@docRoot}sdk/index.html">get

the Android SDK</a>. Then use the <a href="{@docRoot}tools/help/sdk-manager.html">SDK Manager</a>

to download the Android 6.0 SDK Platform and System Images.</p>

<p class="caution"><strong>Important:</strong>

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

</p>

<p class="note"><strong>Note:</strong>

  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 <a href="{@docRoot}preview/download.html#docs">preview docs

  reference</a>.

</p>

<h3 id="ApiLevel">Update your target API level</h3>

<p>To better optimize your app for devices running Android {@sdkPlatformVersion},

  set your <a

href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#target">{@code targetSdkVersion}</a> to

<code>"{@sdkPlatformApiLevel}"</code>, install your app on an Android

{@sdkPlatformVersion} system image, test it, then publish the updated app with

this change.</p>

<p>You can use Android {@sdkPlatformVersion} APIs while also supporting older

versions by adding conditions to your code that check for the system API level

before executing APIs not supported by your <a

href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code minSdkVersion}</a>.

To learn more about maintaining backward compatibility, read <a

href="{@docRoot}training/basics/supporting-devices/platforms.html">Supporting

Different Platform Versions</a>.</p>

<p>For more information about how API levels work, read <a

href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">What is API

Level?</a></p>

<h3>Important behavior changes</h3>

<p>If you have previously published an app for Android, be aware that your app might be affected

by changes in the platform.</p>

<p>Please see <a href="behavior-changes.html">Behavior Changes</a> for complete information.</p>

<p>Please see <a href="android-6.0-changes.html">Android 6.0 Changes</a> for complete information.</p>

<h2 id="app-linking">App Linking</h2>

<p>This preview enhances Android’s intent system by providing more powerful app linking.

<p>This release enhances Android’s intent system by providing more powerful app linking.

This feature allows you to associate an app with a web domain you own. Based on this

association, the platform can determine the default app to use to handle a particular

web link and skip prompting users to select an app. To learn how to implement this feature, see

<a href="{@docRoot}preview/features/app-linking.html">App Linking</a>.

web link and skip prompting users to select an app. To learn how to implement this feature, see the

<a href="{@docRoot}training/app-links/app-linking.html">App Linking</a> training.

<h2 id="backup">Auto Backup for Apps</h2>

<p>The system now performs automatic full data backup and restore for apps. For the

duration of the <a href="{@docRoot}preview/overview.html">M Developer Preview program</a>, all

apps are backed up, independent of which SDK version they target. After the final M SDK release,

your app must target M to enable this behavior; you do not need to add any additional code. If users

delete their Google accounts, their backup data is deleted as well. To learn how this feature

works and how to configure what to back up on the file system, see

<a href="{@docRoot}preview/backup/index.html">Auto Backup for Apps</a>.</p>

<p>The system now performs automatic full data backup and restore for apps. Your app must target

  Android 6.0 (API level 23) to enable this behavior; you do not need to add any additional code.

  If users delete their Google accounts, their backup data is deleted as well. To learn how this

  feature works and how to configure what to back up on the file system, see the

  <a href="{@docRoot}training/backup/auto-backup.html">Auto Backup for Apps</a> training.</p>

<h2 id="authentication">Authentication</h2>

<p>This preview offers new APIs to let you authenticate users by using their fingerprint scans on

<p>This release offers new APIs to let you authenticate users by using their fingerprint scans on

supported devices, and check how recently the user was last authenticated using a device unlocking

mechanism (such as a lockscreen password). Use these APIs in conjunction with

the <a href="{@docRoot}training/articles/keystore.html">Android Keystore system</a>.</p>

<uses-permission

        android:name="android.permission.USE_FINGERPRINT" />

</pre>

<img src="{@docRoot}preview/images/fingerprint-screen.png"

srcset="{@docRoot}preview/images/fingerprint-screen.png 1x, {@docRoot}preview/images/fingerprint-screen_2x.png 2x"

<img src="{@docRoot}images/android-6.0/fingerprint-screen.png"

srcset="{@docRoot}images/android-6.0/fingerprint-screen.png 1x, {@docRoot}images/android-6.0/fingerprint-screen_2x.png 2x"

style="float:right; margin:0 0 10px 20px" width="282" height="476" />

<p>To see an app implementation of fingerprint authentication, refer to the

<h2 id="direct-share">Direct Share</h2>

<img src="{@docRoot}preview/images/direct-share-screen.png"

srcset="{@docRoot}preview/images/direct-share-screen.png 1x, {@docRoot}preview/images/direct-share-screen_2x.png 2x"

<img src="{@docRoot}images/android-6.0/direct-share-screen.png"

srcset="{@docRoot}images/android-6.0/direct-share-screen.png 1x, {@docRoot}images/android-6.0/direct-share-screen_2x.png 2x"

style="float:right; margin:0 0 20px 30px" width="312" height="329" />

<p>This preview provides you with APIs to make sharing intuitive and quick for users. You can now

<p>This release provides you with APIs to make sharing intuitive and quick for users. You can now

define <em>direct share targets</em> that launch a specific activity in your app. These direct share

targets are exposed to users via the <em>Share</em> menu. This feature allows users to share

content to targets, such as contacts, within other apps. For example, the direct share target might

<h2 id="voice-interactions">Voice Interactions</h2>

<p>

This preview provides a new voice interaction API which, together with

This release provides a new voice interaction API which, together with

<a href="https://developers.google.com/voice-actions/" class="external-link">Voice Actions</a>,

allows you to build conversational voice experiences into your apps. Call the

{@link android.app.Activity#isVoiceInteraction()} method to determine if a voice action triggered

<h2 id="assist">Assist API</h2>

<p>

This preview offers a new way for users to engage with your apps through an assistant. To use this

This release offers a new way for users to engage with your apps through an assistant. To use this

feature, the user must enable the assistant to use the current context. Once enabled, the user

can summon the assistant within any app, by long-pressing on the <strong>Home</strong> button.</p>

<p>Your app can elect to not share the current context with the assistant by setting the

</ol>

<h2 id="notifications">Notifications</h2>

<p>This preview adds the following API changes for notifications:</p>

<p>This release adds the following API changes for notifications:</p>

<ul>

  <li>New {@link android.app.NotificationManager#INTERRUPTION_FILTER_ALARMS} filter level that

    corresponds to the new <em>Alarms only</em> do not disturb mode.</li>

</ul>

<h2 id="bluetooth-stylus">Bluetooth Stylus Support</h2>

<p>This preview provides improved support for user input using a Bluetooth stylus. Users can pair

<p>This release provides improved support for user input using a Bluetooth stylus. Users can pair

and connect a compatible Bluetooth stylus with their phone or tablet.  While connected, position

information from the touch screen is fused with pressure and button information from the stylus to

provide a greater range of expression than with the touch screen alone. Your app can listen for

<li>If the user touches a stylus with a button on the screen of your app, the

{@link android.view.MotionEvent#getToolType(int) getTooltype()} method returns

{@link android.view.MotionEvent#TOOL_TYPE_STYLUS}.</li>

<li>For apps targeting M Preview, the

<li>For apps targeting Android 6.0 (API level 23), the

{@link android.view.MotionEvent#getButtonState() getButtonState()}

method returns {@link android.view.MotionEvent#BUTTON_STYLUS_PRIMARY} when the user

presses the primary stylus button. If the stylus has a second button, the same method returns

<h2 id="hotspot">Hotspot 2.0 Release 1 Support</h2>

<p>

This preview adds support for the Hotspot 2.0 Release 1 spec on Nexus 6 and Nexus 9 devices. To

This release adds support for the Hotspot 2.0 Release 1 spec on Nexus 6 and Nexus 9 devices. To

provision Hotspot 2.0 credentials in your app, use the new methods of the

{@link android.net.wifi.WifiEnterpriseConfig} class, such as

{@link android.net.wifi.WifiEnterpriseConfig#setPlmn(java.lang.String) setPlmn()} and

<h2 id="behavior-themeable-colorstatelists">Themeable ColorStateLists</h2>

<p>Theme attributes are now supported in

{@link android.content.res.ColorStateList} for devices running the M Preview. The

{@link android.content.res.ColorStateList} for devices running on Android 6.0 (API level 23). The

{@link android.content.res.Resources#getColorStateList(int) getColorStateList()} and

{@link android.content.res.Resources#getColor(int) getColor()} methods have been deprecated. If

you are calling these APIs, call the new

<h2 id="audio">Audio Features</h2>

<p>This preview adds enhancements to audio processing on Android, including: </p>

<p>This release adds enhancements to audio processing on Android, including: </p>

<ul>

  <li>Support for the <a href="http://en.wikipedia.org/wiki/MIDI" class="external-link">MIDI</a>

protocol, with the new {@link android.media.midi} APIs. Use these APIs to send and receive MIDI

</ul>

<h2 id="video">Video Features</h2>

<p>This preview adds new capabilities to the video processing APIs, including:</p>

<p>This release adds new capabilities to the video processing APIs, including:</p>

<ul>

<li>New {@link android.media.MediaSync} class which helps applications to synchronously render

audio and video streams. The audio buffers are submitted in non-blocking fashion and are

</ul>

<h2 id="camera">Camera Features</h2>

<p>This preview includes the following new APIs for accessing the camera’s flashlight and for

<p>This release includes the following new APIs for accessing the camera’s flashlight and for

camera reprocessing of images:</p>

<h3 id="flashlight">Flashlight API</h3>

more images, and send them to the {@link android.media.ImageWriter} for camera reprocessing.</p>

<h2 id="afw">Android for Work Features</h2>

<p>This preview includes the following new APIs for Android for Work:</p>

<p>This release includes the following new APIs for Android for Work:</p>

<ul>

  <li><strong>Enhanced controls for Corporate-Owned, Single-Use devices:</strong> The Device Owner

can now control the following settings to improve management of

installKeyPair()}</li>

</ul>

</li>

<img src="{@docRoot}preview/images/work-profile-screen.png"

srcset="{@docRoot}preview/images/work-profile-screen.png 1x, {@docRoot}preview/images/work-profile-screen_2x.png 2x"

<img src="{@docRoot}images/android-6.0/work-profile-screen.png"

srcset="{@docRoot}images/android-6.0/work-profile-screen.png 1x, {@docRoot}images/android-6.0/work-profile-screen_2x.png 2x"

style="float:right; margin:0 0 10px 20px" width="282" height="476" />

<li><strong>Data usage tracking.</strong> A Profile or Device Owner can now query for the

data usage statistics visible in <strong>Settings > Data</strong> usage by using the new

the user that they are within the work profile.

</li>

</ul>

<p class="note">

  For a detailed view of all API changes in the M Developer Preview, see the <a href=

  "{@docRoot}preview/download.html">API Differences Report</a>.

</p>