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

Commit b0401fb6 authored by Michael Groover's avatar Michael Groover
Browse files

Document device ID access restriction target SDK behavior 

Fixes: 132392748
Test: Build
Change-Id: I9aed95087eb97fe206501a464187347e139eb2c3
parent a9ac86f6

core/java/android/os/Build.java

+17 −3
Original line number Diff line number Diff line
@@ -132,10 +132,24 @@ public class Build { 
     * <a href="/training/articles/security-key-attestation.html">key attestation</a> to obtain

     * proof of the device's original identifiers.

     *

     * <p>Requires Permission: READ_PRIVILEGED_PHONE_STATE, or for the calling package to be the

     * device or profile owner and have the READ_PHONE_STATE permission. Profile owner access is

     * deprecated and will be removed in a future release.

     * <p>Requires Permission: READ_PRIVILEGED_PHONE_STATE, for the calling app to be the device or

     * profile owner and have the READ_PHONE_STATE permission, or that the calling app has carrier

     * privileges (see {@link android.telephony.TelephonyManager#hasCarrierPrivileges}). The profile

     * owner is an app that owns a managed profile on the device; for more details see <a

     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then {@link Build#UNKNOWN} is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     * *

     * @return The serial number if specified.

     */

    @SuppressAutoDoc // No support for device / profile owner.

telephony/java/android/telephony/TelephonyManager.java

+112 −2
Original line number Diff line number Diff line
@@ -93,6 +93,8 @@ import com.android.internal.telephony.PhoneConstants; 
import com.android.internal.telephony.RILConstants;

import com.android.internal.telephony.TelephonyProperties;



import dalvik.system.VMRuntime;



import java.io.FileInputStream;

import java.io.IOException;

import java.lang.annotation.Retention;
@@ -108,8 +110,6 @@ import java.util.function.Consumer; 
import java.util.regex.Matcher;

import java.util.regex.Pattern;



import dalvik.system.VMRuntime;



/**

 * Provides access to information about the telephony services on

 * the device. Applications can use the methods in this class to
@@ -1551,6 +1551,17 @@ public class TelephonyManager { 
     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     *

     * @deprecated Use (@link getImei} which returns IMEI for GSM or (@link getMeid} which returns

     * MEID for CDMA.

     */
@@ -1581,6 +1592,17 @@ public class TelephonyManager { 
     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     *

     * @param slotIndex of which deviceID is returned

     *

     * @deprecated Use (@link getImei} which returns IMEI for GSM or (@link getMeid} which returns
@@ -1613,6 +1635,17 @@ public class TelephonyManager { 
     * managed profile on the device; for more details see <a

     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     */

    @SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).

    @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
@@ -1631,6 +1664,17 @@ public class TelephonyManager { 
     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     *

     * @param slotIndex of which IMEI is returned

     */

    @SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).
@@ -1686,6 +1730,17 @@ public class TelephonyManager { 
     * managed profile on the device; for more details see <a

     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     */

    @SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).

    @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
@@ -1703,6 +1758,17 @@ public class TelephonyManager { 
     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     *

     * @param slotIndex of which MEID is returned

     */

    @SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).
@@ -3217,6 +3283,17 @@ public class TelephonyManager { 
     * managed profile on the device; for more details see <a

     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     */

    @SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).

    @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
@@ -3235,6 +3312,17 @@ public class TelephonyManager { 
     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     *

     * @param subId for which Sim Serial number is returned

     * @hide

     */
@@ -3466,6 +3554,17 @@ public class TelephonyManager { 
     * managed profile on the device; for more details see <a

     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     */

    @SuppressAutoDoc // No support for device / profile owner or carrier privileges (b/72967236).

    @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
@@ -3485,6 +3584,17 @@ public class TelephonyManager { 
     * href="https://developer.android.com/work/managed-profiles">Work profiles</a>. Profile owner

     * access is deprecated and will be removed in a future release.

     *

     * <p>If the calling app does not meet one of these requirements then this method will behave

     * as follows:

     *

     * <ul>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app has the

     *     READ_PHONE_STATE permission then null is returned.</li>

     *     <li>If the calling app's target SDK is API level 28 or lower and the app does not have

     *     the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or

     *     higher, then a SecurityException is thrown.</li>

     * </ul>

     *

     * @param subId whose subscriber id is returned

     * @hide

     */