Unit Testing Example

Introduction

SDK Version: M3

In this example I'm gonna show you how to test a simple class using Eclipse for android development. For unit testing you can use the built in JUnit framework just like in "standard" java applications.
If you need more information about testing check this article as well.

Unit Testing

A unit test is to test some low-level part - usually a single class - of a project, working individually.

The only trick is to extend AndroidTestCase in your test case instead of TestCase some Android specific methods, like getContext() which is often required by android functions.

Lets see a very simple example using eclipse:

Create a new project to test, create a new class in it, with a simple method that , like this:

public class ClassToTest{
	public int add(int arg1,int arg2){
		return arg1+arg2;
	}
}

Create a new test project: File/new/Other.../Android/Android Test Project

Unit_Testing_01

Add the previously created project as the test target, the other fields can be left as they are auto filled.

Add a test case to the test project, by left clicking on the package new/other../java/junit test case

Unit_Testing_02

Be sure tho change superclass to junit.framework.TestCase. For some reason eclipse does not fill out constuctor properly, so just uncheck it for now.

The automatically generated testcase will look like this:

import com.helloandroid.projecttotest.ClassToTest;
import android.test.AndroidTestCase;
 
public class TestCaseName extends AndroidTestCase {
	protected void setUp() throws Exception {
		super.setUp();
	}
 
	protected void tearDown() throws Exception {
		super.tearDown();
	}
}

The setUp() method runs once before all test methods, the tearDown() runs after all tests are runned.

Now add a testing method, and do some initialization in setUp():

public class TestCaseName extends AndroidTestCase {
	ClassToTest mClassToTest;
	int mArg1;
	int mArg2;
 
	protected void setUp() throws Exception {
		mClassToTest=new ClassToTest();
		mArg1=6;
		mArg2=3;
		super.setUp();
	}
 
	protected void tearDown() throws Exception {
		super.tearDown();
	}
 
	public void testAdd(){
		assertEquals(9,mClassToTest.add(mArg1,mArg2));
	}
  }