Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 2cbcb12c authored by David Friedman's avatar David Friedman Committed by Android (Google) Code Review
Browse files

Merge "Docs: File-migration (content changes follow in separate CL) for 6.0... 

Merge "Docs: File-migration (content changes follow in separate CL) for 6.0 release Bugs: 23725346, 23623580, 23623573" into mnc-mr-docs
parents 48a94385 a5775694

docs/html/preview/features/power-mgmt.jd

deleted100644 → 0
+0 −121
Original line number Diff line number Diff line 
page.title=Power-Saving Optimizations

page.keywords=preview,sdk,compatibility

sdk.platform.apiLevel=MNC

@jd:body



<div id="qv-wrapper">

<div id="qv">



<h2>In this document</h2>



<ol  class="hide-nested">

    <li><a href="#behavior-doze">Doze</a></li>

    <li><a href="#behavior-app-standby">App Standby</a></li>

</ol>



<h2>API Differences</h2>

<ol>

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

</ol>





<h2>See Also</h2>

<ol>

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

</ol>



</div>

</div>



<p>Android M Preview helps prolong battery life by introducing new power-saving optimizations:

<em>Doze</em> mode improves the sleep efficiency of idle devices. <em>App Standby</em> prevents apps

from eating up power while idle.</p>



<h2 id="behavior-doze">Doze</h2>

<p>If a user leaves a device unplugged and stationary for a period of time, with the screen off,

the device enters Doze mode. Doze attempts to keep the system in a sleep state as long as the

device remains undisturbed. In this mode, devices periodically resume normal operations for brief periods of time so that the system can perform app syncing and any other pending operations.</p>



<p>The following restrictions apply to your apps while in Doze:</p>

<ul>

<li>Network access is disabled, unless your app receives a high-priority

<a href="https://developers.google.com/cloud-messaging/" class="external-link">

Google Cloud Messaging</a> tickle.</li>

<li>The system ignores <a href="{@docRoot}reference/android/os/PowerManager.WakeLock.html">

Wake locks</a>.</li>

<li>Alarms scheduled using the {@link android.app.AlarmManager} class are deferred, unless you have

exempted them using the

{@link android.app.AlarmManager#setAndAllowWhileIdle setAndAllowWhileIdle()} method.</li>

<li>The system does not perform Wi-Fi scans.</li>

<li>The system does not permit syncs or jobs for your sync adapters.</li>

<li>The system does not allow {@link android.app.job.JobScheduler} to run.</li>

</ul>

</p>

<p>When the device exits Doze mode, it executes any jobs and syncs that are pending.</p>



<h3>Testing apps with Doze</h3>



<p>You can test Doze mode by connecting your development host to a device running the M Preview,

and calling the following commands:

</p>

<pre class="no-prettyprint">

$ adb shell dumpsys battery unplug

$ adb shell dumpsys deviceidle step

$ adb shell dumpsys deviceidle -h

</pre>

<p class="note"><strong>Note</strong>: As of M Preview 3 release,

<a href="https://developers.google.com/cloud-messaging/" class="external-link">

Google Cloud Messaging</a> (GCM) lets you designate

<a href="https://developers.google.com/cloud-messaging/downstream#setting-the-priority-of-a-message">

high-priority messages</a>. If your app receives a high-priority GCM message</a>, the system grants

brief network access even when the device is dozing.

</p>



<p>See the

<a href="{@docRoot}preview/testing/guide.html#doze-standby">Testing Guide</a> for tips on how

to test Doze in your apps. </p>



<h2 id="behavior-app-standby">App Standby</h2>

<p>App Standby allows the system to determine that an app is idle when the user is not actively

using it. The system makes this determination when the user does not touch the app for a certain

period of time, and none of the following conditions applies:</p>



<ul>

<li>The user explicitly launches the app.</li>

<li>The app has a process currently in the foreground (either as an activity or foreground service,

or in use by another activity or foreground service).</li>

<li>The app generates a notification that users see on the lock screen or in the

notification tray.</li>

<li>The user explicitly asks for the app to be exempt from optimizations,

via the Settings app.</li>

</ul>



<p>When the user plugs the device into a power supply, the system releases apps from the standby

state, allowing them to freely access the network and to execute any pending jobs and syncs. If the

device is idle for long periods of time, the system allows idle apps network access around once a

day.</p>



<h3>Testing apps with App Standby</h3>

<p>You can test App Standby by connecting your development host to a device running the M Preview,

and calling the following commands:

</p>

<pre class="no-prettyprint">

$ adb shell dumpsys battery unplug

$ adb shell am set-inactive &lt;packageName&gt; true

$ adb shell am set-inactive &lt;packageName&gt; false

$ adb shell am get-inactive &lt;packageName&gt;

</pre>



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

As of M Preview 3 release,

<a href="https://developers.google.com/cloud-messaging/" class="external-link">

Google Cloud Messaging</a> (GCM) lets you

designate

<a href="https://developers.google.com/cloud-messaging/downstream#setting-the-priority-of-a-message">

high-priority messages</a>. If your app receives high-priority GCM messages, the system grants

brief network access even when the app is idle.

</p>



<p>See the

<a href="{@docRoot}preview/testing/guide.html#doze-standby">Testing Guide</a> for tips on how

to test App Standby in your apps. </p>

docs/html/preview/features/app-linking.jd→docs/html/training/app-links/index.jd

+6 −5
Original line number Diff line number Diff line
@@ -3,9 +3,9 @@ page.image=images/cards/card-app-linking_2x.png 
page.keywords=applinking, deeplinks, intents

@jd:body



<div id="qv-wrapper">

  <div id="qv">

    <h2>In this document</h2>

<div id="tb-wrapper">

  <div id="tb">

    <h2>This lesson teaches you to</h2>

    <ol>

        <li><a href="#url-handling">Understanding URL Request Handling</a> </li>

        <li><a href="#intent-handler">Create an Intent Handler for URLs</a></li>
@@ -17,6 +17,7 @@ page.keywords=applinking, deeplinks, intents 
</div>







<p>

  The M Developer Preview introduces a new option for handling website links. It allows clicked

  links to go directly to the website's official app &mdash; instead of asking the user to choose

docs/html/preview/backup/index.jd→docs/html/training/backup/auto-backup.jd

+15 −9
Original line number Diff line number Diff line
@@ -4,18 +4,24 @@ page.keywords=backup, autobackup, preview 
page.image=images/cards/card-auto-backup_2x.png

@jd:body



<div id="qv-wrapper">

  <div id="qv">

    <h2>In this document</h2>

<div id="tb-wrapper">

  <div id="tb">

    <h2>This lesson teaches you to</h2>

    <ol>

        <li><a href="#overview">Overview</a></li>

        <li><a href="#configuring">Configuring Data Backup</a></li>

        <li><a href="#testing">Testing Backup Configuration</a></li>

        <li><a href="#issues">Known Issues</a></li>

        <li><a href="#configuring">Configure Data Backup</a></li>

        <li><a href="#testing">Test Backup Configuration</a></li>

        <li><a href="#issues">Anticipate Known Issues</a></li>

    </ol>

    <h2>You should also read</h2>

    <ul>

      <li><a

        href="http://developer.android.com/guide/topics/data/backup.html">Data

        Backup</a></li>

    </ul>

  </div>

</div>





<p>

  Users often invest significant time and effort creating data and setting preferences within

  apps. Preserving that data for users if they replace a broken device or upgrade to a new one is