Merge "Carrier id api rename" (57479b64) · Commits · e / os / android_frameworks_base

api/current.txt

+2 −2

Original line number	Diff line number	Diff line
		@@ -40831,8 +40831,6 @@ package android.telephony {
		method public android.telephony.TelephonyManager createForPhoneAccountHandle(android.telecom.PhoneAccountHandle);
		method public android.telephony.TelephonyManager createForSubscriptionId(int);
		method public java.util.List<android.telephony.CellInfo> getAllCellInfo();
		method public int getAndroidCarrierIdForSubscription();
		method public java.lang.CharSequence getAndroidCarrierNameForSubscription();
		method public int getCallState();
		method public android.os.PersistableBundle getCarrierConfig();
		method public deprecated android.telephony.CellLocation getCellLocation();
		@@ -40863,6 +40861,8 @@ package android.telephony {
		method public int getPhoneType();
		method public android.telephony.ServiceState getServiceState();
		method public android.telephony.SignalStrength getSignalStrength();
		method public int getSimCarrierId();
		method public java.lang.CharSequence getSimCarrierIdName();
		method public java.lang.String getSimCountryIso();
		method public java.lang.String getSimOperator();
		method public java.lang.String getSimOperatorName();

telephony/java/android/telephony/Telephony.java

+3 −3

Original line number	Diff line number	Diff line
		@@ -3380,7 +3380,7 @@ public final class Telephony {
		* on the given subscriptionId
		* <p>
		* Use this {@link Uri} with a {@link ContentObserver} to be notified of changes to the
		* carrier identity {@link TelephonyManager#getAndroidCarrierIdForSubscription()}
		* carrier identity {@link TelephonyManager#getSimCarrierId()}
		* while your app is running. You can also use a {@link JobService} to ensure your app
		* is notified of changes to the {@link Uri} even when it is not running.
		* Note, however, that using a {@link JobService} does not guarantee timely delivery of
		@@ -3396,14 +3396,14 @@ public final class Telephony {

		/**
		* A user facing carrier name.
		* @see TelephonyManager#getAndroidCarrierNameForSubscription()
		* @see TelephonyManager#getSimCarrierIdName()
		* <P>Type: TEXT </P>
		*/
		public static final String CARRIER_NAME = "carrier_name";

		/**
		* A unique carrier id
		* @see TelephonyManager#getAndroidCarrierIdForSubscription()
		* @see TelephonyManager#getSimCarrierId()
		* <P>Type: INTEGER </P>
		*/
		public static final String CARRIER_ID = "carrier_id";

telephony/java/android/telephony/TelephonyManager.java

+10 −11

Original line number	Diff line number	Diff line
		@@ -52,7 +52,6 @@ import android.telephony.ims.aidl.IImsConfig;
		import android.telephony.ims.aidl.IImsMmTelFeature;
		import android.telephony.ims.aidl.IImsRcsFeature;
		import android.telephony.ims.aidl.IImsRegistration;
		import android.telephony.ims.feature.ImsFeature;
		import android.telephony.ims.stub.ImsRegistrationImplBase;
		import android.util.Log;

		@@ -1049,7 +1048,7 @@ public class TelephonyManager {

		/**
		* An int extra used with {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} which indicates
		* the updated carrier id {@link TelephonyManager#getAndroidCarrierIdForSubscription()} of
		* the updated carrier id {@link TelephonyManager#getSimCarrierId()} of
		* the current subscription.
		* <p>Will be {@link TelephonyManager#UNKNOWN_CARRIER_ID} if the subscription is unavailable or
		* the carrier cannot be identified.
		@@ -1059,7 +1058,7 @@ public class TelephonyManager {
		/**
		* An string extra used with {@link #ACTION_SUBSCRIPTION_CARRIER_IDENTITY_CHANGED} which
		* indicates the updated carrier name of the current subscription.
		* {@see TelephonyManager#getSubscriptionCarrierName()}
		* {@see TelephonyManager#getSimCarrierIdName()}
		* <p>Carrier name is a user-facing name of the carrier id {@link #EXTRA_CARRIER_ID},
		* usually the brand name of the subsidiary (e.g. T-Mobile).
		*/
		@@ -7109,8 +7108,8 @@ public class TelephonyManager {
		/**
		* Returns carrier id of the current subscription.
		* <p>To recognize a carrier (including MVNO) as a first-class identity, Android assigns each
		* carrier with a canonical integer a.k.a. android carrier id. The Android carrier ID is an
		* Android platform-wide identifier for a carrier. AOSP maintains carrier ID assignments in
		* carrier with a canonical integer a.k.a. carrier id. The carrier ID is an Android
		* platform-wide identifier for a carrier. AOSP maintains carrier ID assignments in
		* <a href="https://android.googlesource.com/platform/packages/providers/TelephonyProvider/+/master/assets/carrier_list.textpb">here</a>
		*
		* <p>Apps which have carrier-specific configurations or business logic can use the carrier id
		@@ -7119,7 +7118,7 @@ public class TelephonyManager {
		* @return Carrier id of the current subscription. Return {@link #UNKNOWN_CARRIER_ID} if the
		* subscription is unavailable or the carrier cannot be identified.
		*/
		public int getAndroidCarrierIdForSubscription() {
		public int getSimCarrierId() {
		try {
		ITelephony service = getITelephony();
		if (service != null) {
		@@ -7133,18 +7132,18 @@ public class TelephonyManager {
		}

		/**
		* Returns carrier name of the current subscription.
		* <p>Carrier name is a user-facing name of carrier id
		* {@link #getAndroidCarrierIdForSubscription()}, usually the brand name of the subsidiary
		* Returns carrier id name of the current subscription.
		* <p>Carrier id name is a user-facing name of carrier id
		* {@link #getSimCarrierId()}, usually the brand name of the subsidiary
		* (e.g. T-Mobile). Each carrier could configure multiple {@link #getSimOperatorName() SPN} but
		* should have a single carrier name. Carrier name is not a canonical identity,
		* use {@link #getAndroidCarrierIdForSubscription()} instead.
		* use {@link #getSimCarrierId()} instead.
		* <p>The returned carrier name is unlocalized.
		*
		* @return Carrier name of the current subscription. Return {@code null} if the subscription is
		* unavailable or the carrier cannot be identified.
		*/
		public CharSequence getAndroidCarrierNameForSubscription() {
		public CharSequence getSimCarrierIdName() {
		try {
		ITelephony service = getITelephony();
		if (service != null) {

telephony/java/com/android/internal/telephony/ITelephony.aidl

+2 −2

Original line number	Diff line number	Diff line
		@@ -1352,10 +1352,10 @@ interface ITelephony {

		/**
		* Returns carrier name of the given subscription.
		* <p>Carrier name is a user-facing name of carrier id {@link #getSubscriptionCarrierId(int)},
		* <p>Carrier name is a user-facing name of carrier id {@link #getSimCarrierId(int)},
		* usually the brand name of the subsidiary (e.g. T-Mobile). Each carrier could configure
		* multiple {@link #getSimOperatorName() SPN} but should have a single carrier name.
		* Carrier name is not canonical identity, use {@link #getSubscriptionCarrierId(int)} instead.
		* Carrier name is not canonical identity, use {@link #getSimCarrierId(int)} instead.
		* <p>Returned carrier name is unlocalized.
		*
		* @return Carrier name of given subscription id. return {@code null} if subscription is