Update API and documentation for invalid subscriptions id's. (81e1e31f) · Commits · e / os / android_frameworks_base

api/current.txt

+2 −0

Original line number	Diff line number	Diff line
		@@ -28660,6 +28660,8 @@ package android.telephony {
		method public void removeOnSubscriptionsChangedListener(android.telephony.SubscriptionManager.OnSubscriptionsChangedListener);
		field public static final int DATA_ROAMING_DISABLE = 0; // 0x0
		field public static final int DATA_ROAMING_ENABLE = 1; // 0x1
		method public void registerOnSubscriptionsChangedListener(android.telephony.SubscriptionManager.OnSubscriptionsChangedListener);
		method public void unregisterOnSubscriptionsChangedListener(android.telephony.SubscriptionManager.OnSubscriptionsChangedListener);
		}

		public static class SubscriptionManager.OnSubscriptionsChangedListener {

telephony/java/android/telephony/SubscriptionManager.java

+6 −5

Original line number	Diff line number	Diff line
		@@ -58,6 +58,7 @@ public class SubscriptionManager {
		private static final boolean VDBG = false;

		/** An invalid subscription identifier */
		/** @hide */
		public static final int INVALID_SUBSCRIPTION_ID = -1;

		/** Base value for Dummy SUBSCRIPTION_ID's. */
		@@ -693,7 +694,7 @@ public class SubscriptionManager {
		* @param subId the unique SubscriptionInfo index in database
		* @param nameSource 0: NAME_SOURCE_DEFAULT_SOURCE, 1: NAME_SOURCE_SIM_SOURCE,
		* 2: NAME_SOURCE_USER_INPUT, -1 NAME_SOURCE_UNDEFINED
		* @return the number of records updated or -1 if invalid subId
		* @return the number of records updated or < 0 if invalid subId
		* @hide
		*/
		public int setDisplayName(String displayName, int subId, long nameSource) {
		@@ -780,7 +781,7 @@ public class SubscriptionManager {
		/**
		* Get slotId associated with the subscription.
		* @return slotId as a positive integer or a negative value if an error either
		* SIM_NOT_INSERTED or INVALID_SLOT_ID.
		* SIM_NOT_INSERTED or < 0 if an invalid slot index
		* @hide
		*/
		public static int getSlotId(int subId) {
		@@ -928,7 +929,7 @@ public class SubscriptionManager {

		/**
		* @return subId of the DefaultSms subscription or
		* the value INVALID_SUBSCRIPTION_ID if an error.
		* a value < 0 if an error.
		*
		* @hide
		*/
		@@ -1054,7 +1055,7 @@ public class SubscriptionManager {

		/**
		* If a default is set to subscription which is not active, this will reset that default back to
		* INVALID_SUBSCRIPTION_ID.
		* an invalid subscription id, i.e. < 0.
		* @hide
		*/
		public void clearDefaultsForInactiveSubIds() {
		@@ -1130,7 +1131,7 @@ public class SubscriptionManager {

		/**
		* @return true if subId is an usable subId value else false. A
		* usable subId means its neither a INVALID_SUBSCRIPTION_ID nor a DEFAUL_SUB_ID.
		* usable subId means its neither a INVALID_SUBSCRIPTION_ID nor a DEFAULT_SUB_ID.
		* @hide
		*/
		public static boolean isUsableSubIdValue(int subId) {