1 /*
2  * Copyright (c) 2021 Huawei Device Co., Ltd.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at
6  *
7  *     http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 
16 #ifndef OHOS_ABILITY_RUNTIME_IABILITY_CONTROLLER_H
17 #define OHOS_ABILITY_RUNTIME_IABILITY_CONTROLLER_H
18 
19 #include "iremote_broker.h"
20 #include "iremote_object.h"
21 #include "want.h"
22 
23 namespace OHOS {
24 namespace AppExecFwk {
25 using OHOS::AAFwk::Want;
26 /**
27  * @brief Testing interface to monitor what is happening in ability manager while tests are running.
28  */
29 class IAbilityController : public IRemoteBroker {
30 public:
31     DECLARE_INTERFACE_DESCRIPTOR(u"ohos.appexecfwk.IAbilityController");
32 
33     /**
34      * The system is trying to start an ability.
35      *
36      * @param want The want of ability to start.
37      * @param bundleName The bundleName of ability to start.
38      * @return Return true to allow ability to start, or false to reject.
39      */
40     virtual bool AllowAbilityStart(const Want &want, const std::string &bundleName) = 0;
41 
42     /**
43      * The system is scheduling Ability to background.
44      *
45      * @param bundleName The bundleName of ability to return.
46      * @return Return true to allow ability to background, or false to reject.
47      */
48     virtual bool AllowAbilityBackground(const std::string &bundleName) = 0;
49 
50     enum class Message {
51         TRANSACT_ON_ALLOW_ABILITY_START = 0,
52         TRANSACT_ON_ALLOW_ABILITY_BACKGROUND,
53     };
54 };
55 }  // namespace AppExecFwk
56 }  // namespace OHOS
57 #endif  // OHOS_ABILITY_RUNTIME_IABILITY_CONTROLLER_H
58