Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Clarify number format expectations for get/setPhoneNumber" am: af4fc5fb39 am: c1fe8d36d0 am: c1dea0eb6f

Browse Source 
Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1949477

Change-Id: I6a8304b673ef34dcea2b34717a096032d47b6a07
This commit is contained in:
Treehugger Robot
2022-01-21 21:56:58 +00:00
committed by Automerger Merge Worker
parent 0a30bb6382 c1dea0eb6f
commit f4e42f6e34
1 changed files with 13 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
telephony/java/android/telephony/SubscriptionManager.java
View File

@@ -3820,6 +3820,11 @@ public class SubscriptionManager {
* {@link #PHONE_NUMBER_SOURCE_UICC UICC} and decide if the previously set phone number
* of source {@link #PHONE_NUMBER_SOURCE_CARRIER carrier} should be updated.
*
* <p>The API provides no guarantees of what format the number is in: the format can vary
* depending on the {@code source} and the network etc. Programmatic parsing should be done
* cautiously, for example, after formatting the number to a consistent format with
* {@link android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)}.
*
* <p>Note the assumption is that one subscription (which usually means one SIM) has
* only one phone number. The multiple sources backup each other so hopefully at least one
* is availavle. For example, for a carrier that doesn't typically set phone numbers
@@ -3878,6 +3883,11 @@ public class SubscriptionManager {
* from available sources in the following order: {@link #PHONE_NUMBER_SOURCE_CARRIER}
* > {@link #PHONE_NUMBER_SOURCE_UICC} > {@link #PHONE_NUMBER_SOURCE_IMS}.
*
* <p>The API provides no guarantees of what format the number is in: the format can vary
* depending on the underlying source and the network etc. Programmatic parsing should be done
* cautiously, for example, after formatting the number to a consistent format with
* {@link android.telephony.PhoneNumberUtils#formatNumberToE164(String, String)}.
*
* @param subscriptionId the subscription ID, or {@link #DEFAULT_SUBSCRIPTION_ID}
* for the default one.
* @return the phone number, or an empty string if not available.
@@ -3916,6 +3926,9 @@ public class SubscriptionManager {
* <p>The API is suitable for carrier apps to provide a phone number, for example when
* it's not possible to update {@link #PHONE_NUMBER_SOURCE_UICC UICC} directly.
*
* <p>It's recommended that the phone number is formatted to well-known formats,
* for example, by {@link PhoneNumberUtils} {@code formatNumber*} methods.
*
* @param subscriptionId the subscription ID, or {@link #DEFAULT_SUBSCRIPTION_ID}
* for the default one.
* @param number the phone number, or an empty string to remove the previously set number.