Robolectric-Instrumentation is obsolete. Use Robolectric 4.0 which has the same functionality as this project:

http://robolectric.org/blog/2018/10/25/robolectric-4-0/

---

Robolectric Instrumentation

This is an API wrapper for Android Instrumentation Testing Framework with Robolectric.

Synopsis

Look at the following test case, ExampleTest, which works on JVM with Robolectric, as well as on Android Instrumentation Tests:

package com.github.gfx.android.robolectricinstrumentation;

import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

import android.content.Context;
import android.support.test.InstrumentationRegistry;
import android.support.test.rule.ActivityTestRule;
import android.support.test.runner.AndroidJUnit4;

import static org.hamcrest.CoreMatchers.*;
import static org.junit.Assert.*;

@RunWith(AndroidJUnit4.class)
public class ExampleTest {

    boolean runOnAndroid() {
        return System.getProperty("java.vm.name").equals("Dalvik");
    }

    @Test
    public void testGetContext() throws Exception {
        Context context = InstrumentationRegistry.getTargetContext();
        assertThat(context, is(instanceOf(Context.class)));
    }

    @Test
    public void testGetString() throws Exception {
        Context context = InstrumentationRegistry.getTargetContext();
        assertThat(context.getString(R.string.app_name), is("RobolectricInstrumentation"));
    }

    // Because Robolectric-Instrumentation is limited, you can skip tests
    // that only work with Android Instrumentation.
    public void testPerformClickWithEspresso() throws Exception {
        assumeTrue("Robolectric-Instrumentation does not support Espresso", runOnAndroid());

        onView(withId(R.id.button))
                .perform(click());
    }
}

Getting Started

Suppose your have an Android application project with app sub-project, which already have a test suite with Robolectric.

First, you have to make a Robolectric configuration file as app/src/test/resources/roblectric.properties with the following contents:

# this is robolectric-instrumentation specific configuration:
project=app
# and other Robolectric configurations
constants=com.example.app.BuildConfig
sdk=16

Second, set testInstrumentationRunner to AndroidJUnitRunner to run Android Instrumentation Tests with JUnit4.

// app/build.gradle
android {
  defaultConfig {
    testInstrumentationRunner 'android.support.test.runner.AndroidJUnitRunner'
  }
}

Then, rewrite your test cases to use Android Instrumentation Framework, instead of raw Robolectric API.

+ @RunWith(AndroidJUnit4.class)
- @RunWith(RobolectricGradleTestRunner.class)
- @Config(constants = BuildConfig.class, sdk = 16)

+ Context context = InstrumentationRegistry.getContext();
- Context context = RuntimeEnvironment.application;

Finally, make a symlink of test to androidTest.

(cd "app/src" && ln -s "test" "androidTest")

Now you can run ./gradlew connectedAndroidTest, as well as ./gradlew test

How It Works

This library implements part of com.android.support.test:runner:0.5, which provides Android Instrumentation Framework, i.e. JUnit4 runners and InstrumentationRegistry.

Here is the list of API supported by Robolectric-Instrumentation:

Android Instrumentation Framework

• @RunWith(AndroidJUnit4.class)
• InstrumentationRegistry.getTargetContext()
• InstrumentationRegistry.getInstrumentation()

Espresso

Not supported.

How To Manage Dependencies

Depend on Robolectric-Instrumentation as testCompile, and com.android.support.test:runner as androidTestCompile.

Both testCompile ... and androidTestCompile ... are required.

dependencies {
    testCompile 'com.github.gfx.android.robolectricinstrumentation:robolectric-instrumentation:3.1.4'
    testCompile 'junit:junit:4.12'
    androidTestCompile 'com.android.support.test:runner:0.5'
    androidTestCompile 'junit:junit:4.12'
}

Logging

-Drobolectric.logging=stdout for android.util.Log.

-Drobolectric.logging.enabled=true for Robolectric itself.

Practical Examples

• Migration of the test suite to use Robolectric-Instrumentation by gfx · Pull Request #35 · gfx/Android-Helium

Versioning

This library does not adopt semantic versioning. Rather, the first two parts indicate the compatible version of Robolectric. That is, v3.1.x of this library is compatible with Robolectric v3.1.y.

The last part of the version is the revision of this library.

See Also

• Testing Fundamentals | Android Developers
• android.support.test | Android Developers

Author

FUJI Goro (gfx).

License

Copyright (c) 2015 FUJI Goro (gfx).

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.