Package org.robolectric

Class RobolectricTestRunner

java.lang.Object
org.junit.runner.Runner
org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>
org.junit.runners.BlockJUnit4ClassRunner
org.robolectric.internal.SandboxTestRunner
org.robolectric.RobolectricTestRunner
All Implemented Interfaces:
org.junit.runner.Describable, org.junit.runner.manipulation.Filterable, org.junit.runner.manipulation.Orderable, org.junit.runner.manipulation.Sortable
Direct Known Subclasses:
RobolectricTestParameterInjector
public class RobolectricTestRunner extends SandboxTestRunner
Loads and runs a test in a SandboxClassLoader in order to provide a simulation of the Android runtime environment.

  • Field Details

  • Constructor Details

    • RobolectricTestRunner

      public RobolectricTestRunner(Class<?> testClass) throws org.junit.runners.model.InitializationError
      Creates a runner to run testClass. Use the Config annotation to configure.
      Parameters:
      testClass - the test class to be run
      Throws:
      org.junit.runners.model.InitializationError - if junit says so

    • RobolectricTestRunner

      protected RobolectricTestRunner(Class<?> testClass, Injector injector) throws org.junit.runners.model.InitializationError
      Throws:
      org.junit.runners.model.InitializationError

  • Method Details

    • defaultInjector

      protected static Injector.Builder defaultInjector()

    • createClassHandler

      @Nonnull protected ClassHandler createClassHandler(ShadowMap shadowMap, Sandbox sandbox)
      Create a ClassHandler appropriate for the given arguments.

      Robolectric may chose to cache the returned instance, keyed by shadowMap and sandbox.

      Custom TestRunner subclasses may wish to override this method to provide alternate configuration.

      Overrides:
      createClassHandler in class SandboxTestRunner
      Parameters:
      shadowMap - the ShadowMap in effect for this test
      sandbox - the Sdk in effect for this test
      Returns:
      an appropriate ShadowWrangler.
      Since:
      2.3

    • findInterceptors

      @Nonnull protected Collection<Interceptor> findInterceptors()
      Overrides:
      findInterceptors in class SandboxTestRunner

    • createClassLoaderConfig

      @Nonnull protected InstrumentationConfiguration createClassLoaderConfig(org.junit.runners.model.FrameworkMethod method)
      Create an InstrumentationConfiguration suitable for the provided FrameworkMethod.

      Adds configuration for Android using AndroidConfigurer.

      Custom TestRunner subclasses may wish to override this method to provide additional configuration.

      Overrides:
      createClassLoaderConfig in class SandboxTestRunner
      Parameters:
      method - the test method that's about to run
      Returns:
      an InstrumentationConfiguration

    • getTestLifecycleClass

      @Nonnull protected Class<? extends TestLifecycle> getTestLifecycleClass()
      An instance of the returned class will be created for each test invocation.

      Custom TestRunner subclasses may wish to override this method to provide alternate configuration.

      Returns:
      a class which implements TestLifecycle. This implementation returns a DefaultTestLifecycle.

    • getChildren

      protected List<org.junit.runners.model.FrameworkMethod> getChildren()
      Overrides:
      getChildren in class org.junit.runners.BlockJUnit4ClassRunner

    • getSandbox

      @Nonnull protected AndroidSandbox getSandbox(org.junit.runners.model.FrameworkMethod method)
      Overrides:
      getSandbox in class SandboxTestRunner

    • beforeTest

      protected void beforeTest(Sandbox sandbox, org.junit.runners.model.FrameworkMethod method, Method bootstrappedMethod) throws Throwable
      Overrides:
      beforeTest in class SandboxTestRunner
      Throws:
      Throwable

    • afterTest

      protected void afterTest(org.junit.runners.model.FrameworkMethod method, Method bootstrappedMethod)
      Overrides:
      afterTest in class SandboxTestRunner

    • finallyAfterTest

      protected void finallyAfterTest(org.junit.runners.model.FrameworkMethod method)
      Overrides:
      finallyAfterTest in class SandboxTestRunner

    • getHelperTestRunner

      protected SandboxTestRunner.HelperTestRunner getHelperTestRunner(Class<?> bootstrappedTestClass) throws org.junit.runners.model.InitializationError
      Overrides:
      getHelperTestRunner in class SandboxTestRunner
      Throws:
      org.junit.runners.model.InitializationError

    • getManifestFactory

      protected ManifestFactory getManifestFactory(Config config)
      Detects which build system is in use and returns the appropriate ManifestFactory implementation.

      Custom TestRunner subclasses may wish to override this method to provide alternate configuration.

      Parameters:
      config - Specification of the SDK version, manifest file, package name, etc.

    • getBuildSystemApiProperties

      protected Properties getBuildSystemApiProperties()

    • staticGetBuildSystemApiProperties

      protected static Properties staticGetBuildSystemApiProperties()

    • createAndroidManifest

      @Deprecated public static AndroidManifest createAndroidManifest(ManifestIdentifier manifestIdentifier)
      Deprecated.
      Do not use.
      Internal use only.

    • buildGlobalConfig

      @Deprecated protected Config buildGlobalConfig()
      Deprecated.
      Provide a service implementation of GlobalConfigProvider instead. This method will be removed in Robolectric 4.3.
      Provides the base Robolectric configuration Config used for all tests.

      Configuration provided for specific packages, test classes, and test method configurations will override values provided here.

      Custom TestRunner subclasses may wish to override this method to provide alternate configuration. Consider using a Config.Builder.

      The default implementation has appropriate values for most use cases.

      Returns:
      global Config object
      Since:
      3.1.3
      See Also:

    • getExtraShadows

      @Nonnull protected Class<?>[] getExtraShadows(org.junit.runners.model.FrameworkMethod frameworkMethod)
      Overrides:
      getExtraShadows in class SandboxTestRunner

    • afterClass

      protected void afterClass()
      Overrides:
      afterClass in class SandboxTestRunner

    • createTest

      public Object createTest() throws Exception
      Overrides:
      createTest in class org.junit.runners.BlockJUnit4ClassRunner
      Throws:
      Exception