Appium Desktop 是一款用于 Mac、Windows 和 Linux 的开源应用,它提供了 Appium Server,Appium Inspector 以及相关的工具的组合。
Appium Desktop 是个图形界面,可以设置选项、启动/停止服务器、查看日志等功能。Appium Inspector 可以查看应用程序的元素,并进行基本的交互、录制等功能。
下载地址:
https://github.com/appium/appium-desktop/releases
下载对应系统的 Appium 版本,安装完成之后,点击 “Start Server”,就启动了 Appium Server。
在启动成功页面点击右上角的放大镜,进入到创建 Session 页面。配置好 desirecapability 信息之后,点击“Start Session”启动会话就展示出下面的页面。Appium Inspector 元素定位页面:
左侧为屏幕快照:可以在左侧使用鼠标选择 UI 元素,会看到它们高亮显示。
中间为页面 DOM 树结构:在应用层次结构中会直接将元素的属性值标记在树上,这对于 Appium 定位元素很方便
右侧为元素的详细信息:当元素被选中,右侧会展示出元素的详细属性信息列表。这些属性将决定 Appium 定位元素的策略。
另外 Appium Inspector 还提供了页面刷新,页面操作,录制,元素的点击、输入等功能。
Appium Inspect 提供了定位元素与录制用例的功能,使用 Appium Inspect 可以查看移动设备的 UI 布局结构,方便脚本的编写和生成。下面以 Android 系统为例。在 Android 模拟器上安装 ApiDemos-debug.apk 应用
测试应用下载地址:
https://github.com/appium/sample-code/raw/master/sample-code/apps/ApiDemos/bin/ApiDemos-debug.apk
下载该 apk 并安装到测试设备,之后会基于该 app 进行自动化测试。
在录制脚本前启动测试设备,并且通过命令行查看该设备已连接成功。使用下面的命令查看设备是否连接,展示出下面的内容,即说明设备已连接。
$ adb devices
List of devices attached
emulator-5554 device
上面的结果中,“emulator-5554” 代表设备的名称,“device” 代表设备的状态,说明设备已连接。如果是其它状态,需要重新连接设备,或者在设备上检查是否开启开发者模式,以及打开 USB 调试模式。
获取应用包名和页面名称
移动端的包名(也就是 Package)作为每个 app 的唯一标识,每个 APP 都有自己的 Package Name,且每个设备上相同的包名的 APP,只允许安装一个。
页面(也就是 Activity)是 Android 组件中最基本,也是常见的四大组件之一,可以理解为一个页面就是一个 Activity,移动端打开一个 app 的页面,在操作页面的时候会发生页面的跳转,也就是 Activity 之间发生了切换。在编写测试脚本之前,首先要获取应用的包名以及启动页的 Activity 名字。
获取包名,终端进入 aapt
工具所在目录(Android SDK 的 build-tools 目录下),输入:
aapt dump badging [app名称].apk
运行结果:
图中“package:name”对应的结果是包名,“Lauchable-activity:name”对应的结果是“包名+页面名”。但是有些不符合规范的应用,通过 aapt 命令无法获取到 “Lauchable-activity:name” 这部分内容。
针对上面的问题,就需要在测试设备上启动 APP,然后在终端输入如下命令(Mac OS / Linux 系统):
adb logcat | grep ActivityManager
运行结果如下图:
Appium-desktop自动化用例录制
1. 启动 Appium Server
使用 Appium Inspector 录制测试脚本,首先需要启动 Appium-desktop,点击“Start Server”,如下图:
2. 打开 Appium Inspect 工具
点击右上角“Start inspector Session”按钮,打开 inspector 工具,图形页面如下:
Inspector 就是探测器,给它相应的参数,启动 app 帮你分析移动端 APP 的 UI 界面,还可以使用它录制脚本,支持导出多种语言的测试脚本。
3. 配置 Desired Capabilities 信息
platfromName:使用哪个移动操作系统平台,这里可以填 Android、iOS
deviceName:设备名称,可以随便填,但必须得有此项
appPackage:要启动的 android 应用程序包(“io.appium.android.apis”)
appActivity:App 启动的首页 Activity(“.ApiDemos”或者“io.appium.android.apis/.ApiDemos”)
4. 启动 Session
点击 “Start Session”,录制脚本。
对于 Appium 的初学者,可以通过录制功能,了解编写用例的时候需要使用哪些 API,有哪些编写规范等,可以作为一个很好的参考。
点击“开始录制”按钮(小眼睛图标):
左侧选择要操作的页面元素,在右侧选择要做的操作:
Tap 为点击元素 Send keys 为文本框录入 Clear 为清空文本框
利用上图 1,2 步组合,就可以实现对 app 的操作。比如在截取的页面中鼠标点击“Views”->点击 Tap,再点击“Buttons”->点击 Tap。每操作一步,都会自动生成脚本,如图:
默认生成的语言为 Java-unit,如果想生成其他语言,只要点击下拉栏选择相应选项即可,这里切换成 Python 语言。
把代码复制粘贴到编辑器中,就可以运行。代码如下:
from appium import webdriver
caps = {}
caps["platformName"] = "android"
caps["deviceName"] = "demo"
caps["appPackage"] = "io.appium.android.apis"
caps["appActivity"] = ".ApiDemos"
caps["autoGrantPermissions"] = "true"
driver = webdriver.Remote("http://localhost:4723/wd/hub", caps)
el2 = driver.find_element_by_id("tv.danmaku.bili:id/expand_search")
el2.click()
el3 = driver.find_element_by_accessibility_id("搜索查询")
el3.send_keys("华测教育")
driver.quit()
上面是录制出来的代码,录制生成的代码需要手动优化,添加需要的单元测试框架(比如 Pytest,Unittest)使代码更优雅。代码录制对刚入门的人来说还是比较实用的,它的缺点也是很明显:
所有的代码都会在一个文件里,显得代码非常的冗余
不能解决工作中大部分的场景