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

Commit 9fda7076 authored by Rambo Wang's avatar Rambo Wang
Browse files

Un-deprecate TelephonyManager SIM access APIs 

The APIs was deprecated starting from R release and recommended to
switch to OMAPI which has better resource management. However, OMAPI
does not provide the equevalent functions and has no plan to
support them in the near future.

With no resource to unify the two sets of public APIs, the plan
is to continue investing the current TelephonyManager SIM
acccess APIs. With target of maximum backward compactibility
and minimum architecture change, the plan here focuses on
improving reliability (with better resource management) and
usability (with better documentation).

As the first CL of the feature, it only un-deprecates the APIs.

Bug: 197658986
Test: make
Change-Id: If23dcfa4dda45efd91d1c8b6970691390d7243c8
parent db5da1ce

core/api/current.txt

+6 −6
Original line number Diff line number Diff line
@@ -42732,12 +42732,12 @@ package android.telephony { 
    method @Nullable public android.net.Uri getVoicemailRingtoneUri(android.telecom.PhoneAccountHandle);

    method public boolean hasCarrierPrivileges();

    method public boolean hasIccCard();

    method @Deprecated public boolean iccCloseLogicalChannel(int);

    method @Deprecated public byte[] iccExchangeSimIO(int, int, int, int, int, String);

    method public boolean iccCloseLogicalChannel(int);

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

    method @Deprecated public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(String);

    method @Deprecated public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannel(String, int);

    method @Deprecated public String iccTransmitApduBasicChannel(int, int, int, int, int, String);

    method @Deprecated public String iccTransmitApduLogicalChannel(int, int, int, int, int, int, String);

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

    method public String iccTransmitApduBasicChannel(int, int, int, int, int, String);

    method public String iccTransmitApduLogicalChannel(int, int, int, int, int, int, String);

    method public boolean isConcurrentVoiceAndDataSupported();

    method public boolean isDataCapable();

    method @RequiresPermission(anyOf={android.Manifest.permission.ACCESS_NETWORK_STATE, android.Manifest.permission.READ_PHONE_STATE, "android.permission.READ_PRIVILEGED_PHONE_STATE"}) public boolean isDataConnectionAllowed();
@@ -42762,7 +42762,7 @@ package android.telephony { 
    method @RequiresPermission(android.Manifest.permission.ACCESS_FINE_LOCATION) public void requestCellInfoUpdate(@NonNull java.util.concurrent.Executor, @NonNull android.telephony.TelephonyManager.CellInfoCallback);

    method @RequiresPermission(allOf={android.Manifest.permission.MODIFY_PHONE_STATE, android.Manifest.permission.ACCESS_FINE_LOCATION}) public android.telephony.NetworkScan requestNetworkScan(android.telephony.NetworkScanRequest, java.util.concurrent.Executor, android.telephony.TelephonyScanManager.NetworkScanCallback);

    method public void sendDialerSpecialCode(String);

    method @Deprecated public String sendEnvelopeWithStatus(String);

    method public String sendEnvelopeWithStatus(String);

    method @RequiresPermission(android.Manifest.permission.CALL_PHONE) public void sendUssdRequest(String, android.telephony.TelephonyManager.UssdResponseCallback, android.os.Handler);

    method public void sendVisualVoicemailSms(String, int, String, android.app.PendingIntent);

    method @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public void setCallComposerStatus(int);

core/api/system-current.txt

+3 −3
Original line number Diff line number Diff line
@@ -12055,10 +12055,10 @@ package android.telephony { 
    method @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public int getVoiceActivationState();

    method @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public boolean handlePinMmi(String);

    method @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public boolean handlePinMmiForSubscriber(int, String);

    method @Deprecated @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public boolean iccCloseLogicalChannelBySlot(int, int);

    method @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public boolean iccCloseLogicalChannelBySlot(int, int);

    method @Nullable @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public android.telephony.IccOpenLogicalChannelResponse iccOpenLogicalChannelBySlot(int, @Nullable String, int);

    method @Deprecated @NonNull @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public String iccTransmitApduBasicChannelBySlot(int, int, int, int, int, int, @Nullable String);

    method @Deprecated @Nullable @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public String iccTransmitApduLogicalChannelBySlot(int, int, int, int, int, int, int, @Nullable String);

    method @NonNull @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public String iccTransmitApduBasicChannelBySlot(int, int, int, int, int, int, @Nullable String);

    method @Nullable @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE) public String iccTransmitApduLogicalChannelBySlot(int, int, int, int, int, int, int, @Nullable String);

    method @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public boolean isAnyRadioPoweredOn();

    method @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public boolean isApnMetered(int);

    method @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public boolean isApplicationOnUicc(int);

telephony/java/android/telephony/TelephonyManager.java

+0 −70
Original line number Diff line number Diff line
@@ -6581,12 +6581,7 @@ public class TelephonyManager { 
     * @param AID Application id. See ETSI 102.221 and 101.220.

     * @param p2 P2 parameter (described in ISO 7816-4).

     * @return an IccOpenLogicalChannelResponse object.

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openLogicalChannel(byte[], byte)}.

     */

    @Deprecated

    public IccOpenLogicalChannelResponse iccOpenLogicalChannel(String AID, int p2) {

        return iccOpenLogicalChannel(getSubId(), AID, p2);

    }
@@ -6617,12 +6612,7 @@ public class TelephonyManager { 
     * @param p2 P2 parameter (described in ISO 7816-4).

     * @return an IccOpenLogicalChannelResponse object.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openLogicalChannel(byte[], byte)}.

     */

    @Deprecated

    public IccOpenLogicalChannelResponse iccOpenLogicalChannel(int subId, String AID, int p2) {

        try {

            ITelephony telephony = getITelephony();
@@ -6650,10 +6640,7 @@ public class TelephonyManager { 
     *            iccOpenLogicalChannel.

     * @return true if the channel was closed successfully.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.Channel#close()}.

     */

    @Deprecated

    @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)

    @SystemApi

    public boolean iccCloseLogicalChannelBySlot(int slotIndex, int channel) {
@@ -6680,10 +6667,7 @@ public class TelephonyManager { 
     * @param channel is the channel id to be closed as returned by a successful

     *            iccOpenLogicalChannel.

     * @return true if the channel was closed successfully.

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.Channel#close()}.

     */

    @Deprecated

    public boolean iccCloseLogicalChannel(int channel) {

        return iccCloseLogicalChannel(getSubId(), channel);

    }
@@ -6702,10 +6686,7 @@ public class TelephonyManager { 
     *            iccOpenLogicalChannel.

     * @return true if the channel was closed successfully.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.Channel#close()}.

     */

    @Deprecated

    public boolean iccCloseLogicalChannel(int subId, int channel) {

        try {

            ITelephony telephony = getITelephony();
@@ -6741,10 +6722,7 @@ public class TelephonyManager { 
     * @return The APDU response from the ICC card with the status appended at the end, or null if

     * there is an issue connecting to the Telephony service.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)

    @SystemApi

    @Nullable
@@ -6782,10 +6760,7 @@ public class TelephonyManager { 
     * @param data Data to be sent with the APDU.

     * @return The APDU response from the ICC card with the status appended at

     *            the end.

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public String iccTransmitApduLogicalChannel(int channel, int cla,

            int instruction, int p1, int p2, int p3, String data) {

        return iccTransmitApduLogicalChannel(getSubId(), channel, cla,
@@ -6814,10 +6789,7 @@ public class TelephonyManager { 
     * @return The APDU response from the ICC card with the status appended at

     *            the end.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public String iccTransmitApduLogicalChannel(int subId, int channel, int cla,

            int instruction, int p1, int p2, int p3, String data) {

        try {
@@ -6853,13 +6825,7 @@ public class TelephonyManager { 
     * @return The APDU response from the ICC card with the status appended at

     *            the end.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)

    @SystemApi

    @NonNull
@@ -6895,13 +6861,7 @@ public class TelephonyManager { 
     * @param data Data to be sent with the APDU.

     * @return The APDU response from the ICC card with the status appended at

     *            the end.

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public String iccTransmitApduBasicChannel(int cla,

            int instruction, int p1, int p2, int p3, String data) {

        return iccTransmitApduBasicChannel(getSubId(), cla,
@@ -6928,13 +6888,7 @@ public class TelephonyManager { 
     * @return The APDU response from the ICC card with the status appended at

     *            the end.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public String iccTransmitApduBasicChannel(int subId, int cla,

            int instruction, int p1, int p2, int p3, String data) {

        try {
@@ -6962,13 +6916,7 @@ public class TelephonyManager { 
     * @param p3 P3 value of the APDU command.

     * @param filePath

     * @return The APDU response.

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public byte[] iccExchangeSimIO(int fileID, int command, int p1, int p2, int p3,

            String filePath) {

        return iccExchangeSimIO(getSubId(), fileID, command, p1, p2, p3, filePath);
@@ -6990,13 +6938,7 @@ public class TelephonyManager { 
     * @param filePath

     * @return The APDU response.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public byte[] iccExchangeSimIO(int subId, int fileID, int command, int p1, int p2,

            int p3, String filePath) {

        try {
@@ -7022,13 +6964,7 @@ public class TelephonyManager { 
     * @return The APDU response from the ICC card in hexadecimal format

     *         with the last 4 bytes being the status word. If the command fails,

     *         returns an empty string.

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public String sendEnvelopeWithStatus(String content) {

        return sendEnvelopeWithStatus(getSubId(), content);

    }
@@ -7048,13 +6984,7 @@ public class TelephonyManager { 
     *         with the last 4 bytes being the status word. If the command fails,

     *         returns an empty string.

     * @hide

     * @deprecated Use {@link android.se.omapi.SEService} APIs instead. See

     *             {@link android.se.omapi.SEService#getUiccReader(int)},

     *             {@link android.se.omapi.Reader#openSession()},

     *             {@link android.se.omapi.Session#openBasicChannel(byte[], byte)},

     *             {@link android.se.omapi.Channel#transmit(byte[])}.

     */

    @Deprecated

    public String sendEnvelopeWithStatus(int subId, String content) {

        try {

            ITelephony telephony = getITelephony();