1 /*
2  * Copyright (C) 2021 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 com.android.bedstead.harrier.annotations;
18 
19 import com.android.bedstead.harrier.DeviceState;
20 
21 import java.lang.annotation.ElementType;
22 import java.lang.annotation.Retention;
23 import java.lang.annotation.RetentionPolicy;
24 import java.lang.annotation.Target;
25 
26 /**
27  * Mark that a test method should be run using GMS Instrumentation for certain versions.
28  *
29  * <p>This will apply {@link RequireSdkVersion} to ensure that on the given versions, this test
30  * only runs when the instrumented package is `com.google.android.gms`. It will also skip the test
31  * if it is run with gms instrumentation on a version which does not require it.
32  *
33  * <p>This allows for two test configurations to be set up, one which instruments GMS and one
34  * which does not - and both pointed at the same test sources.
35  *
36  * <p>Your test configuration may be configured so that this test is only run on a device with the
37  * given state. Otherwise, you can use {@link DeviceState} to ensure that the test is
38  * not run when the sdk version is not correct.
39  */
40 @Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE, ElementType.TYPE})
41 @Retention(RetentionPolicy.RUNTIME)
42 public @interface RequireGmsInstrumentation {
min()43     int min() default 1;
max()44     int max() default Integer.MAX_VALUE;
45 }
46