From c958c77f1add6ad60d9a25efddee772a8d0a1e26 Mon Sep 17 00:00:00 2001 From: Jeff Sharkey Date: Mon, 30 Jan 2012 16:29:24 -0800 Subject: [PATCH] Deprecate ACTION_BACKGROUND_DATA_SETTING_CHANGED. Broadcast is no longer sent, except during first boot after platform upgrade. Change-Id: I7a9c105b5783ca9f9c3aca2efff6fe5c13a4c1fd --- core/java/android/net/ConnectivityManager.java | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/core/java/android/net/ConnectivityManager.java b/core/java/android/net/ConnectivityManager.java index a569317e25..2eef8f441b 100644 --- a/core/java/android/net/ConnectivityManager.java +++ b/core/java/android/net/ConnectivityManager.java @@ -142,8 +142,19 @@ public class ConnectivityManager { * If an application uses the network in the background, it should listen * for this broadcast and stop using the background data if the value is * {@code false}. + *

+ * + * @deprecated As of {@link VERSION_CODES#ICE_CREAM_SANDWICH}, availability + * of background data depends on several combined factors, and + * this broadcast is no longer sent. Instead, when background + * data is unavailable, {@link #getActiveNetworkInfo()} will now + * appear disconnected. During first boot after a platform + * upgrade, this broadcast will be sent once if + * {@link #getBackgroundDataSetting()} was {@code false} before + * the upgrade. */ @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) + @Deprecated public static final String ACTION_BACKGROUND_DATA_SETTING_CHANGED = "android.net.conn.BACKGROUND_DATA_SETTING_CHANGED";