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 Project/** 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides functional testing of a single activity. The activity under test will 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be created using the system infrastructure (by calling InstrumentationTestCase.launchActivity()) 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and you will then be able to manipulate your Activity directly. Most of the work is handled 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * automatically here by {@link #setUp} and {@link #tearDown}. 26b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If you prefer an isolated unit test, see {@link android.test.ActivityUnitTestCase}. 28b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * 29b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * @deprecated new tests should be written using 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.test.ActivityInstrumentationTestCase2}, which provides more options for 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * configuring the Activity under test 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project@Deprecated 34b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linznerpublic abstract class ActivityInstrumentationTestCase<T extends Activity> 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project extends ActivityTestCase { 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String mPackage; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class<T> mActivityClass; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean mInitialTouchMode = false; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4190762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * Creates an {@link ActivityInstrumentationTestCase} in non-touch mode. 42b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * 4390762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * @param pkg ignored - no longer in use. 4490762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * @param activityClass The activity to test. This must be a class in the instrumentation 4590762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * targetPackage specified in the AndroidManifest.xml 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ActivityInstrumentationTestCase(String pkg, Class<T> activityClass) { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this(pkg, activityClass, false); 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5290762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * Creates an {@link ActivityInstrumentationTestCase}. 5390762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * 5490762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * @param pkg ignored - no longer in use. 5590762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * @param activityClass The activity to test. This must be a class in the instrumentation 5690762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot * targetPackage specified in the AndroidManifest.xml 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param initialTouchMode true = in touch mode 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 59b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner public ActivityInstrumentationTestCase(String pkg, Class<T> activityClass, 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean initialTouchMode) { 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mActivityClass = activityClass; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInitialTouchMode = initialTouchMode; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public T getActivity() { 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (T) super.getActivity(); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void setUp() throws Exception { 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.setUp(); 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // set initial touch mode 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getInstrumentation().setInTouchMode(mInitialTouchMode); 7590762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot final String targetPackageName = getInstrumentation().getTargetContext().getPackageName(); 7690762d35a99e32ed22cdfb1f81252544ee22e30bBrett Chabot setActivity(launchActivity(targetPackageName, mActivityClass, null)); 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void tearDown() throws Exception { 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getActivity().finish(); 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setActivity(null); 83b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner 84b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner // Scrub out members - protects against memory leaks in the case where someone 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // creates a non-static inner class (thus referencing the test case) and gives it to 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // someone else to hold onto 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scrubClass(ActivityInstrumentationTestCase.class); 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.tearDown(); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void testActivityTestCaseSetUpProperly() throws Exception { 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project assertNotNull("activity should be launched successfully", getActivity()); 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 96