Package org.robolectric.annotation

Annotation Type Config

@Documented @Inherited @Retention(RUNTIME) @Target({TYPE,METHOD}) public @interface Config
Configuration settings that can be used on a per-class or per-test basis.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    static class 
    Config.Builder
     
    static class 
    Config.Implementation
     

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    @Nullable Class<? extends Application>
    application
    The Application class to use in the test, this takes precedence over any application specified in the AndroidManifest.xml.
    float
    fontScale
    The default font scale.
    @NonNull String @NonNull []
    instrumentedPackages
    A list of instrumented packages, in addition to those that are already instrumented.
    @NonNull String
    manifest
    Deprecated.
    If you are using at least Android Studio 3.0 alpha 5 or Bazel's android_local_test please migrate to the preferred way to configure builds http://robolectric.org/getting-started/
    int
    maxSdk
    The maximum Android SDK level to emulate when running tests on multiple API versions.
    int
    minSdk
    The minimum Android SDK level to emulate when running tests on multiple API versions.
    @NonNull String
    qualifiers
    Qualifiers specifying device configuration for this test, such as "fr-normal-port-hdpi".
    int @NonNull []
    sdk
    The Android SDK level to emulate.
    @NonNull Class<?> @NonNull []
    shadows
    A list of shadow classes to enable, in addition to those that are already present.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    ALL_SDKS
     
    static final Class<? extends Application>
    DEFAULT_APPLICATION
     
    static final float
    DEFAULT_FONT_SCALE
     
    static final String
    DEFAULT_MANIFEST_NAME
     
    static final String
    DEFAULT_QUALIFIERS
     
    static final int
    DEFAULT_VALUE_INT
     
    static final String
    DEFAULT_VALUE_STRING
     
    static final int
    NEWEST_SDK
     
    static final String
    NONE
    TODO(vnayar): Create named constants for default values instead of magic numbers.
    static final int
    OLDEST_SDK
     
    static final int
    TARGET_SDK
     

  • Field Details

  • Element Details

    • sdk

      int @NonNull [] sdk
      The Android SDK level to emulate. This value will also be set as Build.VERSION.SDK_INT.
      Default:
      {}

    • minSdk

      int minSdk
      The minimum Android SDK level to emulate when running tests on multiple API versions.
      Default:
      -1

    • maxSdk

      int maxSdk
      The maximum Android SDK level to emulate when running tests on multiple API versions.
      Default:
      -1

    • fontScale

      float fontScale
      The default font scale. In U+, users will have a slider to determine font scale. In all previous APIs, font scales are either small (0.85f), normal (1.0f), large (1.15f) or huge (1.3f)
      Default:
      1.0f

    • manifest

      @Deprecated @NonNull String manifest
      Deprecated.
      If you are using at least Android Studio 3.0 alpha 5 or Bazel's android_local_test please migrate to the preferred way to configure builds http://robolectric.org/getting-started/
      The Android manifest file to load; Robolectric will look relative to the current directory. Resources and assets will be loaded relative to the manifest.

      If not specified, Robolectric defaults to AndroidManifest.xml.

      If your project has no manifest or resources, use NONE.

      Returns:
      The Android manifest file to load.
      Default:
      "--default"

    • application

      @Nullable Class<? extends Application> application
      The Application class to use in the test, this takes precedence over any application specified in the AndroidManifest.xml.
      Returns:
      The Application class to use in the test.
      Default:
      org.robolectric.annotation.DefaultApplication.class

    • qualifiers

      @NonNull String qualifiers
      Qualifiers specifying device configuration for this test, such as "fr-normal-port-hdpi".

      If the string is prefixed with '+', the qualifiers that follow are overlaid on any more broadly-scoped qualifiers.

      Returns:
      Qualifiers used for device configuration and resource resolution.
      See Also:
      Default:
      ""

    • shadows

      @NonNull Class<?> @NonNull [] shadows
      A list of shadow classes to enable, in addition to those that are already present.
      Returns:
      A list of additional shadow classes to enable.
      Default:
      {}

    • instrumentedPackages

      @NonNull String @NonNull [] instrumentedPackages
      A list of instrumented packages, in addition to those that are already instrumented.
      Returns:
      A list of additional instrumented packages.
      Default:
      {}