1 /*
2  * Copyright 2021 Google LLC
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  *   https://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 package com.google.android.enterprise.connectedapps.annotations;
17 
18 import java.lang.annotation.ElementType;
19 import java.lang.annotation.Retention;
20 import java.lang.annotation.RetentionPolicy;
21 import java.lang.annotation.Target;
22 
23 /**
24  * Specify configuration for cross-user calls.
25  *
26  * <p>Typically you should have only one {@link CrossUserConfiguration} annotated class in your
27  * build.
28  */
29 @Target(ElementType.TYPE)
30 @Retention(RetentionPolicy.CLASS)
31 public @interface CrossUserConfiguration {
32 
33   /** provider classes that should be accessible */
providers()34   Class<?>[] providers() default {};
35 
36   /**
37    * A {@code android.app.Service} subclass which should be used as the superclass of the generated
38    * service. By default this is {@code android.app.Service}.
39    */
serviceSuperclass()40   Class<?> serviceSuperclass() default CrossProfileConfiguration.class;
41   // android.app.Service isn't available to the annotations library, so we default to
42   // CrossProfileConfiguration and swap it to android.app.Service when compiling
43 
44   /**
45    * A {@code android.app.Service} subclass which should be used instead of the generated service.
46    *
47    * <p>If not specified, a service will be generated.
48    *
49    * <p>The class name must match the {@link CustomProfileConnector#serviceClassName()}.
50    */
serviceClass()51   Class<?> serviceClass() default CrossProfileConfiguration.class;
52 
53   /**
54    * The {@link CustomProfileConnector} used by this configuration.
55    *
56    * <p>Defaults to {@code com.google.android.enterprise.connectedapps.CrossProfileConnector}.
57    */
connector()58   Class<?> connector() default CrossProfileConfiguration.class;
59   // com.google.android.enterprise.connectedapps.CrossProfileConnector isn't available to the
60   // annotations library, so we default to CrossProfileConfiguration and swap it out when compiling.
61 }
62