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

Docs: Added new Whitelist feature to Data Saver for DP3 (Part 2)

Browse Source 
Bug: 28447739
Change-Id: Ibdbf0bd315fc228b076c5b91061bcb8080de96d3
This commit is contained in:
Adarsh Fernando
2016-05-12 15:18:14 -07:00
parent 9535aa73bf
commit b1386a73ac
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