Robolectric Installation for Unit Testing

Robolectric is a framework which mocks part of the Android framework contained in the android.jar file and which allows you to run Android tests directly on the JVM with the JUnit 4 framework.

Robolectric is designed to allow you to test Android applications on the JVM. This enables you to run your Android tests in your continuous integration environment without any additional setup and without an emulator running. Because of this Robolectric is really fast in comparison to any other testing approach.

Let's take a look at a step-by-step for setting up Robolectric to test your project.

Setting up for Android Studio

Configure build.gradle

You'll need to setup your build.gradle configuration to include the Robolectric Gradle plugin:

buildscript {
   repositories {
      mavenCentral()
   } 
   dependencies {
      classpath 'com.android.tools.build:gradle:0.12.+'
      classpath 'org.robolectric:robolectric-gradle-plugin:0.12.+'
   }
}

apply plugin: 'roboelectric'

Within your dependencies, you need to include the following defines. The exclude modules are intended to remove transitive dependencies (template borrowed from https://github.com/robolectric/deckard-gradle/blob/master/README.md)

dependencies {
  compile fileTree(dir: 'libs', include: ['*.jar'])

  // borrowed from https://github.com/robolectric/deckard-gradle/blob/master/build.gradle
  androidTestCompile 'org.hamcrest:hamcrest-integration:1.1'
  androidTestCompile 'org.hamcrest:hamcrest-core:1.1'
  androidTestCompile 'org.hamcrest:hamcrest-library:1.1'

  androidTestCompile('junit:junit:4.+') {
     exclude module: 'hamcrest-core'
  }
  androidTestCompile('org.robolectric:robolectric:2.3') {
     exclude module: 'classworlds'
     exclude module: 'commons-logging'
     exclude module: 'httpclient'
     exclude module: 'maven-artifact'
     exclude module: 'maven-artifact-manager'
     exclude module: 'maven-error-diagnostics'
     exclude module: 'maven-model'
     exclude module: 'maven-project'
     exclude module: 'maven-settings'
     exclude module: 'plexus-container-default'
     exclude module: 'plexus-interpolation'
     exclude module: 'plexus-utils'
     exclude module: 'wagon-file'
     exclude module: 'wagon-http-lightweight'
     exclude module: 'wagon-provider-api'
 }
}

Creating resource directory

Create an androidTest/resources/org.roboelectric.Config.properties file:

# Robolectric doesn't know how to support SDK 19 yet.
emulateSdk=18

Running tests

Currently, there is a bug in Android Studio that triggers "java.lang.RuntimeException: Stub!" errors when trying to run from the IDE (for more context, see https://github.com/robolectric/deckard-gradle/blob/master/README.md). If you type ./gradlew test from the command line, tests should run correctly.

Setting up for Eclipse

Download Library JARs

Let's download the robolectric jar with dependencies for use and an additional library called fest-util.jar and then fest-android.jar.

Create Test Folder

We can have our tests live in the main project. First, we want to create a "test" directory at the root of our SimpleApp project. On SimpleApp, choose "New... → Folder" and name the folder "test"

Create Robolectric Java Test Project

Next, let's create our electric test project for our app. Create a Java Project called "SimpleAppElectricTest". Do not create an Android project, or an Android JUnit project, but a simple Java Project .

Configure Source Folders

Click "Next", Expand the SimpleAppElectricTest row and select the "src" row - Click link "Remove source folder 'src' from build path"

Click link "Link additional source" - Browse to and select ".../SimpleApp/test" folder we created earlier.

Click "Finish" on the "Link additional sources" dialog (but keep the new Java project dialog open)

Add Project Dependency

Select "Projects" tab at the top of the "New Java Project dialog" - Click "Add..." - Check "SimpleApp" - Click "OK" - Click "Finish" closing the new Java project dialog

Load Robolectric Library

Create a "lib" folder in the test project with "New...Folder". Move the robolectric jar and the fest-util.jar into the lib folder for the SimpleAppElectricTest project.

Add the jar to the Java Build Path for the project by right-clicking test project and hover "Build Path" and click "Configure Build Path"

Select "Add JARs" and select the two jars within the "lib" folder. Hit "OK" to confirm adding these JARs to the build path. Keep the "Libraries" tab open in the "Java Build Path" dialog

Add JUnit library

Select "Add Library" - Select "JUnit" - Click "Next" - Select JUnit library version 4 (Robolectric is not compatible with JUnit 3) - Click "Finish" (keep the Properties dialog for SimpleAppElectricTest open)

Add Android Jars

Click "Add External Jars..." - Navigate to /platforms/android-8/android.jar - Click "Open" (keep the Properties dialog for SimpleAppElectricTest open)

Click "Add External Jars..." - Navigate to /add-ons/addongoogleapisgoogleinc_8/libs/maps.jar - Click "Open". Click "OK" on the Properties for SimpleAppElectricTest dialog

Now we are almost done! Just need to setup the run configuration for our tests.

Setup Run Configuration

Note: Your tests will not run without this step. Your resources will not be found.

Select "Run" → "Run Configurations..."

Double click "JUnit" (not "Android JUnit Test") - Name: SimpleAppElectricTest - Select the "Run all tests in the selected project, package or source folder:" radio button - Click the "Search" button - Select "SimpleAppElectricTest" - TestRunner: JUnit 4

Click on the link "Multiple launchers available Select one..." at the bottom of the dialog - Check the "Use configuration specific settings" box - Select "Eclipse JUnit Launcher" - Click "OK"

Click the "Arguments" tab - Under "Working directory:" select the "Other:" radio button - Click "Workspace..." - Select "SimpleApp" (not "SimpleAppElectricTest", The value inside of 'Other' edit box should be '${workspace_loc:SimpleApp}') - Click "OK" - Click "Close"

Verify Installation

Create a temporary test to verify that the installation was correct. Create a file in the "test" folder in SimpleAppElectricTest. Create "MyActivityTest" in the "com.codepath.example.simpleapp.test" with the following code:

package com.codepath.example.simpleapp.test;

import static org.hamcrest.CoreMatchers.equalTo;
import static org.junit.Assert.assertThat;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.robolectric.RobolectricTestRunner;

import com.codepath.example.simpleapp.FirstActivity;
import com.codepath.example.simpleapp.R;

@RunWith(RobolectricTestRunner.class)
public class MyActivityTest {

    @Test
    public void shouldHaveHappySmiles() throws Exception {
        String hello = new FirstActivity().getResources().getString(R.string.hello_world);
        assertThat(hello, equalTo("Hello World!"));
    }

}

Run the tests by right-clicking on the test project and selecting "Run As..." => "Junit Test"

And if that passes green, then Robolectric has been properly installed!