Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Docs: Added new Whitelist feature to Data Saver for DP3 (Part 2)" into mnc-io-docs

Browse Source 
am: d5ef1ef028

* commit 'd5ef1ef028d5d7e529746206aa72f4cd65edd55b':
  Docs: Added new Whitelist feature to Data Saver for DP3 (Part 2)

Change-Id: Ic32c9e030b2a287bba161716f67788e740b78433
This commit is contained in:
Adarsh Fernando
2016-05-13 00:49:26 +00:00
committed by android-build-merger
parent a32ad7464d d5ef1ef028
commit ac5dc2f581
1 changed files with 11 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/html/preview/features/data-saver.jd
View File

@@ -14,7 +14,7 @@ page.keywords="android N", "data usage", "metered network"
<a href="#status">Checking Data Saver Preferences</a>
<ol>
<li>
<a href="#request-whitelist">Requesting Whitelist Permissions</a>
<a href="#request-whitelist">Requesting whitelist permissions</a>
</li>
</ol>
</li>
@@ -138,15 +138,17 @@ if (connMgr.isActiveNetworkMetered()) {
If your app needs to use data in the background, it can request whitelist
permissions by sending a
<code>Settings.ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS</code>
(<code>"android.settings.IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS"</code>)
intent with a <code>package:&lt;your-app-id&gt;</code> URI.
intent containing a URI of your app's package name: for example,
<code>package:MY_APP_ID</code>.
</p>
<p>
Sending the intent and URI launches the <strong>Settings</strong> app, and
displays your app's <strong>App Data Usage</strong> page to the user. The
user can then decide whether to enable background data for your app.
It is good practice to prompt the user before sending this intent.
Sending the intent and URI launches the <strong>Settings</strong> app and
displays data usage settings for your app. The user can then decide whether
to enable background data for your app. Before you send this intent, it is
good practice to first ask the user if they want to launch the
<strong>Settings</strong> app for the purpose of enabling background data
usage.
</p>
<h2 id="monitor-changes">
@@ -156,9 +158,8 @@ if (connMgr.isActiveNetworkMetered()) {
<p>
Apps can monitor changes to Data Saver preferences by creating a {@link
android.content.BroadcastReceiver} to listen for {@code
ConnectivityManager.ACTION_RESTRICT_BACKGROUND_CHANGED} ({@code
"android.net.conn.RESTRICT_BACKGROUND_CHANGED"}) and dynamically registering
the receiver with {@link android.content.Context#registerReceiver
ConnectivityManager.ACTION_RESTRICT_BACKGROUND_CHANGED} and dynamically
registering the receiver with {@link android.content.Context#registerReceiver
Context.registerReceiver()}. When an app receives this broadcast, it should
<a href="#status">check if the new Data Saver preferences affect its
permissions</a> by calling {@code