Merge "Create getMobileProvisioningUrl in telephony" am: cdf7105f72 am: 650317e419

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

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: I5eca501c3653f14b922f51e3d0514e96c21a586a

telephony/java/android/telephony/TelephonyManager.java

@@ -9274,6 +9274,35 @@ public class TelephonyManager {
         return false;
     }
 
+    /**
+     * Get the mobile provisioning url that is used to launch a browser to allow users to manage
+     * their mobile plan.
+     *
+     * <p>Requires Permission:
+     * {@link android.Manifest.permission#READ_PRIVILEGED_PHONE_STATE}.
+     *
+     * TODO: The legacy design only supports single sim design. Ideally, this should support
+     * multi-sim design in current world.
+     *
+     * {@hide}
+     */
+    @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
+    public @Nullable String getMobileProvisioningUrl() {
+        try {
+            final ITelephony service = getITelephony();
+            if (service != null) {
+                return service.getMobileProvisioningUrl();
+            } else {
+                throw new IllegalStateException("telephony service is null.");
+            }
+        } catch (RemoteException ex) {
+            if (!isSystemProcess()) {
+                ex.rethrowAsRuntimeException();
+            }
+        }
+        return null;
+    }
+
     /**
      * Turns mobile data on or off.
      * If this object has been created with {@link #createForSubscriptionId}, applies to the given

telephony/java/com/android/internal/telephony/ITelephony.aidl

@@ -2352,4 +2352,10 @@ interface ITelephony {
      * Gets the config of RCS VoLTE single registration enabled for the carrier/subscription.
      */
     boolean getCarrierSingleRegistrationEnabled(int subId);
+
+    /**
+     *  Return the mobile provisioning url that is used to launch a browser to allow users to manage
+     *  their mobile plan.
+     */
+    String getMobileProvisioningUrl();
 }