Merge "Add setSubscriptionOverride() to system API" (f7343721) · Commits · e / os / android_frameworks_base

api/system-current.txt

+6 −0

Original line number	Diff line number	Diff line
		@@ -4602,6 +4602,12 @@ package android.net {
		field public final android.net.WifiKey wifiKey;
		}

		public class NetworkPolicyManager {
		method public void setSubscriptionOverride(int, int, int, long, @NonNull String);
		field public static final int SUBSCRIPTION_OVERRIDE_CONGESTED = 2; // 0x2
		field public static final int SUBSCRIPTION_OVERRIDE_UNMETERED = 1; // 0x1
		}

		public class NetworkProvider {
		ctor public NetworkProvider(@NonNull android.content.Context, @NonNull android.os.Looper, @NonNull String);
		method @RequiresPermission(android.Manifest.permission.NETWORK_FACTORY) public void declareNetworkRequestUnfulfillable(@NonNull android.net.NetworkRequest);

core/java/android/net/NetworkPolicyManager.java

+121 −14

Original line number	Diff line number	Diff line
		@@ -18,6 +18,9 @@ package android.net;

		import static android.content.pm.PackageManager.GET_SIGNATURES;

		import android.annotation.IntDef;
		import android.annotation.NonNull;
		import android.annotation.SystemApi;
		import android.annotation.SystemService;
		import android.app.ActivityManager;
		import android.compat.annotation.UnsupportedAppUsage;
		@@ -38,6 +41,8 @@ import android.util.Range;

		import com.google.android.collect.Sets;

		import java.lang.annotation.Retention;
		import java.lang.annotation.RetentionPolicy;
		import java.time.ZonedDateTime;
		import java.util.HashSet;
		import java.util.Iterator;
		@@ -48,14 +53,24 @@ import java.util.Iterator;
		* {@hide}
		*/
		@SystemService(Context.NETWORK_POLICY_SERVICE)
		@SystemApi
		public class NetworkPolicyManager {

		/* POLICY_* are masks and can be ORed, although currently they are not.*/
		/** No specific network policy, use system default. */
		/**
		* No specific network policy, use system default.
		* @hide
		*/
		public static final int POLICY_NONE = 0x0;
		/** Reject network usage on metered networks when application in background. */
		/**
		* Reject network usage on metered networks when application in background.
		* @hide
		*/
		public static final int POLICY_REJECT_METERED_BACKGROUND = 0x1;
		/** Allow metered network use in the background even when in data usage save mode. */
		/**
		* Allow metered network use in the background even when in data usage save mode.
		* @hide
		*/
		public static final int POLICY_ALLOW_METERED_BACKGROUND = 0x4;

		/*
		@@ -74,49 +89,98 @@ public class NetworkPolicyManager {
		*
		* See network-policy-restrictions.md for more info.
		*/
		/** No specific rule was set */
		/**
		* No specific rule was set
		* @hide
		*/
		public static final int RULE_NONE = 0;
		/** Allow traffic on metered networks. */
		/**
		* Allow traffic on metered networks.
		* @hide
		*/
		public static final int RULE_ALLOW_METERED = 1 << 0;
		/** Temporarily allow traffic on metered networks because app is on foreground. */
		/**
		* Temporarily allow traffic on metered networks because app is on foreground.
		* @hide
		*/
		public static final int RULE_TEMPORARY_ALLOW_METERED = 1 << 1;
		/** Reject traffic on metered networks. */
		/**
		* Reject traffic on metered networks.
		* @hide
		*/
		public static final int RULE_REJECT_METERED = 1 << 2;
		/** Network traffic should be allowed on all networks (metered or non-metered), although
		* metered-network restrictions could still apply. */
		/**
		* Network traffic should be allowed on all networks (metered or non-metered), although
		* metered-network restrictions could still apply.
		* @hide
		*/
		public static final int RULE_ALLOW_ALL = 1 << 5;
		/** Reject traffic on all networks. */
		/**
		* Reject traffic on all networks.
		* @hide
		*/
		public static final int RULE_REJECT_ALL = 1 << 6;
		/** Mask used to get the {@code RULE_xxx_METERED} rules */
		/**
		* Mask used to get the {@code RULE_xxx_METERED} rules
		* @hide
		*/
		public static final int MASK_METERED_NETWORKS = 0b00001111;
		/** Mask used to get the {@code RULE_xxx_ALL} rules */
		/**
		* Mask used to get the {@code RULE_xxx_ALL} rules
		* @hide
		*/
		public static final int MASK_ALL_NETWORKS = 0b11110000;

		/** @hide */
		public static final int FIREWALL_RULE_DEFAULT = 0;

		/** @hide */
		public static final String FIREWALL_CHAIN_NAME_NONE = "none";
		/** @hide */
		public static final String FIREWALL_CHAIN_NAME_DOZABLE = "dozable";
		/** @hide */
		public static final String FIREWALL_CHAIN_NAME_STANDBY = "standby";
		/** @hide */
		public static final String FIREWALL_CHAIN_NAME_POWERSAVE = "powersave";

		private static final boolean ALLOW_PLATFORM_APP_POLICY = true;

		/** @hide */
		public static final int FOREGROUND_THRESHOLD_STATE =
		ActivityManager.PROCESS_STATE_BOUND_FOREGROUND_SERVICE;

		/**
		* {@link Intent} extra that indicates which {@link NetworkTemplate} rule it
		* applies to.
		* @hide
		*/
		public static final String EXTRA_NETWORK_TEMPLATE = "android.net.NETWORK_TEMPLATE";

		public static final int OVERRIDE_UNMETERED = 1 << 0;
		public static final int OVERRIDE_CONGESTED = 1 << 1;
		/**
		* Mask used to check if an override value is marked as unmetered.
		*/
		public static final int SUBSCRIPTION_OVERRIDE_UNMETERED = 1 << 0;

		/**
		* Mask used to check if an override value is marked as congested.
		*/
		public static final int SUBSCRIPTION_OVERRIDE_CONGESTED = 1 << 1;

		/**
		* @hide
		*/
		@Retention(RetentionPolicy.SOURCE)
		@IntDef(flag = true, prefix = { "SUBSCRIPTION_OVERRIDE_" }, value = {
		SUBSCRIPTION_OVERRIDE_UNMETERED,
		SUBSCRIPTION_OVERRIDE_CONGESTED
		})
		public @interface SubscriptionOverrideMask {}

		private final Context mContext;
		@UnsupportedAppUsage
		private INetworkPolicyManager mService;

		/** @hide */
		public NetworkPolicyManager(Context context, INetworkPolicyManager service) {
		if (service == null) {
		throw new IllegalArgumentException("missing INetworkPolicyManager");
		@@ -125,6 +189,7 @@ public class NetworkPolicyManager {
		mService = service;
		}

		/** @hide */
		@UnsupportedAppUsage
		public static NetworkPolicyManager from(Context context) {
		return (NetworkPolicyManager) context.getSystemService(Context.NETWORK_POLICY_SERVICE);
		@@ -135,6 +200,7 @@ public class NetworkPolicyManager {
		*
		* @param policy should be {@link #POLICY_NONE} or any combination of {@code POLICY_} flags,
		* although it is not validated.
		* @hide
		*/
		@UnsupportedAppUsage
		public void setUidPolicy(int uid, int policy) {
		@@ -152,6 +218,7 @@ public class NetworkPolicyManager {
		*
		* @param policy should be {@link #POLICY_NONE} or any combination of {@code POLICY_} flags,
		* although it is not validated.
		* @hide
		*/
		public void addUidPolicy(int uid, int policy) {
		try {
		@@ -168,6 +235,7 @@ public class NetworkPolicyManager {
		*
		* @param policy should be {@link #POLICY_NONE} or any combination of {@code POLICY_} flags,
		* although it is not validated.
		* @hide
		*/
		public void removeUidPolicy(int uid, int policy) {
		try {
		@@ -177,6 +245,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage
		public int getUidPolicy(int uid) {
		try {
		@@ -186,6 +255,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage
		public int[] getUidsWithPolicy(int policy) {
		try {
		@@ -195,6 +265,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
		public void registerListener(INetworkPolicyListener listener) {
		try {
		@@ -204,6 +275,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023)
		public void unregisterListener(INetworkPolicyListener listener) {
		try {
		@@ -213,6 +285,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		public void setNetworkPolicies(NetworkPolicy[] policies) {
		try {
		mService.setNetworkPolicies(policies);
		@@ -221,6 +294,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage
		public NetworkPolicy[] getNetworkPolicies() {
		try {
		@@ -230,6 +304,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage
		public void setRestrictBackground(boolean restrictBackground) {
		try {
		@@ -239,6 +314,7 @@ public class NetworkPolicyManager {
		}
		}

		/** @hide */
		@UnsupportedAppUsage
		public boolean getRestrictBackground() {
		try {
		@@ -248,6 +324,32 @@ public class NetworkPolicyManager {
		}
		}

		/**
		* Override connections to be temporarily marked as either unmetered or congested,
		* along with automatic timeouts if desired.
		*
		* @param subId the subscriber ID this override applies to.
		* @param overrideMask the bitmask that specifies which of the overrides is being
		* set or cleared.
		* @param overrideValue the override values to set or clear.
		* @param timeoutMillis the timeout after which the requested override will
		* be automatically cleared, or {@code 0} to leave in the
		* requested state until explicitly cleared, or the next reboot,
		* whichever happens first
		* @param callingPackage the name of the package making the call.
		*
		*/
		public void setSubscriptionOverride(int subId, @SubscriptionOverrideMask int overrideMask,
		@SubscriptionOverrideMask int overrideValue, long timeoutMillis,
		@NonNull String callingPackage) {
		try {
		mService.setSubscriptionOverride(subId, overrideMask, overrideValue, timeoutMillis,
		callingPackage);
		} catch (RemoteException e) {
		throw e.rethrowFromSystemServer();
		}
		}

		/**
		* Resets network policy settings back to factory defaults.
		*
		@@ -286,6 +388,7 @@ public class NetworkPolicyManager {
		/**
		* Check if given UID can have a {@link #setUidPolicy(int, int)} defined,
		* usually to protect critical system services.
		* @hide
		*/
		@Deprecated
		public static boolean isUidValidForPolicy(Context context, int uid) {
		@@ -353,6 +456,7 @@ public class NetworkPolicyManager {
		/**
		* Returns true if {@param procState} is considered foreground and as such will be allowed
		* to access network when the device is idle or in battery saver mode. Otherwise, false.
		* @hide
		*/
		public static boolean isProcStateAllowedWhileIdleOrPowerSaveMode(int procState) {
		return procState <= FOREGROUND_THRESHOLD_STATE;
		@@ -361,16 +465,19 @@ public class NetworkPolicyManager {
		/**
		* Returns true if {@param procState} is considered foreground and as such will be allowed
		* to access network when the device is in data saver mode. Otherwise, false.
		* @hide
		*/
		public static boolean isProcStateAllowedWhileOnRestrictBackground(int procState) {
		return procState <= FOREGROUND_THRESHOLD_STATE;
		}

		/** @hide */
		public static String resolveNetworkId(WifiConfiguration config) {
		return WifiInfo.sanitizeSsid(config.isPasspoint()
		? config.providerFriendlyName : config.SSID);
		}

		/** @hide */
		public static String resolveNetworkId(String ssid) {
		return WifiInfo.sanitizeSsid(ssid);
		}

telephony/java/android/telephony/SubscriptionManager.java

+8 −8

Original line number	Diff line number	Diff line
		@@ -16,8 +16,8 @@

		package android.telephony;

		import static android.net.NetworkPolicyManager.OVERRIDE_CONGESTED;
		import static android.net.NetworkPolicyManager.OVERRIDE_UNMETERED;
		import static android.net.NetworkPolicyManager.SUBSCRIPTION_OVERRIDE_CONGESTED;
		import static android.net.NetworkPolicyManager.SUBSCRIPTION_OVERRIDE_UNMETERED;

		import android.Manifest;
		import android.annotation.CallbackExecutor;
		@@ -2524,9 +2524,9 @@ public class SubscriptionManager {
		public void setSubscriptionOverrideUnmetered(int subId, boolean overrideUnmetered,
		@DurationMillisLong long timeoutMillis) {
		try {
		final int overrideValue = overrideUnmetered ? OVERRIDE_UNMETERED : 0;
		getNetworkPolicy().setSubscriptionOverride(subId, OVERRIDE_UNMETERED, overrideValue,
		timeoutMillis, mContext.getOpPackageName());
		final int overrideValue = overrideUnmetered ? SUBSCRIPTION_OVERRIDE_UNMETERED : 0;
		getNetworkPolicy().setSubscriptionOverride(subId, SUBSCRIPTION_OVERRIDE_UNMETERED,
		overrideValue, timeoutMillis, mContext.getOpPackageName());
		} catch (RemoteException e) {
		throw e.rethrowFromSystemServer();
		}
		@@ -2559,9 +2559,9 @@ public class SubscriptionManager {
		public void setSubscriptionOverrideCongested(int subId, boolean overrideCongested,
		@DurationMillisLong long timeoutMillis) {
		try {
		final int overrideValue = overrideCongested ? OVERRIDE_CONGESTED : 0;
		getNetworkPolicy().setSubscriptionOverride(subId, OVERRIDE_CONGESTED, overrideValue,
		timeoutMillis, mContext.getOpPackageName());
		final int overrideValue = overrideCongested ? SUBSCRIPTION_OVERRIDE_CONGESTED : 0;
		getNetworkPolicy().setSubscriptionOverride(subId, SUBSCRIPTION_OVERRIDE_CONGESTED,
		overrideValue, timeoutMillis, mContext.getOpPackageName());
		} catch (RemoteException e) {
		throw e.rethrowFromSystemServer();
		}