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

Commit 3f9f6f42 authored by Automerger Merge Worker's avatar Automerger Merge Worker
Browse files

Merge "Update javadoc of deprecated UICC APIs" am: e73b46c9 am: e33a7cb5 am: 606159f6 

Change-Id: I9b6d18c35bb77d4f7b39a4b11ace679480388b58
parents 42be9e51 606159f6

telephony/java/android/telephony/TelephonyManager.java

+55 −30
Original line number Diff line number Diff line
@@ -6179,9 +6179,11 @@ 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.

     * @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)}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public IccOpenLogicalChannelResponse iccOpenLogicalChannel(String AID, int p2) {

        return iccOpenLogicalChannel(getSubId(), AID, p2);
@@ -6213,9 +6215,11 @@ 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.

     * @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)}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

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

        try {
@@ -6244,9 +6248,9 @@ public class TelephonyManager { 
     *            iccOpenLogicalChannel.

     * @return true if the channel was closed successfully.

     * @hide

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

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

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

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)

    @SystemApi
@@ -6274,9 +6278,9 @@ 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.

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

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

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public boolean iccCloseLogicalChannel(int channel) {

        return iccCloseLogicalChannel(getSubId(), channel);
@@ -6296,9 +6300,9 @@ public class TelephonyManager { 
     *            iccOpenLogicalChannel.

     * @return true if the channel was closed successfully.

     * @hide

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

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

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

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public boolean iccCloseLogicalChannel(int subId, int channel) {

        try {
@@ -6335,9 +6339,9 @@ 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.

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

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

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)

    @SystemApi
@@ -6376,9 +6380,9 @@ 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.

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

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

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public String iccTransmitApduLogicalChannel(int channel, int cla,

            int instruction, int p1, int p2, int p3, String data) {
@@ -6408,9 +6412,9 @@ 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.

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

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

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

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

            int instruction, int p1, int p2, int p3, String data) {
@@ -6447,9 +6451,12 @@ 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.

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    @RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)

    @SystemApi
@@ -6486,9 +6493,12 @@ 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.

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public String iccTransmitApduBasicChannel(int cla,

            int instruction, int p1, int p2, int p3, String data) {
@@ -6516,9 +6526,12 @@ 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.

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public String iccTransmitApduBasicChannel(int subId, int cla,

            int instruction, int p1, int p2, int p3, String data) {
@@ -6547,9 +6560,12 @@ 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.

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

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

            String filePath) {
@@ -6572,9 +6588,12 @@ public class TelephonyManager { 
     * @param filePath

     * @return The APDU response.

     * @hide

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

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

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

            int p3, String filePath) {
@@ -6601,9 +6620,12 @@ 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.

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public String sendEnvelopeWithStatus(String content) {

        return sendEnvelopeWithStatus(getSubId(), content);
@@ -6624,9 +6646,12 @@ 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.

     * @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[])}.

     */

    // TODO(b/147153909): Update Javadoc to link to specific SEService API once integrated.

    @Deprecated

    public String sendEnvelopeWithStatus(int subId, String content) {

        try {