Package org.robolectric.shadows

Class ShadowSubscriptionManager

java.lang.Object

org.robolectric.shadows.ShadowSubscriptionManager

@Implements(value=android.telephony.SubscriptionManager.class,
            minSdk=22)
public class ShadowSubscriptionManager
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ShadowSubscriptionManager.SubscriptionInfoBuilder	Builder class to create instance of SubscriptionInfo.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	INVALID_PHONE_INDEX

Constructor Summary

Constructors

Constructor	Description
ShadowSubscriptionManager()

Method Summary

Modifier and Type	Method	Description
protected void	addOnSubscriptionsChangedListener(SubscriptionManager.OnSubscriptionsChangedListener listener)	Adds a listener to a local list of listeners.
protected void	addOnSubscriptionsChangedListener(Executor executor, SubscriptionManager.OnSubscriptionsChangedListener listener)	Adds a listener to a local list of listeners.
void	clearNetworkRoamingStatus()	Clears the local cache of roaming subscription Ids used by isNetworkRoaming(int).
static void	clearPhoneIds()	Removes all mappings between subscription IDs and phone IDs from the map used by getPhoneId(int).
protected List<SubscriptionInfo>	getAccessibleSubscriptionInfoList()	Returns the accessible list of SubscriptionInfo that were set via setAccessibleSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).
protected static int	getActiveDataSubscriptionId()	Returns value set with setActiveDataSubscriptionId(int).
protected int[]	getActiveSubscriptionIdList()	Returns subscription Ids that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).
protected SubscriptionInfo	getActiveSubscriptionInfo(int subId)	Returns subscription that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) if it can find one with the specified id or null if none found.
protected int	getActiveSubscriptionInfoCount()	Returns the size of the list of SubscriptionInfo that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).
protected int	getActiveSubscriptionInfoCountMax()
protected SubscriptionInfo	getActiveSubscriptionInfoForSimSlotIndex(int slotIndex)	Returns subscription that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) if it can find one with the specified slot index or null if none found.
protected List<SubscriptionInfo>	getActiveSubscriptionInfoList()	Returns the active list of SubscriptionInfo that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).
protected List<SubscriptionInfo>	getAvailableSubscriptionInfoList()	Returns the available list of SubscriptionInfo that were set via setAvailableSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).
protected static int	getDefaultDataSubId()
protected static int	getDefaultDataSubscriptionId()	Returns value set with setDefaultDataSubscriptionId(int).
protected static int	getDefaultSmsSubId()
protected static int	getDefaultSmsSubscriptionId()	Returns value set with setDefaultSmsSubscriptionId(int).
protected static int	getDefaultSubId()
protected static int	getDefaultSubscriptionId()	Returns value set with setDefaultSubscriptionId(int).
protected static int	getDefaultVoiceSubId()
protected static int	getDefaultVoiceSubscriptionId()	Returns value set with setDefaultVoiceSubscriptionId(int).
protected static int	getPhoneId(int subId)	Uses the map of subscription IDs to phone IDs managed by putPhoneId(int,int) and removePhoneId(int) to return the phone ID for a given subscription ID.
protected String	getPhoneNumber(int subscriptionId)	Returns the phone number for the given subscriptionId, or an empty string if not available.
protected String	getPhoneNumber(int subscriptionId, int source)	Returns the phone number for the given subscriptionId, or an empty string if not available.
boolean	hasOnSubscriptionsChangedListener(SubscriptionManager.OnSubscriptionsChangedListener listener)	Check if a listener exists in the ShadowSubscriptionManager.listeners.
protected boolean	isNetworkRoaming(int simSubscriptionId)	Uses the local cache of roaming sim subscription Ids managed by setNetworkRoamingStatus(int, boolean) to return subscription Ids marked as roaming.
static void	putPhoneId(int subId, int phoneId)	Adds a subscription ID-phone ID mapping to the map used by getPhoneId(int).
protected void	removeOnSubscriptionsChangedListener(SubscriptionManager.OnSubscriptionsChangedListener listener)	Removes a listener from a local list of listeners.
static Integer	removePhoneId(int subId)	Removes a subscription ID-phone ID mapping from the map used by getPhoneId(int).
static void	reset()
void	setAccessibleSubscriptionInfoList(List<SubscriptionInfo> list)	Sets the accessible list of SubscriptionInfo.
void	setAccessibleSubscriptionInfos(SubscriptionInfo... infos)	Sets the accessible list of SubscriptionInfo.
static void	setActiveDataSubscriptionId(int activeDataSubscriptionId)	Sets the value that will be returned by getActiveDataSubscriptionId().
void	setActiveSubscriptionInfoList(List<SubscriptionInfo> list)	Sets the active list of SubscriptionInfo.
void	setActiveSubscriptionInfos(SubscriptionInfo... infos)	Sets the active list of SubscriptionInfo.
void	setAvailableSubscriptionInfoList(List<SubscriptionInfo> list)	Sets the available list of SubscriptionInfo.
void	setAvailableSubscriptionInfos(SubscriptionInfo... infos)	Sets the available list of SubscriptionInfo.
static void	setDefaultDataSubscriptionId(int defaultDataSubscriptionId)
static void	setDefaultSmsSubscriptionId(int defaultSmsSubscriptionId)
static void	setDefaultSubscriptionId(int defaultSubscriptionId)	Sets the value that will be returned by getDefaultSubscriptionId().
static void	setDefaultVoiceSubscriptionId(int defaultVoiceSubscriptionId)
void	setNetworkRoamingStatus(int simSubscriptionId, boolean isNetworkRoaming)	If isNetworkRoaming is set, it will mark the provided sim subscriptionId as roaming in a local cache.
void	setPhoneNumber(int subscriptionId, String phoneNumber)	Sets the phone number returned by getPhoneNumber(int).
void	setReadPhoneNumbersPermission(boolean readPhoneNumbersPermission)	When set to false methods requiring android.Manifest.permission.READ_PHONE_NUMBERS permission will throw a SecurityException.
void	setReadPhoneStatePermission(boolean readPhoneStatePermission)	When set to false methods requiring android.Manifest.permission.READ_PHONE_STATE permission will throw a SecurityException.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

INVALID_PHONE_INDEX

public static final int INVALID_PHONE_INDEX

Constructor Details

ShadowSubscriptionManager

public ShadowSubscriptionManager()

Method Details

getActiveDataSubscriptionId

@Implementation(minSdk=30)
protected static int getActiveDataSubscriptionId()

Returns value set with setActiveDataSubscriptionId(int).

getDefaultSubscriptionId

@Implementation(minSdk=24)
protected static int getDefaultSubscriptionId()

Returns value set with setDefaultSubscriptionId(int).

getDefaultDataSubscriptionId

@Implementation(minSdk=24)
protected static int getDefaultDataSubscriptionId()

Returns value set with setDefaultDataSubscriptionId(int).

getDefaultSmsSubscriptionId

@Implementation(minSdk=24)
protected static int getDefaultSmsSubscriptionId()

Returns value set with setDefaultSmsSubscriptionId(int).

getDefaultVoiceSubscriptionId

@Implementation(minSdk=24)
protected static int getDefaultVoiceSubscriptionId()

Returns value set with setDefaultVoiceSubscriptionId(int).

getDefaultSubId

@Implementation(maxSdk=23)
@HiddenApi
protected static int getDefaultSubId()

getDefaultVoiceSubId

@Implementation(maxSdk=23)
@HiddenApi
protected static int getDefaultVoiceSubId()

getDefaultSmsSubId

@Implementation(maxSdk=23)
@HiddenApi
protected static int getDefaultSmsSubId()

getDefaultDataSubId

@Implementation(maxSdk=23)
@HiddenApi
protected static int getDefaultDataSubId()

setActiveDataSubscriptionId

public static void setActiveDataSubscriptionId(int activeDataSubscriptionId)

Sets the value that will be returned by getActiveDataSubscriptionId().

setDefaultSubscriptionId

public static void setDefaultSubscriptionId(int defaultSubscriptionId)

Sets the value that will be returned by getDefaultSubscriptionId().

setDefaultDataSubscriptionId

public static void setDefaultDataSubscriptionId(int defaultDataSubscriptionId)

setDefaultSmsSubscriptionId

public static void setDefaultSmsSubscriptionId(int defaultSmsSubscriptionId)

setDefaultVoiceSubscriptionId

public static void setDefaultVoiceSubscriptionId(int defaultVoiceSubscriptionId)

getActiveSubscriptionInfoList

@Implementation(minSdk=22)
protected List<SubscriptionInfo> getActiveSubscriptionInfoList()

Returns the active list of SubscriptionInfo that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).

getAccessibleSubscriptionInfoList

@Implementation(minSdk=27)
protected List<SubscriptionInfo> getAccessibleSubscriptionInfoList()

Returns the accessible list of SubscriptionInfo that were set via setAccessibleSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).

getAvailableSubscriptionInfoList

@Implementation(minSdk=27)
protected List<SubscriptionInfo> getAvailableSubscriptionInfoList()

Returns the available list of SubscriptionInfo that were set via setAvailableSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).

getActiveSubscriptionInfoCount

@Implementation(minSdk=22)
protected int getActiveSubscriptionInfoCount()

Returns the size of the list of SubscriptionInfo that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>). If no list was set, returns 0.

getActiveSubscriptionInfo

@Implementation(minSdk=22)
protected SubscriptionInfo getActiveSubscriptionInfo(int subId)

Returns subscription that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) if it can find one with the specified id or null if none found.

An exception will be thrown if the READ_PHONE_STATE permission has not been granted.

getActiveSubscriptionInfoCountMax

@Implementation(minSdk=22)
protected int getActiveSubscriptionInfoCountMax()

Returns:

the maximum number of active subscriptions that will be returned by getActiveSubscriptionInfoList() and the value returned by getActiveSubscriptionInfoCount().

getActiveSubscriptionInfoForSimSlotIndex

@Implementation(minSdk=24)
protected SubscriptionInfo getActiveSubscriptionInfoForSimSlotIndex(int slotIndex)

Returns subscription that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) if it can find one with the specified slot index or null if none found.

setActiveSubscriptionInfoList

public void setActiveSubscriptionInfoList(List<SubscriptionInfo> list)

Sets the active list of SubscriptionInfo. This call internally triggers SubscriptionManager.OnSubscriptionsChangedListener.onSubscriptionsChanged() to all the listeners.

"Active" here means subscriptions which are currently mapped to a live modem stack in the device (i.e. the modem will attempt to use them to connect to nearby towers), and they are expected to have SubscriptionInfo.getSimSlotIndex() >= 0. A subscription being "active" in the device does NOT have any relation to a carrier's "activation" process for subscribers' SIMs.

Parameters:

list - - The subscription info list, can be null.

setAccessibleSubscriptionInfoList

public void setAccessibleSubscriptionInfoList(List<SubscriptionInfo> list)

Sets the accessible list of SubscriptionInfo. This call internally triggers SubscriptionManager.OnSubscriptionsChangedListener.onSubscriptionsChanged() to all the listeners.

"Accessible" here means subscriptions which are eSIM (SubscriptionInfo.isEmbedded()) and "owned" by the calling app, i.e. by SubscriptionManager.canManageSubscription(SubscriptionInfo). They may be active, or installed-but-inactive. This is generally intended to be called by carrier apps that directly manage their own eSIM profiles on the device in concert with android.telephony.EuiccManager.

Parameters:

list - - The subscription info list, can be null.

setAvailableSubscriptionInfoList

public void setAvailableSubscriptionInfoList(List<SubscriptionInfo> list)

Sets the available list of SubscriptionInfo. This call internally triggers SubscriptionManager.OnSubscriptionsChangedListener.onSubscriptionsChanged() to all the listeners.

"Available" here means all active subscriptions (see setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>)) combined with all installed-but-inactive eSIM subscriptions (similar to setAccessibleSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>), but not filtered to one particular app's "ownership" rights for subscriptions). This is generally intended to be called by system components such as the eSIM LPA or Settings that allow the user to manage all subscriptions on the device through some system-provided user interface.

Parameters:

list - - The subscription info list, can be null.

setActiveSubscriptionInfos

public void setActiveSubscriptionInfos(SubscriptionInfo... infos)

Sets the active list of SubscriptionInfo. This call internally triggers SubscriptionManager.OnSubscriptionsChangedListener.onSubscriptionsChanged() to all the listeners.

setAccessibleSubscriptionInfos

public void setAccessibleSubscriptionInfos(SubscriptionInfo... infos)

Sets the accessible list of SubscriptionInfo. This call internally triggers SubscriptionManager.OnSubscriptionsChangedListener.onSubscriptionsChanged() to all the listeners.

setAvailableSubscriptionInfos

public void setAvailableSubscriptionInfos(SubscriptionInfo... infos)

Sets the available list of SubscriptionInfo. This call internally triggers SubscriptionManager.OnSubscriptionsChangedListener.onSubscriptionsChanged() to all the listeners.

addOnSubscriptionsChangedListener

@Implementation(minSdk=22)
protected void addOnSubscriptionsChangedListener(SubscriptionManager.OnSubscriptionsChangedListener listener)

Adds a listener to a local list of listeners. Will be triggered by setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) when the local list of SubscriptionInfo is updated.

addOnSubscriptionsChangedListener

@Implementation(minSdk=30)
protected void addOnSubscriptionsChangedListener(Executor executor,
 SubscriptionManager.OnSubscriptionsChangedListener listener)

Adds a listener to a local list of listeners. Will be triggered by setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) when the local list of SubscriptionInfo is updated.

removeOnSubscriptionsChangedListener

@Implementation(minSdk=22)
protected void removeOnSubscriptionsChangedListener(SubscriptionManager.OnSubscriptionsChangedListener listener)

Removes a listener from a local list of listeners. Will be triggered by setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>) when the local list of SubscriptionInfo is updated.

hasOnSubscriptionsChangedListener

public boolean hasOnSubscriptionsChangedListener(SubscriptionManager.OnSubscriptionsChangedListener listener)

Check if a listener exists in the ShadowSubscriptionManager.listeners.

Parameters:

listener - The listener to check.

Returns:

boolean True if the listener already added, otherwise false.

getActiveSubscriptionIdList

@Implementation(minSdk=22)
@HiddenApi
protected int[] getActiveSubscriptionIdList()

Returns subscription Ids that were set via setActiveSubscriptionInfoList(java.util.List<android.telephony.SubscriptionInfo>).

clearNetworkRoamingStatus

public void clearNetworkRoamingStatus()

Clears the local cache of roaming subscription Ids used by isNetworkRoaming(int).

setNetworkRoamingStatus

public void setNetworkRoamingStatus(int simSubscriptionId,
 boolean isNetworkRoaming)

If isNetworkRoaming is set, it will mark the provided sim subscriptionId as roaming in a local cache. If isNetworkRoaming is unset it will remove the subscriptionId from the local cache. The local cache is used to provide roaming status returned by isNetworkRoaming(int).

isNetworkRoaming

@Implementation(minSdk=22)
protected boolean isNetworkRoaming(int simSubscriptionId)

Uses the local cache of roaming sim subscription Ids managed by setNetworkRoamingStatus(int, boolean) to return subscription Ids marked as roaming. Otherwise subscription Ids will be considered as non-roaming if they are not in the cache.

putPhoneId

public static void putPhoneId(int subId,
 int phoneId)

Adds a subscription ID-phone ID mapping to the map used by getPhoneId(int).

removePhoneId

public static Integer removePhoneId(int subId)

Removes a subscription ID-phone ID mapping from the map used by getPhoneId(int).

Returns:

the previous phone ID associated with the subscription ID, or null if there was no mapping for the subscription ID

clearPhoneIds

public static void clearPhoneIds()

Removes all mappings between subscription IDs and phone IDs from the map used by getPhoneId(int).

getPhoneId

@Implementation(minSdk=22,
                maxSdk=28)
@HiddenApi
protected static int getPhoneId(int subId)

Uses the map of subscription IDs to phone IDs managed by putPhoneId(int,int) and removePhoneId(int) to return the phone ID for a given subscription ID.

setReadPhoneStatePermission

public void setReadPhoneStatePermission(boolean readPhoneStatePermission)

When set to false methods requiring android.Manifest.permission.READ_PHONE_STATE permission will throw a SecurityException. By default it's set to true for backwards compatibility.

setReadPhoneNumbersPermission

public void setReadPhoneNumbersPermission(boolean readPhoneNumbersPermission)

When set to false methods requiring android.Manifest.permission.READ_PHONE_NUMBERS permission will throw a SecurityException. By default it's set to true for backwards compatibility.

getPhoneNumber

@Implementation(minSdk=33)
protected String getPhoneNumber(int subscriptionId)

Returns the phone number for the given subscriptionId, or an empty string if not available.

The phone number can be set by setPhoneNumber(int, String)

An exception will be thrown if the READ_PHONE_NUMBERS permission has not been granted.

getPhoneNumber

@Implementation(minSdk=33)
protected String getPhoneNumber(int subscriptionId,
 int source)

Returns the phone number for the given subscriptionId, or an empty string if not available. source is ignored and will return the same as getPhoneNumber(int).

The phone number can be set by setPhoneNumber(int, String)

setPhoneNumber

public void setPhoneNumber(int subscriptionId,
 String phoneNumber)

Sets the phone number returned by getPhoneNumber(int).

reset

@Resetter
public static void reset()