背景

Aki 是一个基于 Accessibility Api 实现的跨平台 (Mac/Windows）桌面端自动化测试框架，借助开源框架 JNA 实现了对系统底层 Api 的访问。

Maven 依赖

<dependency>
    <groupId>io.github.letmeno1</groupId>
    <artifactId>aki</artifactId>
    <version>1.0.3</version>
</dependency>

生成 Jar 包

mvn install

入门

需要 jdk version >= 1.8.0_295

对于 Mac

需要安装 Xcode
需要系统版本高于 10.6

需要在在隐私权限中开启 Xcode 对辅助设备访问的权限。系统偏好设置 > 安全性与隐私 > 通用访问 > 启用辅助设备访问。

对于 Windows

需要版本高于 Windows 7

元素定位工具

对于 Mac

Accessibility Inspector：Xcode -> 打开 Developer Tools

使用 “Accessibility Inspector” 可以查找到 App 对应的元素属性

对于 Windows

在主页里下载 inspect.exe

使用 “inspect.exe” 可以查找到 App 对应的元素属性

使用

启动应用程序并通过 identifier（Mac）或文件执行路径（Windows）初始化一个 UIElementRef 对象

对于 Mac： UIElementRef app = Operation.initializeAppRefForMac("com.apple.calculator");

对于 Windows： UIElementRef app = Operation.initializeAppRefForWin("C:\\WINDOWS\\System32\\calc.exe");

App 窗口本身就是一个 UIElementRef 对象，而每个元素也都是一个 UIElementRef 对象。你可以通过 UIElementRef 来调用各种查找或者是点击的方法

鼠标事件

UIElementRef 对象支持单击、双击、长按、悬停

例如: app.findElementsByText("Input phone number",0).click() 或 app.findElementsByText("Input phone number",0).doubleClick()

输入事件

UIElementRef 对象支持输入和清除

例如: app.findElementsByText("Input phone number",0).type("188888") 或 app.findElementsByText("Input phone number",0).clear()

查找元素

对于 Mac：

支持文本、role（元素类型）、identifier、xpath。

对于文本和 role，搜索到的元素会以列表的形式返回，调用时需要加入索引。

例如 app.findElementsByText("Input phone number",0) 和 app.findElementsByRole("AXTextField",2)

1.通过文本

文本对应元素属性中的 “Title”、“Value” 和 “Help”

2.通过 Role

Role 对应元素属性中的 “Role”

3.通过 Xpath

这是一种通过元素的路径查找的方法 (待改进)

例如 app.findElementByXpath("AXStandardWindow/AXButton[1]")

4.通过 identifier

identifier 对应元素属性中的 “identifier”

例如 app.findElementByIdentifier("JoinButton")

对于 Windows：

支持 text(name)、role、automationId、fullDescription。

对于 text、role 和 fullDescription，搜索到的元素会以列表的形式返回，调用时需要加入索引。

例如app.findElementsByText("Input phone number",0) 和 app.findElementsByRole("AXTextField",2)

1.通过文本

文本对应于元素属性中的 “Name”

2.通过 Role

Role 对应于元素属性中的 “Role”

例如 `app.findElementsByRole(app.findElementsByText("client",0))

4.通过 automationId

automationId 对应于元素属性中的"automationId"

例如 app.findElementByAutomationId ("num3button")

通用操作

支持鼠标事件、组合键盘事件、截图和结束进程