19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 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 Projectimport android.app.Instrumentation; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.KeyEvent; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.reflect.Field; 27192ab903887bbb8e7c7b6da5c581573850e30f46Gilles Debunneimport java.lang.reflect.InvocationTargetException; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.reflect.Method; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.lang.reflect.Modifier; 30192ab903887bbb8e7c7b6da5c581573850e30f46Gilles Debunne 31192ab903887bbb8e7c7b6da5c581573850e30f46Gilles Debunneimport junit.framework.TestCase; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A test case that has access to {@link Instrumentation}. 35b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * 36b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * @deprecated Use 37b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * <a href="{@docRoot}reference/android/support/test/InstrumentationRegistry.html"> 38b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * InstrumentationRegistry</a> instead. New tests should be written using the 39b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * <a href="{@docRoot}tools/testing-support-library/index.html">Android Testing Support Library</a>. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 41b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner@Deprecated 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class InstrumentationTestCase extends TestCase { 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Instrumentation mInstrumentation; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Injects instrumentation into this test case. This method is 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called by the test runner during test setup. 49b51617f4668ef8cf0e6d8d0fc3284eae51dbd8caStephan Linzner * 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param instrumentation the instrumentation to use with this instance 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 527aba54b2edcb94f43c991c555b23fc1de364835eJack Wang public void injectInstrumentation(Instrumentation instrumentation) { 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mInstrumentation = instrumentation; 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 577aba54b2edcb94f43c991c555b23fc1de364835eJack Wang * Injects instrumentation into this test case. This method is 587aba54b2edcb94f43c991c555b23fc1de364835eJack Wang * called by the test runner during test setup. 597aba54b2edcb94f43c991c555b23fc1de364835eJack Wang * 607aba54b2edcb94f43c991c555b23fc1de364835eJack Wang * @param instrumentation the instrumentation to use with this instance 617aba54b2edcb94f43c991c555b23fc1de364835eJack Wang * 627aba54b2edcb94f43c991c555b23fc1de364835eJack Wang * @deprecated Incorrect spelling, 633fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang * use {@link #injectInstrumentation(android.app.Instrumentation)} instead. 647aba54b2edcb94f43c991c555b23fc1de364835eJack Wang */ 657aba54b2edcb94f43c991c555b23fc1de364835eJack Wang @Deprecated 667aba54b2edcb94f43c991c555b23fc1de364835eJack Wang public void injectInsrumentation(Instrumentation instrumentation) { 677aba54b2edcb94f43c991c555b23fc1de364835eJack Wang injectInstrumentation(instrumentation); 687aba54b2edcb94f43c991c555b23fc1de364835eJack Wang } 697aba54b2edcb94f43c991c555b23fc1de364835eJack Wang 707aba54b2edcb94f43c991c555b23fc1de364835eJack Wang /** 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inheritors can access the instrumentation using this. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return instrumentation 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Instrumentation getInstrumentation() { 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mInstrumentation; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility method for launching an activity. 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The {@link Intent} used to launch the Activity is: 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * action = {@link Intent#ACTION_MAIN} 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extras = null, unless a custom bundle is provided here 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * All other fields are null or empty. 85df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * 86df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * <p><b>NOTE:</b> The parameter <i>pkg</i> must refer to the package identifier of the 87df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * package hosting the activity to be launched, which is specified in the AndroidManifest.xml 88df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * file. This is not necessarily the same as the java package name. 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pkg The package hosting the activity to be launched. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param activityCls The activity class to launch. 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param extras Optional extra stuff to pass to the activity. 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The activity, or null if non launched. 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T extends Activity> T launchActivity( 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String pkg, 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class<T> activityCls, 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle extras) { 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent = new Intent(Intent.ACTION_MAIN); 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (extras != null) { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.putExtras(extras); 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return launchActivityWithIntent(pkg, activityCls, intent); 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Utility method for launching an activity with a specific Intent. 108df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * 109df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * <p><b>NOTE:</b> The parameter <i>pkg</i> must refer to the package identifier of the 110df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * package hosting the activity to be launched, which is specified in the AndroidManifest.xml 111df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * file. This is not necessarily the same as the java package name. 112df2a463b01fe5222e377828225ca6710d5c14743Andy Stadler * 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pkg The package hosting the activity to be launched. 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param activityCls The activity class to launch. 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The intent to launch with 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The activity, or null if non launched. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings("unchecked") 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final <T extends Activity> T launchActivityWithIntent( 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String pkg, 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Class<T> activityCls, 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent intent) { 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.setClassName(pkg, activityCls.getName()); 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project T activity = (T) getInstrumentation().startActivitySync(intent); 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getInstrumentation().waitForIdleSync(); 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return activity; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for running portions of a test on the UI thread. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note, in most cases it is simpler to annotate the test method with 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.test.UiThreadTest}, which will run the entire test method on the UI thread. 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Use this method if you need to switch in and out of the UI thread to perform your test. 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r runnable containing test code in the {@link Runnable#run()} method 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void runTestOnUiThread(final Runnable r) throws Throwable { 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Throwable[] exceptions = new Throwable[1]; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getInstrumentation().runOnMainSync(new Runnable() { 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project r.run(); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Throwable throwable) { 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project exceptions[0] = throwable; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }); 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (exceptions[0] != null) { 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw exceptions[0]; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Runs the current unit test. If the unit test is annotated with 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.test.UiThreadTest}, the test is run on the UI thread. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void runTest() throws Throwable { 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String fName = getName(); 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project assertNotNull(fName); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Method method = null; 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // use getMethod to get all public inherited 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // methods. getDeclaredMethods returns all 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // methods of this class but excludes the 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // inherited ones. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project method = getClass().getMethod(fName, (Class[]) null); 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (NoSuchMethodException e) { 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fail("Method \""+fName+"\" not found"); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!Modifier.isPublic(method.getModifiers())) { 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project fail("Method \""+fName+"\" should be public"); 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int runCount = 1; 1793fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang boolean isRepetitive = false; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (method.isAnnotationPresent(FlakyTest.class)) { 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project runCount = method.getAnnotation(FlakyTest.class).tolerance(); 1823fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang } else if (method.isAnnotationPresent(RepetitiveTest.class)) { 1833fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang runCount = method.getAnnotation(RepetitiveTest.class).numIterations(); 1843fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang isRepetitive = true; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (method.isAnnotationPresent(UiThreadTest.class)) { 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int tolerance = runCount; 1893fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang final boolean repetitive = isRepetitive; 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Method testMethod = method; 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Throwable[] exceptions = new Throwable[1]; 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getInstrumentation().runOnMainSync(new Runnable() { 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1953fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang runMethod(testMethod, tolerance, repetitive); 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (Throwable throwable) { 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project exceptions[0] = throwable; 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }); 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (exceptions[0] != null) { 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw exceptions[0]; 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2053fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang runMethod(method, runCount, isRepetitive); 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2093fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang // For backwards-compatibility after adding isRepetitive 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void runMethod(Method runMethod, int tolerance) throws Throwable { 2113fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang runMethod(runMethod, tolerance, false); 2123fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang } 2133fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang 2143fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang private void runMethod(Method runMethod, int tolerance, boolean isRepetitive) throws Throwable { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Throwable exception = null; 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int runCount = 0; 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project do { 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project runMethod.invoke(this, (Object[]) null); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project exception = null; 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InvocationTargetException e) { 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project e.fillInStackTrace(); 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project exception = e.getTargetException(); 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IllegalAccessException e) { 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project e.fillInStackTrace(); 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project exception = e; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project runCount++; 2303fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang // Report current iteration number, if test is repetitive 2313fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang if (isRepetitive) { 2323fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang Bundle iterations = new Bundle(); 2333fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang iterations.putInt("currentiterations", runCount); 2343fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang getInstrumentation().sendStatus(2, iterations); 2353fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang } 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2373fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang } while ((runCount < tolerance) && (isRepetitive || exception != null)); 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (exception != null) { 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw exception; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends a series of key events through instrumentation and waits for idle. The sequence 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of keys is a string containing the key names as specified in KeyEvent, without the 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * KEYCODE_ prefix. For instance: sendKeys("DPAD_LEFT A B C DPAD_CENTER"). Each key can 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be repeated by using the N* prefix. For instance, to send two KEYCODE_DPAD_LEFT, use 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the following: sendKeys("2*DPAD_LEFT"). 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param keysSequence The sequence of keys. 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void sendKeys(String keysSequence) { 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final String[] keys = keysSequence.split(" "); 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int count = keys.length; 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Instrumentation instrumentation = getInstrumentation(); 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < count; i++) { 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String key = keys[i]; 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int repeater = key.indexOf('*'); 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int keyCount; 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project keyCount = repeater == -1 ? 1 : Integer.parseInt(key.substring(0, repeater)); 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (NumberFormatException e) { 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.w("ActivityTestCase", "Invalid repeat count: " + key); 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project continue; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (repeater != -1) { 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project key = key.substring(repeater + 1); 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int j = 0; j < keyCount; j++) { 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Field keyCodeField = KeyEvent.class.getField("KEYCODE_" + key); 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int keyCode = keyCodeField.getInt(null); 279d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn try { 280d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn instrumentation.sendKeyDownUpSync(keyCode); 281d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn } catch (SecurityException e) { 282d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // Ignore security exceptions that are now thrown 283d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // when trying to send to another app, to retain 284d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // compatibility with existing tests. 285d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn } 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (NoSuchFieldException e) { 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.w("ActivityTestCase", "Unknown keycode: KEYCODE_" + key); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (IllegalAccessException e) { 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.w("ActivityTestCase", "Unknown keycode: KEYCODE_" + key); 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project instrumentation.waitForIdleSync(); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends a series of key events through instrumentation and waits for idle. For instance: 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sendKeys(KEYCODE_DPAD_LEFT, KEYCODE_DPAD_CENTER). 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param keys The series of key codes to send through instrumentation. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void sendKeys(int... keys) { 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int count = keys.length; 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Instrumentation instrumentation = getInstrumentation(); 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < count; i++) { 310d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn try { 311d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn instrumentation.sendKeyDownUpSync(keys[i]); 312d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn } catch (SecurityException e) { 313d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // Ignore security exceptions that are now thrown 314d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // when trying to send to another app, to retain 315d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // compatibility with existing tests. 316d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project instrumentation.waitForIdleSync(); 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends a series of key events through instrumentation and waits for idle. Each key code 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be preceded by the number of times the key code must be sent. For instance: 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sendRepeatedKeys(1, KEYCODE_DPAD_CENTER, 2, KEYCODE_DPAD_LEFT). 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param keys The series of key repeats and codes to send through instrumentation. 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void sendRepeatedKeys(int... keys) { 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int count = keys.length; 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((count & 0x1) == 0x1) { 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("The size of the keys array must " 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + "be a multiple of 2"); 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final Instrumentation instrumentation = getInstrumentation(); 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int i = 0; i < count; i += 2) { 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int keyCount = keys[i]; 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int keyCode = keys[i + 1]; 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (int j = 0; j < keyCount; j++) { 342d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn try { 343d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn instrumentation.sendKeyDownUpSync(keyCode); 344d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn } catch (SecurityException e) { 345d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // Ignore security exceptions that are now thrown 346d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // when trying to send to another app, to retain 347d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn // compatibility with existing tests. 348d7ed9175aa269db8977ef05b095cfc2fabcc9c7aDianne Hackborn } 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project instrumentation.waitForIdleSync(); 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Make sure all resources are cleaned up and garbage collected before moving on to the next 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test. Subclasses that override this method should make sure they call super.tearDown() 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * at the end of the overriding method. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws Exception 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 362192ab903887bbb8e7c7b6da5c581573850e30f46Gilles Debunne @Override 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void tearDown() throws Exception { 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Runtime.getRuntime().gc(); 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Runtime.getRuntime().runFinalization(); 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Runtime.getRuntime().gc(); 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.tearDown(); 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3693fc03e619fb01678549b80e7a89af2c8e3f19968Jack Wang}