1 /* 2 * Copyright (c) 2024 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_MISSION_LIST_MANAGER_INTERFACE_H 17 #define OHOS_ABILITY_RUNTIME_MISSION_LIST_MANAGER_INTERFACE_H 18 19 #include <memory> 20 #include <string> 21 #include <vector> 22 23 #include "ability_running_info.h" 24 #include "mission_list.h" 25 #include "mission_listener_controller.h" 26 #include "mission_info.h" 27 #include "mission_snapshot.h" 28 #include "snapshot.h" 29 #include "start_options.h" 30 #include "want.h" 31 #include "iability_info_callback.h" 32 33 namespace OHOS { 34 namespace AAFwk { 35 class MissionListManagerInterface { 36 public: 37 virtual ~MissionListManagerInterface() = default; 38 39 virtual void Init() = 0; 40 virtual int StartAbility(AbilityRequest &abilityRequest) = 0; 41 virtual int MinimizeAbility(const sptr<IRemoteObject> &token, bool fromUser) = 0; 42 virtual int RegisterMissionListener(const sptr<IMissionListener> &listener) = 0; 43 virtual int UnRegisterMissionListener(const sptr<IMissionListener> &listener) = 0; 44 virtual int GetMissionInfos(int32_t numMax, std::vector<MissionInfo> &missionInfos) = 0; 45 virtual int GetMissionInfo(int32_t missionId, MissionInfo &missionInfo) = 0; 46 virtual int MoveMissionToFront(int32_t missionId, std::shared_ptr<StartOptions> startOptions = nullptr) = 0; 47 virtual int MoveMissionToFront(int32_t missionId, bool isCallerFromLauncher, bool isRecent, 48 std::shared_ptr<AbilityRecord> callerAbility, std::shared_ptr<StartOptions> startOptions = nullptr) = 0; 49 virtual void NotifyMissionFocused(int32_t missionId) = 0; 50 virtual void NotifyMissionUnfocused(int32_t missionId) = 0; 51 virtual void OnAbilityRequestDone(const sptr<IRemoteObject> &token, int32_t state) = 0; 52 virtual void OnAppStateChanged(const AppInfo &info) = 0; 53 virtual int AttachAbilityThread(const sptr<AAFwk::IAbilityScheduler> &scheduler, 54 const sptr<IRemoteObject> &token) = 0; 55 virtual std::shared_ptr<AbilityRecord> GetAbilityRecordByToken(const sptr<IRemoteObject> &token) = 0; 56 virtual std::shared_ptr<AbilityRecord> GetAbilityRecordByMissionId(int missionId) = 0; 57 virtual int MoveAbilityToBackground(const std::shared_ptr<AbilityRecord> &abilityRecord) = 0; 58 virtual int32_t BackToCallerAbilityWithResult(std::shared_ptr<AbilityRecord> abilityRecord, 59 int32_t resultCode, const Want *resultWant, int64_t callerRequestCode) = 0; 60 virtual int TerminateAbility(const std::shared_ptr<AbilityRecord> &abilityRecord, 61 int resultCode, const Want *resultWant, bool flag) = 0; 62 virtual int AbilityTransactionDone(const sptr<IRemoteObject> &token, int state, const PacMap &saveData) = 0; 63 virtual std::shared_ptr<AbilityRecord> GetAbilityFromTerminateList(const sptr<IRemoteObject> &token) = 0; 64 virtual int ClearMission(int missionId) = 0; 65 virtual int ClearAllMissions() = 0; 66 67 virtual int SetMissionLockedState(int missionId, bool lockedState) = 0; 68 virtual void OnTimeOut(uint32_t msgId, int64_t abilityRecordId, bool isHalf = false) = 0; 69 virtual void OnAbilityDied(std::shared_ptr<AbilityRecord> abilityRecord, int32_t currentUserId) = 0; 70 virtual void OnCallConnectDied(const std::shared_ptr<CallRecord> &callRecord) = 0; 71 virtual int32_t GetMissionIdByAbilityToken(const sptr<IRemoteObject> &token) = 0; 72 virtual sptr<IRemoteObject> GetAbilityTokenByMissionId(int32_t missionId) = 0; 73 74 virtual void Dump(std::vector<std::string> &info) = 0; 75 76 virtual void DumpMissionList(std::vector<std::string> &info, bool isClient, const std::string &args = ""); 77 78 virtual void DumpMissionListByRecordId(std::vector<std::string> &info, bool isClient, int32_t abilityRecordId, 79 const std::vector<std::string> ¶ms) = 0; 80 virtual void DumpMission(int missionId, std::vector<std::string> &info) = 0; 81 virtual void DumpMissionInfos(std::vector<std::string> &info) = 0; 82 virtual void OnAcceptWantResponse(const AAFwk::Want &want, const std::string &flag) = 0; 83 virtual void OnStartSpecifiedAbilityTimeoutResponse(const AAFwk::Want &want) = 0; 84 virtual int ResolveLocked(const AbilityRequest &abilityRequest) = 0; 85 86 virtual int ReleaseCallLocked(const sptr<IAbilityConnection> &connect, 87 const AppExecFwk::ElementName &element) = 0; 88 virtual void RegisterSnapshotHandler(const sptr<ISnapshotHandler> &handler) = 0; 89 virtual bool GetMissionSnapshot(int32_t missionId, const sptr<IRemoteObject> &abilityToken, 90 MissionSnapshot &missionSnapshot, bool isLowResolution) = 0; 91 virtual void GetAbilityRunningInfos(std::vector<AbilityRunningInfo> &info, bool isPerm) = 0; 92 93 #ifdef SUPPORT_SCREEN 94 virtual void UpdateSnapShot(const sptr<IRemoteObject> &token, 95 const std::shared_ptr<Media::PixelMap> &pixelMap) = 0; 96 #endif // SUPPORT_SCREEN 97 98 virtual void EnableRecoverAbility(int32_t missionId) = 0; 99 100 virtual void UninstallApp(const std::string &bundleName, int32_t uid) = 0; 101 102 virtual bool IsStarted() = 0; 103 virtual void PauseManager() = 0; 104 virtual void ResumeManager() = 0; 105 virtual int32_t IsValidMissionIds(const std::vector<int32_t> &missionIds, 106 std::vector<MissionValidResult> &results) = 0; 107 virtual int DoAbilityForeground(std::shared_ptr<AbilityRecord> &abilityRecord, uint32_t flag); 108 virtual void GetActiveAbilityList(int32_t uid, std::vector<std::string> &abilityList, int32_t pid = NO_PID) = 0; 109 virtual void CallRequestDone(const std::shared_ptr<AbilityRecord> &abilityRecord, 110 const sptr<IRemoteObject> &callStub) = 0; 111 virtual int SetMissionContinueState(const sptr<IRemoteObject> &token, int32_t missionId, 112 const AAFwk::ContinueState &state) = 0; 113 114 virtual bool IsAbilityStarted(AbilityRequest &abilityRequest, std::shared_ptr<AbilityRecord> &targetRecord) = 0; 115 virtual void SignRestartAppFlag(int32_t uid) = 0; 116 #ifdef SUPPORT_SCREEN 117 public: 118 virtual int SetMissionLabel(const sptr<IRemoteObject> &abilityToken, const std::string &label) = 0; 119 virtual int SetMissionIcon(const sptr<IRemoteObject> &token, const std::shared_ptr<Media::PixelMap> &icon) = 0; 120 virtual void CompleteFirstFrameDrawing(const sptr<IRemoteObject> &abilityToken) = 0; 121 #endif 122 }; 123 124 class MissionListWrap { 125 public: 126 virtual ~MissionListWrap() = default; 127 virtual std::shared_ptr<MissionListManagerInterface> CreateMissionListManager(int32_t userId) = 0; 128 virtual void RemoveUserDir(int32_t userId) = 0; 129 virtual void InitMissionInfoMgr(int32_t userId) = 0; 130 virtual void SetMissionAbilityState(int32_t missionId, AbilityState state) = 0; 131 virtual int32_t GetInnerMissionInfoById(int32_t missionId, InnerMissionInfo &innerMissionInfo) = 0; 132 #ifdef SUPPORT_SCREEN 133 virtual std::shared_ptr<Media::PixelMap> GetSnapshot(int32_t missionId) = 0; 134 #endif 135 }; 136 } // namespace AAFwk 137 } // namespace OHOS 138 139 extern "C" __attribute__((visibility("default"))) OHOS::AAFwk::MissionListWrap* CreateMissionListWrap(); 140 141 #endif // OHOS_ABILITY_RUNTIME_MISSION_LIST_MANAGER_INTERFACE_H 142