FileDocCategorySizeDatePackage
ActivityInstrumentationTestCase.javaAPI DocAndroid 1.5 API3727Wed May 06 22:42:02 BST 2009android.test

ActivityInstrumentationTestCase

public abstract class ActivityInstrumentationTestCase extends ActivityTestCase
This class provides functional testing of a single activity. The activity under test will be created using the system infrastructure (by calling InstrumentationTestCase.launchActivity()) and you will then be able to manipulate your Activity directly. Most of the work is handled automatically here by {@link #setUp} and {@link #tearDown}.

If you prefer an isolated unit test, see {@link android.test.ActivityUnitTestCase}.

deprecated
new tests should be written using {@link android.test.ActivityInstrumentationTestCase2}, which provides more options for configuring the Activity under test

Fields Summary
String
mPackage
Class
mActivityClass
boolean
mInitialTouchMode
Constructors Summary
public ActivityInstrumentationTestCase(String pkg, Class activityClass)
NOTE: The parameter pkg must refer to the package identifier of the package hosting the activity to be launched, which is specified in the AndroidManifest.xml file. This is not necessarily the same as the java package name.

param
pkg The package hosting the activity to be launched.
param
activityClass The activity to test.


                                                                
         
        this(pkg, activityClass, false);
    
public ActivityInstrumentationTestCase(String pkg, Class activityClass, boolean initialTouchMode)
NOTE: The parameter pkg must refer to the package identifier of the package hosting the activity to be launched, which is specified in the AndroidManifest.xml file. This is not necessarily the same as the java package name.

param
pkg The package hosting the activity to be launched.
param
activityClass The activity to test.
param
initialTouchMode true = in touch mode

        mPackage = pkg;
        mActivityClass = activityClass;
        mInitialTouchMode = initialTouchMode;
    
Methods Summary
public TgetActivity()

        return (T) super.getActivity();
    
protected voidsetUp()

        super.setUp();
        // set initial touch mode
        getInstrumentation().setInTouchMode(mInitialTouchMode);
        setActivity(launchActivity(mPackage, mActivityClass, null));
    
protected voidtearDown()

        getActivity().finish();
        setActivity(null);
        
        // Scrub out members - protects against memory leaks in the case where someone 
        // creates a non-static inner class (thus referencing the test case) and gives it to
        // someone else to hold onto
        scrubClass(ActivityInstrumentationTestCase.class);

        super.tearDown();
    
public voidtestActivityTestCaseSetUpProperly()

        assertNotNull("activity should be launched successfully", getActivity());