技术分享 | Appium 用例录制

2022-06-01 11:14:18 浏览数 (1)

本文节选自霍格沃兹测试开发学社内部教材

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自动化用例录制

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 进行自动化测试。

在录制脚本前启动测试设备,并且通过命令行查看该设备已连接成功。使用下面的命令查看设备是否连接,展示出下面的内容,即说明设备已连接。

代码语言:javascript复制
$ 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 目录下),输入:

代码语言:javascript复制
aapt dump badging [app名称].apk

运行结果:

图中“package:name”对应的结果是包名,“Lauchable-activity:name”对应的结果是“包名 页面名”。但是有些不符合规范的应用,通过 aapt 命令无法获取到 “Lauchable-activity:name” 这部分内容。

针对上面的问题,就需要在测试设备上启动 APP,然后在终端输入如下命令(Mac OS / Linux 系统):

代码语言:javascript复制
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 语言。

把代码复制粘贴到编辑器中,就可以运行。代码如下:

代码语言:javascript复制
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)使代码更优雅。代码录制对刚入门的人来说还是比较实用的,它的缺点也是很明显:

  • 所有的代码都会在一个文件里,显得代码非常的冗余
  • 不能解决工作中大部分的场景

0 人点赞