ha4t.drivers.harmony module

HarmonyDriver: 基于 hmdriver2 的鸿蒙平台驱动。

class HarmonyDriver

基类：BaseDriver

connect(serial: str | None = None, **kwargs) → str

连接设备，返回实际使用的序列号。 :raises DeviceConnectionError: 连接失败

get_device_info() → dict

返回设备基本信息字典（productName/model/serial 等）。

screen_size() → Tuple[int, int]

返回屏幕分辨率 (width, height)。

screenshot() → <MagicMock name='mock.Image.Image' id='140544906063568'>

hmdriver2 截图保存为临时文件，再读取为 PIL.Image 返回。

tap(x: int, y: int, duration: float = 0.1) → None

单击坐标点，duration 为按压时长（秒）。

swipe(x1: int, y1: int, x2: int, y2: int, duration: float | None = None, steps: int | None = None) → None

从 (x1,y1) 滑动到 (x2,y2)。

press(key: str) → None

模拟系统按键，如 home / back / menu。

find(**kwargs)

根据 u2/wda/hmdriver2 属性定位元素，返回平台原生元素对象。 上层通过此方法拿到元素后自行调用 .click() / .exists 等。

find_xpath(xpath: str)

通过 xpath 定位元素，返回平台原生元素对象。

get_element_center(**kwargs)

app_start(app_name: str, activity: str | None = None) → None

启动应用。

app_stop(app_name: str) → None

停止应用。

app_current() → str

返回当前前台应用的包名/bundleId。