/* * Copyright (c) 2021-2022 Huawei Device Co., Ltd. * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef UI_DRIVER_H #define UI_DRIVER_H #include "ui_controller.h" #include "ui_model.h" #include "widget_selector.h" namespace OHOS::uitest { class UiDriver : public BackendClass { public: UiDriver() {} ~UiDriver() override {} /**Find widgets with the given selector. Results are arranged in the receiver in DFS order. * @returns the widget object. **/ void FindWidgets(const WidgetSelector &select, std::vector> &rev, ApiCallErr &err, bool updateUi = true); /**Wait for the matching widget appear in the given timeout.*/ std::unique_ptr WaitForWidget(const WidgetSelector &select, const UiOpArgs &opt, ApiCallErr &err); /**Find window matching the given matcher.*/ std::unique_ptr FindWindow(std::function matcher, ApiCallErr &err); /**Retrieve widget from updated UI.*/ const Widget *RetrieveWidget(const Widget &widget, ApiCallErr &err, bool updateUi = true); /**Retrieve window from updated UI.*/ const Window *RetrieveWindow(const Window &window, ApiCallErr &err); string GetHostApp(const Widget &widget); /**Trigger the given key action. */ void TriggerKey(const KeyAction &key, const UiOpArgs &opt, ApiCallErr &error); /**Perform the given touch action.*/ void PerformTouch(const TouchAction &touch, const UiOpArgs &opt, ApiCallErr &err); /**Delay current thread for given duration.*/ static void DelayMs(uint32_t ms); /**Take screen capture, save to given file path as PNG.*/ void TakeScreenCap(int32_t fd, ApiCallErr &err, Rect rect); void DumpUiHierarchy(nlohmann::json &out, bool listWindows, ApiCallErr &error); const FrontEndClassDef &GetFrontendClassDef() const override { return DRIVER_DEF; } void SetDisplayRotation(DisplayRotation rotation, ApiCallErr &error); DisplayRotation GetDisplayRotation(ApiCallErr &error); void SetDisplayRotationEnabled(bool enabled, ApiCallErr &error); bool WaitForUiSteady(uint32_t idleThresholdMs, uint32_t timeoutSec, ApiCallErr &error); void WakeUpDisplay(ApiCallErr &error); Point GetDisplaySize(ApiCallErr &error); Point GetDisplayDensity(ApiCallErr &error); bool GetCharKeyCode(char ch, int32_t &code, int32_t &ctrlCode, ApiCallErr &error); void DfsTraverseTree(WidgetVisitor &visitor, const Widget *widget = nullptr); void InjectMouseAction(MouseOpArgs mouseOpArgs, ApiCallErr &error); static void RegisterController(std::unique_ptr controller); bool CheckStatus(bool isConnected, ApiCallErr &error); static void RegisterUiEventListener(std::shared_ptr listener); void GetLayoutJson(nlohmann::json &dom); private: /**Update UI controller and UI objects.*/ void UpdateUi(bool updateUiTree, ApiCallErr &error, bool getWidgetNodes, string targetWin = ""); // UI objects that are needed to be updated before each interaction and used in the interaction static std::unique_ptr uiController_; std::unique_ptr widgetTree_ = nullptr; std::vector windows_; }; } // namespace OHOS::uitest #endif