安装 adb
使用以下命令安装 atx 最新版
pip install --pre -U uiautomator2
手机接到电脑上之后,需要先运行一下命令:
python -m uiautomator2 init 将需要的程序部署到手机上(一次即可)
ATX Weditor 是一个 python 库,命令行安装
pip install --pre weditor , 命令行启动 python -m weditor(PS: windows 可以双击 weditor 快捷方式),会自动打开一个网页,用网页作为其 Inspector
appium 需要构造一个 desiredCapabilities,其中的 udid 字段通常对应设备的序列号。
以一个常见的配置文件为例
desired_caps = {
# 平台 android
'platformName': 'Android',
# 手机设备名称
'deviceName': '2d869e6',
# android 系统的版本号
'platformVersion': '9',
# 安装包路径
# 'app': 'F:\download\XXX.apk',
# apk 包名
'appPackage': 'com.tencent.mm',
# apk 的 launcherActivity
'appActivity': '.ui.LauncherUI',
# 默认 neReset 为 false,不要在会话前重置应用状态,每次启动都跟第一次启动一样,变为 true 则不一样
# 会话前不重置应用状态 默认是 false
'noReset': True,
# 'appWaitActivity':'com.tencent.mm.plugin.webview.ui.tools.WebViewUI',
# 下面两行代码是为了屏蔽软件盘以至于可以输入中文
'unicodeKeyboard': True, # 使用 unicode 编码方式发送字符串
# 'resetKeyboard': False, # 将键盘隐藏起来
# 在 Android 上,这也会在会话结束后自动清除被测应用
"fullReset": False,
'chromeOptions': {'androidProcess': 'com.tencent.mm.plugin.webview.ui.tools.WebViewUI'}
# "automationName": "uiautomator2"
# newCommandTimeout 设置为更大的值
# "newCommandTimeout":240
}
atx 是没有这类配置文件,必需的字段只有一个就是设备的序列号,这里用 ip 地址也可以。其他的都是可选的。对于是否启动应用给用户提供了的选择权。
atx 代码为:
import uiautomator2 as u2
d = u2.connect("dgsdg")
d.set_fastinput_ime(True)
s = d.session("com.netease.cloudmusic")
感觉方便多了,fastinput_ime 是专门为自动化定制的输入法,支持中文的输入,和一些特殊的指令如搜索,清空。
d.session 函数对应于 appium 的 session 机制,每次运行相关代码的时候都会先检测一下应用是否存活。
注:atx 连接的时候可以填手机的序列号或者 ip 地址。因为测试代码最终是与手机上的一个服务的 atx-agent 通信,所以也支持填写 IP,但是需要运行代码的电脑跟手机在同一个网段。
appium 常用定位元素的方法为 find_element_by_xpath, find_element_by_id, find_element_by_text
一种常见的写法为
driver.implicitly_wait(10) # 设置元素的查找时间 10s
element = driver.find_element_by_text("Settings")
if element:
element.click()
转化成 atx 代码为
d(text="Settings").click(timeout=10)
atx 不推荐用 xpath,因为要 dump 所有的 hierarchy,速度比较慢。推荐用的时候各种查询条件混合一起使用。
典型的用法为
d(className="android.widget.Button", textContains="登录").click()
# using xpath
d.xpath('//android.widget.Button[contains(@text, "登录")]').click()
现在高版本的手机基本都会有一些权限确认窗口或者安装确认框。如果处理不好会非常影响自动化。
看到一个帖子说是可以配置一下就可以解决弹框了(PS:应该是只针对 iOS 的)https://testerhome.com/topics/14513
driver.switch_to.alert.accept()
atx 的方法更自由一点,你可以自由选择处理什么内容的弹窗,以及怎么处理。一个常见的自动点击安装按钮的方法
d.watcher("INSTALL").when(text="安装").click()
d.watcher("NEXT").when(text="下一步").click()
d.watchers.watched = True
官方文档:https://github.com/openatx/uiautomator2
参考资料:https://testerhome.com/topics/14880