1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package android.test; 18 19 import java.lang.annotation.Retention; 20 import java.lang.annotation.RetentionPolicy; 21 import java.lang.annotation.Target; 22 import java.lang.annotation.ElementType; 23 24 /** 25 * This annotation can be used on an {@link android.test.InstrumentationTestCase}'s 26 * test methods. When the annotation is present, the test method is re-executed if 27 * the test fails. The total number of executions is specified by the tolerance and 28 * defaults to 1. 29 * 30 * @deprecated Use 31 * <a href="{@docRoot}reference/android/support/test/filters/FlakyTest.html"> 32 * FlakyTest</a> instead. New tests should be written using the 33 * <a href="{@docRoot}tools/testing-support-library/index.html">Android Testing Support Library</a>. 34 */ 35 @Deprecated 36 @Target(ElementType.METHOD) 37 @Retention(RetentionPolicy.RUNTIME) 38 public @interface FlakyTest { 39 /** 40 * Indicates how many times a test can run and fail before being reported 41 * as a failed test. If the tolerance factor is less than 1, the test runs 42 * only once. 43 * 44 * @return The total number of allowed run, the default is 1. 45 */ tolerance()46 int tolerance() default 1; 47 } 48