Android automated testing (Robotium)

4 Comments

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.

Author

Mihal Celovski

Share on FacebookGoogle+Share on LinkedInTweet about this on TwitterShare on RedditDigg thisShare on StumbleUpon

Kommentare

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

  • August 12, 2011 von Shivang Seth

    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 :)

    • August 17, 2011 von Mihal Celovski

      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

  • very useful for the beginners.

Comment

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