Merge "Document permissions for euicc privileged actions." am: 7e2e333769 (45698898) · Commits · e / os / android_frameworks_base

core/java/android/service/euicc/EuiccService.java

+15 −3

Original line number	Diff line number	Diff line
		@@ -106,15 +106,27 @@ public abstract class EuiccService extends Service {
		public static final String ACTION_PROVISION_EMBEDDED_SUBSCRIPTION =
		"android.service.euicc.action.PROVISION_EMBEDDED_SUBSCRIPTION";

		/** @see android.telephony.euicc.EuiccManager#ACTION_TOGGLE_SUBSCRIPTION_PRIVILEGED */
		/**
		* @see android.telephony.euicc.EuiccManager#ACTION_TOGGLE_SUBSCRIPTION_PRIVILEGED. This is
		* a protected intent that can only be sent by the system, and requires the
		* {@link android.Manifest.permission#BIND_EUICC_SERVICE} permission.
		*/
		public static final String ACTION_TOGGLE_SUBSCRIPTION_PRIVILEGED =
		"android.service.euicc.action.TOGGLE_SUBSCRIPTION_PRIVILEGED";

		/** @see android.telephony.euicc.EuiccManager#ACTION_DELETE_SUBSCRIPTION_PRIVILEGED */
		/**
		* @see android.telephony.euicc.EuiccManager#ACTION_DELETE_SUBSCRIPTION_PRIVILEGED. This is
		* a protected intent that can only be sent by the system, and requires the
		* {@link android.Manifest.permission#BIND_EUICC_SERVICE} permission.
		*/
		public static final String ACTION_DELETE_SUBSCRIPTION_PRIVILEGED =
		"android.service.euicc.action.DELETE_SUBSCRIPTION_PRIVILEGED";

		/** @see android.telephony.euicc.EuiccManager#ACTION_RENAME_SUBSCRIPTION_PRIVILEGED */
		/**
		* @see android.telephony.euicc.EuiccManager#ACTION_RENAME_SUBSCRIPTION_PRIVILEGED. This is
		* a protected intent that can only be sent by the system, and requires the
		* {@link android.Manifest.permission#BIND_EUICC_SERVICE} permission.
		*/
		public static final String ACTION_RENAME_SUBSCRIPTION_PRIVILEGED =
		"android.service.euicc.action.RENAME_SUBSCRIPTION_PRIVILEGED";

telephony/java/android/telephony/euicc/EuiccManager.java

+12 −0

Original line number	Diff line number	Diff line
		@@ -121,6 +121,10 @@ public class EuiccManager {
		* enable or disable a subscription. Must be accompanied with {@link #EXTRA_SUBSCRIPTION_ID} and
		* {@link #EXTRA_ENABLE_SUBSCRIPTION}.
		*
		* Requires the caller to be a privileged process with the
		* {@link android.permission#CALL_PRIVILEGED} permission for the intent to reach the Telephony
		* stack.
		*
		* <p>Unlike {@link #switchToSubscription(int, PendingIntent)}, using this action allows the
		* underlying eUICC service (i.e. the LPA app) to control the UI experience during this
		* operation. The action is received by the Telephony framework, which in turn selects and
		@@ -140,6 +144,10 @@ public class EuiccManager {
		* Intent action sent by system apps (such as the Settings app) to the Telephony framework to
		* delete a subscription. Must be accompanied with {@link #EXTRA_SUBSCRIPTION_ID}.
		*
		* Requires the caller to be a privileged process with the
		* {@link android.permission#CALL_PRIVILEGED} permission for the intent to reach the Telephony
		* stack.
		*
		* <p>Unlike {@link #deleteSubscription(int, PendingIntent)}, using this action allows the
		* underlying eUICC service (i.e. the LPA app) to control the UI experience during this
		* operation. The action is received by the Telephony framework, which in turn selects and
		@@ -160,6 +168,10 @@ public class EuiccManager {
		* rename a subscription. Must be accompanied with {@link #EXTRA_SUBSCRIPTION_ID} and
		* {@link #EXTRA_SUBSCRIPTION_NICKNAME}.
		*
		* Requires the caller to be a privileged process with the
		* {@link android.permission#CALL_PRIVILEGED} permission for the intent to reach the Telephony
		* stack.
		*
		* <p>Unlike {@link #updateSubscriptionNickname(int, String, PendingIntent)}, using this action
		* allows the the underlying eUICC service (i.e. the LPA app) to control the UI experience
		* during this operation. The action is received by the Telephony framework, which in turn