org.robolectric

Class RuntimeEnvironment

java.lang.Object

org.robolectric.RuntimeEnvironment

public class RuntimeEnvironment
extends java.lang.Object

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
RuntimeEnvironment()

Method Summary

Modifier and Type	Method and Description
static java.lang.Number	castNativePtr(long ptr)
static java.lang.Object	getActivityThread()
static java.lang.String	getAndroidFrameworkJarPath()
static int	getApiLevel()
static ResourceTable	getAppResourceTable()
static ResourceTable	getCompileTimeResourceTable()
static java.lang.Thread	getMainThread() Retrieves the main thread.
static Scheduler	getMasterScheduler() Retrieves the current master scheduler.
static java.lang.String	getQualifiers() Returns a qualifier string describing the current Configuration of the system resources.
static java.lang.String	getQualifiers(android.content.res.Configuration configuration, android.util.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(java.lang.Thread thread) Tests if the given thread is currently set as the main thread.
static void	setActivityThread(java.lang.Object newActivityThread)
static void	setAndroidFrameworkJarPath(java.lang.String localArtifactPath)
static void	setAppResourceTable(ResourceTable appResourceTable)
static void	setCompileTimeResourceTable(ResourceTable compileTimeResourceTable)
static void	setMainThread(java.lang.Thread newMainThread) Sets the main thread.
static void	setMasterScheduler(Scheduler masterScheduler) Sets the current master scheduler.
static void	setQualifiers(java.lang.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 android.content.Context systemContext

application

@Deprecated
public static android.app.Application application

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

compileTimeSystemResourcesFile

public static FsFile compileTimeSystemResourcesFile

Constructor Detail

RuntimeEnvironment

public RuntimeEnvironment()

Method Detail

isMainThread

public static boolean isMainThread(java.lang.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.

Returns:

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

getMainThread

public static java.lang.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.

Returns:

The main thread.

See Also:

setMainThread(Thread), isMainThread()

setMainThread

public static void setMainThread(java.lang.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.

Parameters:

newMainThread - the new main thread.

See Also:

setMainThread(Thread), isMainThread()

getActivityThread

public static java.lang.Object getActivityThread()

setActivityThread

public static void setActivityThread(java.lang.Object newActivityThread)

getQualifiers

public static java.lang.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 java.lang.String getQualifiers(android.content.res.Configuration configuration,
                                             android.util.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(java.lang.String newQualifiers)

Overrides the current device configuration.

If 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 java.lang.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(java.lang.String localArtifactPath)

getAndroidFrameworkJarPath

public static java.lang.String 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.