Package org.robolectric

Class RuntimeEnvironment

java.lang.Object

org.robolectric.RuntimeEnvironment

public class RuntimeEnvironment
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static Application	application	Deprecated. Please migrate to androidx.test.core.app.ApplicationProvider#getApplicationContext
static Path	compileTimeSystemResourcesFile
static Context	systemContext

Constructor Summary

Constructors

Constructor	Description
RuntimeEnvironment()

Method Summary

Modifier and Type	Method	Description
static Number	castNativePtr(long ptr)
static Object	getActivityThread()
static Path	getAndroidFrameworkJarPath()
static int	getApiLevel()
static ResourceTable	getAppResourceTable()
static ResourceTable	getCompileTimeResourceTable()
static Thread	getMainThread()	Retrieves the main thread.
static Scheduler	getMasterScheduler()	Retrieves the current master scheduler.
static String	getQualifiers()	Returns a qualifier string describing the current Configuration of the system resources.
static String	getQualifiers(Configuration configuration, DisplayMetrics displayMetrics)	Returns a qualifier string describing the given configuration and display metrics.
static ResourceTable	getSystemResourceTable()
static TempDirectory	getTempDirectory()
static boolean	isMainThread()	Tests if the current thread is currently set as the main thread.
static boolean	isMainThread(Thread thread)	Tests if the given thread is currently set as the main thread.
static void	setActivityThread(Object newActivityThread)
static void	setAndroidFrameworkJarPath(Path localArtifactPath)
static void	setAppResourceTable(ResourceTable appResourceTable)
static void	setCompileTimeResourceTable(ResourceTable compileTimeResourceTable)
static void	setMainThread(Thread newMainThread)	Sets the main thread.
static void	setMasterScheduler(Scheduler masterScheduler)	Sets the current master scheduler.
static void	setQualifiers(String newQualifiers)	Overrides the current device configuration.
static void	setSystemResourceTable(ResourceTable systemResourceTable)
static void	setTempDirectory(TempDirectory tempDirectory)
static void	setUseLegacyResources(boolean useLegacyResources)	Deprecated. Do not use.
static boolean	useLegacyResources()	Deprecated. Do not use.

Methods inherited from class java.lang.Object

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

Field Detail

systemContext

public static Context systemContext

application

@Deprecated
public static Application application

Deprecated. Please migrate to androidx.test.core.app.ApplicationProvider#getApplicationContext

compileTimeSystemResourcesFile

public static Path compileTimeSystemResourcesFile

Constructor Detail

RuntimeEnvironment

public RuntimeEnvironment()

Method Detail

isMainThread

public static boolean isMainThread(Thread thread)

Tests if the given thread is currently set as the main thread.

Parameters:

thread - the thread to test.

Returns:

true if the specified thread is the main thread, false otherwise.

See Also:

isMainThread()

isMainThread

public static boolean isMainThread()

Tests if the current thread is currently set as the main thread.

Not supported in realistic looper mode.

Returns:

true if the current thread is the main thread, false otherwise.

getMainThread

public static Thread getMainThread()

Retrieves the main thread. The main thread is the thread to which the main looper is attached. Defaults to the thread that initialises the RuntimeEnvironment class.

Not supported in realistic looper mode.

Returns:

The main thread.

See Also:

setMainThread(Thread), isMainThread()

setMainThread

public static void setMainThread(Thread newMainThread)

Sets the main thread. The main thread is the thread to which the main looper is attached. Defaults to the thread that initialises the RuntimeEnvironment class.

Not supported in realistic looper mode.

Parameters:

newMainThread - the new main thread.

See Also:

setMainThread(Thread), isMainThread()

getActivityThread

public static Object getActivityThread()

setActivityThread

public static void setActivityThread(Object newActivityThread)

getQualifiers

public static String getQualifiers()

Returns a qualifier string describing the current Configuration of the system resources.

Returns:

a qualifier string as described (https://developer.android.com/guide/topics/resources/providing-resources.html#QualifierRules)[here].

getQualifiers

public static String getQualifiers(Configuration configuration,
                                   DisplayMetrics displayMetrics)

Returns a qualifier string describing the given configuration and display metrics.

Parameters:

configuration - the configuration.

displayMetrics - the display metrics.

Returns:

a qualifier string as described (https://developer.android.com/guide/topics/resources/providing-resources.html#QualifierRules)[here].

setQualifiers

public static void setQualifiers(String newQualifiers)

Overrides the current device configuration.

If {@param newQualifiers} starts with a plus ('+'), the prior configuration is used as the base configuration, with the given changes applied additively. Otherwise, default values are used for unspecified properties, as described here.

Parameters:

newQualifiers - the qualifiers to apply

getApiLevel

public static int getApiLevel()

castNativePtr

public static Number castNativePtr(long ptr)

getMasterScheduler

public static Scheduler getMasterScheduler()

Retrieves the current master scheduler. This scheduler is always used by the main Looper, and if the global scheduler option is set it is also used for the background scheduler and for all other Loopers

Returns:

The current master scheduler.

See Also:

see org.robolectric.Robolectric#getForegroundThreadScheduler() see org.robolectric.Robolectric#getBackgroundThreadScheduler()

setMasterScheduler

public static void setMasterScheduler(Scheduler masterScheduler)

Sets the current master scheduler. See getMasterScheduler() for details. Note that this method is primarily intended to be called by the Robolectric core setup code. Changing the master scheduler during a test will have unpredictable results.

Parameters:

masterScheduler - the new master scheduler.

See Also:

see org.robolectric.Robolectric#getForegroundThreadScheduler() see org.robolectric.Robolectric#getBackgroundThreadScheduler()

setSystemResourceTable

public static void setSystemResourceTable(ResourceTable systemResourceTable)

setAppResourceTable

public static void setAppResourceTable(ResourceTable appResourceTable)

getSystemResourceTable

public static ResourceTable getSystemResourceTable()

getAppResourceTable

public static ResourceTable getAppResourceTable()

setCompileTimeResourceTable

public static void setCompileTimeResourceTable(ResourceTable compileTimeResourceTable)

getCompileTimeResourceTable

public static ResourceTable getCompileTimeResourceTable()

setTempDirectory

public static void setTempDirectory(TempDirectory tempDirectory)

getTempDirectory

public static TempDirectory getTempDirectory()

setAndroidFrameworkJarPath

public static void setAndroidFrameworkJarPath(Path localArtifactPath)

getAndroidFrameworkJarPath

public static Path getAndroidFrameworkJarPath()

useLegacyResources

@Deprecated
public static boolean useLegacyResources()

Deprecated. Do not use.

Internal only.

setUseLegacyResources

@Deprecated
public static void setUseLegacyResources(boolean useLegacyResources)

Deprecated. Do not use.

Internal only.