ActivityInstrumentationTestCase.java revision 72d5de71f205d1c7f43c495d01185b0fbba7c47f
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.test; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.Activity; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.reflect.Field; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides functional testing of a single activity. The activity under test will 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be created using the system infrastructure (by calling InstrumentationTestCase.launchActivity()) 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and you will then be able to manipulate your Activity directly. Most of the work is handled 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically here by {@link #setUp} and {@link #tearDown}. 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If you prefer an isolated unit test, see {@link android.test.ActivityUnitTestCase}. 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @deprecated new tests should be written using 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.test.ActivityInstrumentationTestCase2}, which provides more options for 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * configuring the Activity under test 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project@Deprecated 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class ActivityInstrumentationTestCase<T extends Activity> 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project extends ActivityTestCase { 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String mPackage; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class<T> mActivityClass; 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean mInitialTouchMode = false; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4372d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * <b>NOTE:</b> The parameter <i>pkg</i> must refer to the package identifier of the 4472d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * package hosting the activity to be launched, which is specified in the AndroidManifest.xml 4572d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * file. This is not necessarily the same as the java package name. 4672d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * 4772d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * @param pkg The package hosting the activity to be launched. 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param activityClass The activity to test. 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ActivityInstrumentationTestCase(String pkg, Class<T> activityClass) { 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this(pkg, activityClass, false); 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5572d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * <b>NOTE:</b> The parameter <i>pkg</i> must refer to the package identifier of the 5672d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * package hosting the activity to be launched, which is specified in the AndroidManifest.xml 5772d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * file. This is not necessarily the same as the java package name. 5872d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * 5972d5de71f205d1c7f43c495d01185b0fbba7c47fAndy Stadler * @param pkg The package hosting the activity to be launched. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param activityClass The activity to test. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param initialTouchMode true = in touch mode 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ActivityInstrumentationTestCase(String pkg, Class<T> activityClass, 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean initialTouchMode) { 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPackage = pkg; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mActivityClass = activityClass; 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInitialTouchMode = initialTouchMode; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public T getActivity() { 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (T) super.getActivity(); 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setUp() throws Exception { 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.setUp(); 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // set initial touch mode 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getInstrumentation().setInTouchMode(mInitialTouchMode); 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setActivity(launchActivity(mPackage, mActivityClass, null)); 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void tearDown() throws Exception { 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getActivity().finish(); 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setActivity(null); 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Scrub out members - protects against memory leaks in the case where someone 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // creates a non-static inner class (thus referencing the test case) and gives it to 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // someone else to hold onto 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scrubClass(ActivityInstrumentationTestCase.class); 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.tearDown(); 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void testActivityTestCaseSetUpProperly() throws Exception { 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project assertNotNull("activity should be launched successfully", getActivity()); 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 100