Android automated testing (Robotium)

In the previous GWT project we worked with acceptance tests and the Robot Framework. The question I asked myself was if something similar exists for Android. Yes, it exists, and its name is Robotium.
Robotium is a test framework created to write robust automatic black-box test cases for Android applications. With the support of Robotium, test case developers can write function, system and acceptance test scenarios, spanning multiple Android activities. It allows you to create test cases for Android Activities, Dialogs, Toasts, Menus and Context Menus etc.

This is one very simple example how to write Robotium tests:

  1. Create an Android test project if one does not exist (explained earlier in my post: Android testing in brief).
  2. Create a test class. For example, if you want to test activity “MyAndroidActivity”, your test class then needs to extend android.test.ActivityInstrumentationTestCase2.
  3.  

    public class MyAndroidActivityTest extends android.test.ActivityInstrumentationTestCase2 {
  4. Download robotium-solo-xxx.jar library or add a dependency to it in the *.pom file of your maven project. It’s open source at Google Code.
  5. Declare a Solo class instance. When writing tests there is no need to plan for or expect new activities in the test case. All is handled automatically by Robotium-Solo. Robotium-Solo can be used in conjunction with ActivityInstrumentationTestCase2. The test cases are written from a user perspective were technical details are not needed.
  6.  

    private Solo solo;
  7. Create a test class constructor.
  8.  

    public MyAndroidActivityTest() {
    	super("com.example", MyAndroidActivity.class);
    }
  9. Override the setUp() and tearDown() methods. Overriden  setUp() method is usually the  place where you  instantiate Solo object. In teardDown()  method solo.finalize()  is called and all activites that have been opened are finished.
  10.  

    @Override
    protected void setUp() throws Exception {
    	super.setUp();
    	solo = new Solo(getInstrumentation(), getActivity());
    }
     
    @Override
    protected void tearDown() throws Exception {
    	try {
    		solo.finalize();
    	} catch (Throwable e) {
    		e.printStackTrace();
    	}
    	getActivity().finish();
    	super.tearDown();
    }
  11. Create a test method. Robotium-Solo offers a number of methods for testing various UI events such as: clickOnText(), enterText(), clearEditText, goBack, serachText() etc.
  12.  

    public void testDisplayedText() throws InterruptedException {
    	Assert.assertTrue(solo.searchText("Hello world,my activity"));
    	Assert.assertTrue(getActivity().getString(R.string.hello_string).equals(solo.getCurrentActivity().getTitle()));
    }

As you can see it is all very similar to Robot-Selenium tests. When you decide to run this test you have to start the Emulator or connect an actual device to your computer. Then you just select your test class and select Run As/ Android JUnit test. After that you can see your application start and some actions execute. The JUnit view in your Eclipse window shows the current progress and success of the test runs.

Robotium benefits

Robotium tests have great readability compared to standard instrumentation tests. No great knowledge of the tested application is needed, just things like the name of the Activity, displayed texts or anything related to application’s UI. But one of the greatest benefits for us is the possibility to integrate tests with Maven as part of continuous integration.

  • Facebook
  • Delicious
  • Digg
  • StumbleUpon
  • Reddit
  • Blogger
  • LinkedIn
Mihal Celovski

4 Responses to Android automated testing (Robotium)

  1. James Elsey says:

    Very clear and concise tutorial, thank you very much :)

  2. Shivang Seth says:

    Would you elaborate on how to write test cases for an application having multiple activities/services. Should we extend the test case classes from android.test.ActivityInstrumentationTestCase2 or android.test.InstrumentationTestCase? An example would be very handy. Thank you :)

    • Mihal Celovski says:

      You can test a number of activities by using solo.goBack () method and going forward and backward through activities. Example:

      solo.clickOnButton(“Start Activity1″); // start the first activity
      Assert.assertTrue(solo.searchText(“Some text on Activity1″));
      Assert.assertTrue(getActivity().getString(R.string.activity1_title)
      .equals(solo.getCurrentActivity().getTitle()));

      solo.goBack(); // go back to start page(activity)

      solo.clickOnButton(“Start Activity2″); // start the second activity

  3. Ravee says:

    very useful for the beginners.

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>