Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8a6561d1 authored by Jonathan Basseri's avatar Jonathan Basseri
Browse files

Change how TelephonyManager handles subscriptions. 

Addressing API council feedback, remove* all subscription ID arguments
from API calls, and provide a factory method to create a new
TelephonyManager which uses a given subId.

* The subId methods will be @hidden instead of deleted.

Bug: 28845064
Change-Id: I2de8ae9e45bc14962c7c20d7d076ec83bce92cd3
parent 15818e11

api/current.txt

+3 −30
Original line number Diff line number Diff line
@@ -37204,69 +37204,47 @@ package android.telephony { 














  public class TelephonyManager {















    method public boolean canChangeDtmfToneLength();













    method public android.telephony.TelephonyManager createForSubscriptionId(int);















    method public java.util.List<android.telephony.CellInfo> getAllCellInfo();















    method public int getCallState();













    method public int getCallState(int);















    method public android.telephony.CellLocation getCellLocation();















    method public int getDataActivity();













    method public int getDataNetworkType(int);













    method public int getDataNetworkType();















    method public int getDataState();















    method public java.lang.String getDeviceId();















    method public java.lang.String getDeviceId(int);















    method public java.lang.String getDeviceSoftwareVersion();















    method public java.lang.String getGroupIdLevel1();













    method public java.lang.String getGroupIdLevel1(int);















    method public java.lang.String getIccAuthentication(int, int, java.lang.String);













    method public java.lang.String getIccAuthentication(int, int, int, java.lang.String);













    method public java.lang.String getLine1AlphaTag(int);















    method public java.lang.String getLine1Number();













    method public java.lang.String getLine1Number(int);















    method public java.lang.String getMmsUAProfUrl();















    method public java.lang.String getMmsUserAgent();















    method public deprecated java.util.List<android.telephony.NeighboringCellInfo> getNeighboringCellInfo();















    method public java.lang.String getNetworkCountryIso();













    method public java.lang.String getNetworkCountryIso(int);















    method public java.lang.String getNetworkOperator();













    method public java.lang.String getNetworkOperator(int);















    method public java.lang.String getNetworkOperatorName();













    method public java.lang.String getNetworkOperatorName(int);















    method public int getNetworkType();













    method public int getNetworkType(int);















    method public int getPhoneCount();















    method public int getPhoneType();















    method public java.lang.String getSimCountryIso();













    method public java.lang.String getSimCountryIso(int);















    method public java.lang.String getSimOperator();













    method public java.lang.String getSimOperator(int);















    method public java.lang.String getSimOperatorName();













    method public java.lang.String getSimOperatorName(int);















    method public java.lang.String getSimSerialNumber();













    method public java.lang.String getSimSerialNumber(int);















    method public int getSimState();















    method public java.lang.String getSubscriberId();













    method public java.lang.String getSubscriberId(int);















    method public java.lang.String getVoiceMailAlphaTag();













    method public java.lang.String getVoiceMailAlphaTag(int);















    method public java.lang.String getVoiceMailNumber();













    method public java.lang.String getVoiceMailNumber(int);













    method public int getVoiceNetworkType(int);













    method public int getVoiceNetworkType();















    method public android.net.Uri getVoicemailRingtoneUri(android.telecom.PhoneAccountHandle);















    method public boolean hasCarrierPrivileges();













    method public boolean hasCarrierPrivileges(int);















    method public boolean hasIccCard();















    method public boolean iccCloseLogicalChannel(int);













    method public boolean iccCloseLogicalChannel(int, int);















    method public byte[] iccExchangeSimIO(int, int, int, int, int, java.lang.String);













    method public byte[] iccExchangeSimIO(int, int, int, int, int, int, java.lang.String);















    method public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(java.lang.String);













    method public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(int, java.lang.String);















    method public java.lang.String iccTransmitApduBasicChannel(int, int, int, int, int, java.lang.String);













    method public java.lang.String iccTransmitApduBasicChannel(int, int, int, int, int, int, java.lang.String);















    method public java.lang.String iccTransmitApduLogicalChannel(int, int, int, int, int, int, java.lang.String);













    method public java.lang.String iccTransmitApduLogicalChannel(int, int, int, int, int, int, int, java.lang.String);















    method public boolean isHearingAidCompatibilitySupported();















    method public boolean isNetworkRoaming();













    method public boolean isNetworkRoaming(int);















    method public boolean isSmsCapable();















    method public boolean isTtyModeSupported();















    method public boolean isVoiceCapable();









@@ -37274,15 +37252,10 @@ package android.telephony {













    method public boolean isWorldPhone();















    method public void listen(android.telephony.PhoneStateListener, int);















    method public java.lang.String sendEnvelopeWithStatus(java.lang.String);













    method public java.lang.String sendEnvelopeWithStatus(int, java.lang.String);















    method public boolean setLine1NumberForDisplay(java.lang.String, java.lang.String);













    method public boolean setLine1NumberForDisplay(int, java.lang.String, java.lang.String);















    method public boolean setOperatorBrandOverride(java.lang.String);













    method public boolean setOperatorBrandOverride(int, java.lang.String);















    method public boolean setPreferredNetworkTypeToGlobal();













    method public boolean setPreferredNetworkTypeToGlobal(int);















    method public boolean setVoiceMailNumber(java.lang.String, java.lang.String);













    method public boolean setVoiceMailNumber(int, java.lang.String, java.lang.String);















    field public static final java.lang.String ACTION_CONFIGURE_VOICEMAIL = "android.telephony.action.CONFIGURE_VOICEMAIL";















    field public static final java.lang.String ACTION_PHONE_STATE_CHANGED = "android.intent.action.PHONE_STATE";















    field public static final java.lang.String ACTION_RESPOND_VIA_MESSAGE = "android.intent.action.RESPOND_VIA_MESSAGE";

























api/system-current.txt



+3
−30




























Original line number
Diff line number
Diff line








@@ -40141,6 +40141,7 @@ package android.telephony {













    method public boolean canChangeDtmfToneLength();















    method public int checkCarrierPrivilegesForPackage(java.lang.String);















    method public int checkCarrierPrivilegesForPackageAnyPhone(java.lang.String);













    method public android.telephony.TelephonyManager createForSubscriptionId(int);















    method public void dial(java.lang.String);















    method public boolean disableDataConnectivity();















    method public boolean enableDataConnectivity();









@@ -40148,7 +40149,6 @@ package android.telephony {













    method public boolean endCall();















    method public java.util.List<android.telephony.CellInfo> getAllCellInfo();















    method public int getCallState();













    method public int getCallState(int);















    method public java.util.List<java.lang.String> getCarrierPackageNamesForIntent(android.content.Intent);















    method public java.util.List<java.lang.String> getCarrierPackageNamesForIntentAndPhone(android.content.Intent, int);















    method public java.lang.String getCdmaMdn();









@@ -40161,68 +40161,46 @@ package android.telephony {













    method public int getDataActivity();















    method public boolean getDataEnabled();















    method public boolean getDataEnabled(int);













    method public int getDataNetworkType(int);













    method public int getDataNetworkType();















    method public int getDataState();















    method public java.lang.String getDeviceId();















    method public java.lang.String getDeviceId(int);















    method public java.lang.String getDeviceSoftwareVersion();















    method public java.lang.String getGroupIdLevel1();













    method public java.lang.String getGroupIdLevel1(int);















    method public java.lang.String getIccAuthentication(int, int, java.lang.String);













    method public java.lang.String getIccAuthentication(int, int, int, java.lang.String);













    method public java.lang.String getLine1AlphaTag(int);















    method public java.lang.String getLine1Number();













    method public java.lang.String getLine1Number(int);















    method public java.lang.String getMmsUAProfUrl();















    method public java.lang.String getMmsUserAgent();















    method public deprecated java.util.List<android.telephony.NeighboringCellInfo> getNeighboringCellInfo();















    method public java.lang.String getNetworkCountryIso();













    method public java.lang.String getNetworkCountryIso(int);















    method public java.lang.String getNetworkOperator();













    method public java.lang.String getNetworkOperator(int);















    method public java.lang.String getNetworkOperatorName();













    method public java.lang.String getNetworkOperatorName(int);















    method public int getNetworkType();













    method public int getNetworkType(int);















    method public int getPhoneCount();















    method public int getPhoneType();















    method public java.lang.String getSimCountryIso();













    method public java.lang.String getSimCountryIso(int);















    method public java.lang.String getSimOperator();













    method public java.lang.String getSimOperator(int);















    method public java.lang.String getSimOperatorName();













    method public java.lang.String getSimOperatorName(int);















    method public java.lang.String getSimSerialNumber();













    method public java.lang.String getSimSerialNumber(int);















    method public int getSimState();















    method public java.lang.String getSubscriberId();













    method public java.lang.String getSubscriberId(int);















    method public java.lang.String getVoiceMailAlphaTag();













    method public java.lang.String getVoiceMailAlphaTag(int);















    method public java.lang.String getVoiceMailNumber();













    method public java.lang.String getVoiceMailNumber(int);













    method public int getVoiceNetworkType(int);













    method public int getVoiceNetworkType();















    method public android.net.Uri getVoicemailRingtoneUri(android.telecom.PhoneAccountHandle);















    method public boolean handlePinMmi(java.lang.String);















    method public boolean handlePinMmiForSubscriber(int, java.lang.String);















    method public boolean hasCarrierPrivileges();













    method public boolean hasCarrierPrivileges(int);















    method public boolean hasIccCard();















    method public boolean iccCloseLogicalChannel(int);













    method public boolean iccCloseLogicalChannel(int, int);















    method public byte[] iccExchangeSimIO(int, int, int, int, int, java.lang.String);













    method public byte[] iccExchangeSimIO(int, int, int, int, int, int, java.lang.String);















    method public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(java.lang.String);













    method public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(int, java.lang.String);















    method public java.lang.String iccTransmitApduBasicChannel(int, int, int, int, int, java.lang.String);













    method public java.lang.String iccTransmitApduBasicChannel(int, int, int, int, int, int, java.lang.String);















    method public java.lang.String iccTransmitApduLogicalChannel(int, int, int, int, int, int, java.lang.String);













    method public java.lang.String iccTransmitApduLogicalChannel(int, int, int, int, int, int, int, java.lang.String);















    method public boolean isDataConnectivityPossible();















    method public boolean isHearingAidCompatibilitySupported();















    method public boolean isIdle();















    method public boolean isNetworkRoaming();













    method public boolean isNetworkRoaming(int);















    method public boolean isOffhook();















    method public boolean isRadioOn();















    method public boolean isRinging();









@@ -40235,19 +40213,14 @@ package android.telephony {













    method public void listen(android.telephony.PhoneStateListener, int);















    method public boolean needsOtaServiceProvisioning();















    method public java.lang.String sendEnvelopeWithStatus(java.lang.String);













    method public java.lang.String sendEnvelopeWithStatus(int, java.lang.String);















    method public void setDataEnabled(boolean);















    method public void setDataEnabled(int, boolean);















    method public boolean setLine1NumberForDisplay(java.lang.String, java.lang.String);













    method public boolean setLine1NumberForDisplay(int, java.lang.String, java.lang.String);















    method public boolean setOperatorBrandOverride(java.lang.String);













    method public boolean setOperatorBrandOverride(int, java.lang.String);















    method public boolean setPreferredNetworkTypeToGlobal();













    method public boolean setPreferredNetworkTypeToGlobal(int);















    method public boolean setRadio(boolean);















    method public boolean setRadioPower(boolean);















    method public boolean setVoiceMailNumber(java.lang.String, java.lang.String);













    method public boolean setVoiceMailNumber(int, java.lang.String, java.lang.String);















    method public void silenceRinger();















    method public boolean supplyPin(java.lang.String);















    method public int[] supplyPinReportResult(java.lang.String);

























api/test-current.txt



+3
−30




























Original line number
Diff line number
Diff line








@@ -37281,69 +37281,47 @@ package android.telephony {



























  public class TelephonyManager {















    method public boolean canChangeDtmfToneLength();













    method public android.telephony.TelephonyManager createForSubscriptionId(int);















    method public java.util.List<android.telephony.CellInfo> getAllCellInfo();















    method public int getCallState();













    method public int getCallState(int);















    method public android.telephony.CellLocation getCellLocation();















    method public int getDataActivity();













    method public int getDataNetworkType(int);













    method public int getDataNetworkType();















    method public int getDataState();















    method public java.lang.String getDeviceId();















    method public java.lang.String getDeviceId(int);















    method public java.lang.String getDeviceSoftwareVersion();















    method public java.lang.String getGroupIdLevel1();













    method public java.lang.String getGroupIdLevel1(int);















    method public java.lang.String getIccAuthentication(int, int, java.lang.String);













    method public java.lang.String getIccAuthentication(int, int, int, java.lang.String);













    method public java.lang.String getLine1AlphaTag(int);















    method public java.lang.String getLine1Number();













    method public java.lang.String getLine1Number(int);















    method public java.lang.String getMmsUAProfUrl();















    method public java.lang.String getMmsUserAgent();















    method public deprecated java.util.List<android.telephony.NeighboringCellInfo> getNeighboringCellInfo();















    method public java.lang.String getNetworkCountryIso();













    method public java.lang.String getNetworkCountryIso(int);















    method public java.lang.String getNetworkOperator();













    method public java.lang.String getNetworkOperator(int);















    method public java.lang.String getNetworkOperatorName();













    method public java.lang.String getNetworkOperatorName(int);















    method public int getNetworkType();













    method public int getNetworkType(int);















    method public int getPhoneCount();















    method public int getPhoneType();















    method public java.lang.String getSimCountryIso();













    method public java.lang.String getSimCountryIso(int);















    method public java.lang.String getSimOperator();













    method public java.lang.String getSimOperator(int);















    method public java.lang.String getSimOperatorName();













    method public java.lang.String getSimOperatorName(int);















    method public java.lang.String getSimSerialNumber();













    method public java.lang.String getSimSerialNumber(int);















    method public int getSimState();















    method public java.lang.String getSubscriberId();













    method public java.lang.String getSubscriberId(int);















    method public java.lang.String getVoiceMailAlphaTag();













    method public java.lang.String getVoiceMailAlphaTag(int);















    method public java.lang.String getVoiceMailNumber();













    method public java.lang.String getVoiceMailNumber(int);













    method public int getVoiceNetworkType(int);













    method public int getVoiceNetworkType();















    method public android.net.Uri getVoicemailRingtoneUri(android.telecom.PhoneAccountHandle);















    method public boolean hasCarrierPrivileges();













    method public boolean hasCarrierPrivileges(int);















    method public boolean hasIccCard();















    method public boolean iccCloseLogicalChannel(int);













    method public boolean iccCloseLogicalChannel(int, int);















    method public byte[] iccExchangeSimIO(int, int, int, int, int, java.lang.String);













    method public byte[] iccExchangeSimIO(int, int, int, int, int, int, java.lang.String);















    method public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(java.lang.String);













    method public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(int, java.lang.String);















    method public java.lang.String iccTransmitApduBasicChannel(int, int, int, int, int, java.lang.String);













    method public java.lang.String iccTransmitApduBasicChannel(int, int, int, int, int, int, java.lang.String);















    method public java.lang.String iccTransmitApduLogicalChannel(int, int, int, int, int, int, java.lang.String);













    method public java.lang.String iccTransmitApduLogicalChannel(int, int, int, int, int, int, int, java.lang.String);















    method public boolean isHearingAidCompatibilitySupported();















    method public boolean isNetworkRoaming();













    method public boolean isNetworkRoaming(int);















    method public boolean isSmsCapable();















    method public boolean isTtyModeSupported();















    method public boolean isVoiceCapable();









@@ -37351,15 +37329,10 @@ package android.telephony {













    method public boolean isWorldPhone();















    method public void listen(android.telephony.PhoneStateListener, int);















    method public java.lang.String sendEnvelopeWithStatus(java.lang.String);













    method public java.lang.String sendEnvelopeWithStatus(int, java.lang.String);















    method public boolean setLine1NumberForDisplay(java.lang.String, java.lang.String);













    method public boolean setLine1NumberForDisplay(int, java.lang.String, java.lang.String);















    method public boolean setOperatorBrandOverride(java.lang.String);













    method public boolean setOperatorBrandOverride(int, java.lang.String);















    method public boolean setPreferredNetworkTypeToGlobal();













    method public boolean setPreferredNetworkTypeToGlobal(int);















    method public boolean setVoiceMailNumber(java.lang.String, java.lang.String);













    method public boolean setVoiceMailNumber(int, java.lang.String, java.lang.String);















    field public static final java.lang.String ACTION_CONFIGURE_VOICEMAIL = "android.telephony.action.CONFIGURE_VOICEMAIL";















    field public static final java.lang.String ACTION_PHONE_STATE_CHANGED = "android.intent.action.PHONE_STATE";















    field public static final java.lang.String ACTION_RESPOND_VIA_MESSAGE = "android.intent.action.RESPOND_VIA_MESSAGE";

























telephony/java/android/telephony/TelephonyManager.java



+117
−49


























File changed.
Preview size limit exceeded, changes collapsed.