ATOMac - 基于Python的Mac应用Ui自动化库

时间：2022-09-15 04:05:14

ATOMacTest

一、缘 起

近期工作需要对一款Mac端应用实现常用功能的自动化操作，同事推荐ATOMac这款工具，这几天简单研究了下，同时也发现现网介绍ATOMac的资料非常有限，故在此记录下ATOMac的一些简单用法，仅供学习参考~

二、概 述

如标题，ATOMac是一个基于Python语言，通过Apple Accessibility API实现的Mac端应用Ui自动化控制库，下面是官方的说明：

We are pleased to introduce the first Python library to fully enable GUI testing of Mac applications via the Apple Accessibility API. This library was created out of desperation. Existing tools such as using appscript to send messages to accessibility objects are painful to write and slow to use. ATOMac has direct access to the API. It's fast and easy to use to write tests.

三、使 用

3.1 安装

  1. 由于该库pip包已经很久没更新了，直接pip安装可能会报错，Python2建议使用easy_install安装
  2. 目前atomac 1.1.0不支持Python3，但是@daveenguyen这位大神已经在源码库做了Python3的兼容，所以需要直接从git仓库安装，详细如下：
# Python2

sudo easy_install atomac

# Python3

pip3 install git+https://github.com/pyatom/pyatom/

3.2 常用功能

基础的用法在官网有说明，这里就不再赘述，以下将以地图为例，实现一些常用功能

3.2.1 需要用到

  1. 应用的bundle_id：打开应用内容 -> info.plist
  2. Accessibility Inspector：Xcode -> Open Developer Tools

ATOMac - 基于Python的Mac应用Ui自动化库

3.2.1 代码实现

import atomac

from time import sleep

from atomac.AXKeyCodeConstants import *

bundle_id = 'com.apple.Maps'

# bs = atomac.AXClasses.AXKeyCodeConstants.BACKSPACE

# part 1, 启动应用并获取应用信息

atomac.launchAppByBundleId(bundle_id)

sleep(2)

ato = atomac.getAppRefByBundleId(bundle_id)

print(ato)

# part 2, 获取当前应用windows

cur_win = ato.windows()[0]

print(cur_win)

# part 3, 查找元素

# findFirst，返回第一个匹配的元素

# findFirstR，递归查找，返回第一个匹配的元素（当查找的元素Parent非标准窗口时使用）

# 在AXClasses.py文件中可以找到很多已经定义好的方法

# dt = cur_win.radioButtonsR('地图')[0]   # 也可以

dt = cur_win.findFirstR(AXRole='AXRadioButton', AXTitle='地图')

gj = cur_win.findFirstR(AXRole='AXRadioButton', AXTitle='公交')

wx = cur_win.findFirstR(AXRole='AXRadioButton', AXTitle='卫星')

# part 4, 元素属性所有

attr = dt.getAttributes()

# 元素某一个属性

dt_title = dt.AXTitle

print(attr, dt_title)

# part 5, 点击/切到公交

# Method 1，唯一定位元素后，使用Press方法

print(gj)

gj.Press()

# Method 2，定位元素坐标并鼠标点击

# 注意AXPositon得到的坐标是元素左上角的坐标，需要根据实际大小得到元素中心点坐标

dt_position = dt.AXPosition

dt_size = dt.AXSize

coord = (dt_position[0] + dt_size[0] / 2, dt_position[1] + dt_size[1])

print(coord)

dt.clickMouseButtonLeft(dt_position)

# part 6, 输入内容（输入键盘字符，US_keyboard）

s1 = cur_win.findFirstR(AXRole='AXTextField', AXRoleDescription='搜索文本栏')

# s1 == s2

# s2 = cur_win.textFieldsR('搜索文本栏')[0]

s1_p = s1.AXPosition

s1_s = s1.AXSize

s1.tripleClickMouse((s1_p[0] + s1_s[0] / 2, s1_p[1] + s1_s[1] / 2))

s1.sendKeys('7983')

# part 7, 输入键盘上的修饰符

sleep(1)

s1.sendKeys([BACKSPACE])

# 回车

s1.sendKeys([RETURN])

3.2.4 元素属性对应说明

  1. ATOMac库使用的元素属性均在其属性名（通过Accessibility Inspector查到）前面加AX，且首字母大写，如下所示
ATOMac Accessibility Inspector
AXSize Size
AXRole Role
AXPosition Position
AXRoleDescription Type
AXValue Value
... ...
  1. 比较特殊的是：AXRoleDescription - Type

参考

https://github.com/pyatom/pyatom

https://zhuanlan.zhihu.com/p/30385931

http://python-atomac.blogspot.com/p/atomac-usage.html

https://blog.csdn.net/sinat_40766770/article/details/91048760

OK！

~

~

~

不积跬步，无以至千里

相关文章