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  * Annotate an interface as being used for asynchronous cross-profile callbacks.
25  *
26  * <p>Interfaces annotated with this must have a single method which returns void, and must only
27  * take a single parameter of a type supported by the Connected Apps SDK.
28  */
29 @Target(ElementType.TYPE)
30 @Retention(RetentionPolicy.CLASS)
31 public @interface CrossProfileCallback {
32 
33   /**
34    * If the callback should be enforced to be "simple".
35    *
36    * <p>Simple callbacks have a single method which accepts 0 or 1 arguments.
37    *
38    * <p>Simple callbacks can be used with calls to multiple profiles and with
39    * {@code .isAvailable()}, whereas non-simple callbacks can not.
40    */
simple()41   boolean simple() default false;
42 }
43