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

Commit 6cab7d5f authored by TreeHugger Robot's avatar TreeHugger Robot Committed by Automerger Merge Worker
Browse files

Merge "Update docs for getServiceState" into sc-dev am: faad7c72 

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/13535546

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: I0b5f1c9f66277f0dae58350e80c2439e4a8ab7bc
parents 655da74e faad7c72

core/api/current.txt

+1 −1
Original line number Diff line number Diff line
@@ -42090,7 +42090,7 @@ package android.telephony { 
    method @Deprecated public int getPhoneCount();

    method public int getPhoneType();

    method @RequiresPermission(anyOf={"android.permission.READ_PRIVILEGED_PHONE_STATE", android.Manifest.permission.READ_PHONE_STATE}) public int getPreferredOpportunisticDataSubscription();

    method @Nullable @RequiresPermission(allOf={android.Manifest.permission.READ_PHONE_STATE, android.Manifest.permission.ACCESS_COARSE_LOCATION}) public android.telephony.ServiceState getServiceState();

    method @Nullable @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE) public android.telephony.ServiceState getServiceState();

    method @Nullable public android.telephony.SignalStrength getSignalStrength();

    method public int getSimCarrierId();

    method @Nullable public CharSequence getSimCarrierIdName();

telephony/java/android/telephony/TelephonyManager.java

+10 −5
Original line number Diff line number Diff line
@@ -11255,16 +11255,21 @@ public class TelephonyManager { 
     *

     * <p>Requires Permission: {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}

     * or that the calling app has carrier privileges (see {@link #hasCarrierPrivileges})

     * and {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}.

     * Additionally, depending on the level of location permissions the caller holds (i.e. no

     * location permissions, {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}, or

     * {@link android.Manifest.permission#ACCESS_FINE_LOCATION}), location-sensitive fields will

     * be cleared from the return value.

     *

     * <p>Note also that if the caller holds any sort of location permission, a usage event for the

     * {@link android.app.AppOpsManager#OPSTR_FINE_LOCATION} or

     * {@link android.app.AppOpsManager#OPSTR_FINE_LOCATION}

     * will be logged against the caller when calling this method.

     *

     * May return {@code null} when the subscription is inactive or when there was an error

     * communicating with the phone process.

     */

    @SuppressAutoDoc // Blocked by b/72967236 - no support for carrier privileges

    @RequiresPermission(allOf = {

            Manifest.permission.READ_PHONE_STATE,

            Manifest.permission.ACCESS_COARSE_LOCATION

    })

    @RequiresPermission(Manifest.permission.READ_PHONE_STATE)

    public @Nullable ServiceState getServiceState() {

        return getServiceStateForSubscriber(getSubId());

    }