java版app自动化测试初始化模板
基础内容:
Appium 的设计理念
webdriver 是基于 http 协议的,第一连接会建立一个 session 会话,并通过 post 发送一个 json 告知服务端相关测试信息
client/server 设计模式
客户端通过 webdriver json wire 协议与服务器通讯
多语言支持
server 可以放在任何地方
服务器 nodejs 开发的 http 服务
appium 使用 appium-xcuitest-driver 来测试 iphone 设备,其中需要安装 Facebook 出的 WDA(webdriver agent) 来驱动 ios 测试
Appium 的生态工具
adb:Android 控制工具
appium Destkop:内嵌 appium server 和 inspector 的综合工具
appium server:appium 的核心工具,命令行工具
appium client:各种语言的客户端封装库,用户连接 appium server,包含 python、java、ruby 等
appcrawler 自动遍历工具
获取 App 的信息(重点)
获取当前元素界面:adb shell dumpsys activity top
获取任务列表:adb shell dumpsys activity activities
获取 app 的 package 和 activity:
查看:adb shell;然后 logcat | grep -i displayed
验证启动应用:adb shell am start -W -n "com.tengyun.yyn/.ui.SplashActivity" -S
(网易mumu连接端口默认为7555||adb connect 127.0.0.1:7555 ,然后再查下驱动就有了
<Forwarding name="ADB_PORT" proto="1" hostip="127.0.0.1" hostport="7555" guestport="5555"/>)
入坑解决:Did not get confirmation UiAutomator2 deleteSession worked; Error was: UnknownError: An unknown server-side error occurred while processing the command. Original error: Trying to proxy a session command without session id。
上面提示解决:删除原有的Settings,【win路径:C:\Users\Administrator\AppData\Roaming\appium-desktop】重新配置参数重新打开窗口解决了问题【jkd1.8、appium1.18.0】
或者是改下automationName参数值:"automationName":"uiautomator1"
appium连接网易mumu模拟器:
进入cmd后,输入adb devices,会显示目前处于5037端口,并且守护进程成功启动的说明。
打开mumu模拟器之后找到的安装路径,点开bin文件夹,找到adb_server.exe的文件,在上方地址栏中输入cmd,进入cmd后,输入adb_server.exe connect 127.0.0.1:7555
之后关掉模拟器,打开platform-tools,并进入cmd,输入adb devices,如下图所示就表示成功连接了
Capability 设置
文档地址:http://appium.io/docs/en/writing-running-appium/caps/index.html
platformName:android 通常都是写 android
deviceName:127.0.0.1:7555 这个通常是 adb devices 的名称
appPackage:com.xueqiu.android 这个是 app 的 package 包名
appActivity:.view.WelcomeActivityAlias 这个是 app 的 activity 名
noReset:true, false 是否重置测试的环境(例如首次打开弹框,或者登陆信息)
unicodeKeyboard:true, false 是否需要输入非英文之外的语言并在测试完成后重置输入法,比如输入中文
dontStopAppOnReset:true, false 首次启动的时候,不停止 app
skipDeviceInitialization:true, false 跳过安装,权限设置等操作
Android 的基础知识
Android 的布局
Android 是通过容器的布局属性来管理子控件的位置关系,布局过程就是把界面上的所有的控件,根据他们的间距的大小,摆放在正确的位置:
线性布局:LinearLayout
相对布局:RelativeLayout
帧布局:FrameLayout
绝对布局:AbsoluteLayout
表格布局:TableLayout
网格布局:GirdLayout
约束布局:ConstraintLayout
Android 四大组件:
activity:与用户交互的可视化界面
service:实现程序后台运行的解决方案,比如 qq 音乐的音乐在后台运行,没有界面
content provide:内容提供者,提供程序所需要的数据,比如?提供数据库?
broadcast receiver:广播接收器,监听外部事件的到来(比如来电)
Android 常用的控件:
TextView:文本控件
EditText:可编辑文本控件
Button:按钮
ImageButton:图标按钮
ToggleButton:开关按钮
ImageView:图片控件
CheckBox:复选框控件
RadioButton:单选框控件
控件知识:
dom:Document Object Model 文档对象模型
dom 应用:最早应用于 html 和 js 的交互,用户表示界的控件层级,界面的结构化描述,常见的格式为 - html、xml。核心元素为节点和属性
xpath:xml 路径语言,用于 xml 中的节点定位
Android 的应用层级结构是定制的 xml
app source 类似于 dom,表示 app 的层级,表示界面里面所有的控件数的结构
每个控件都有它的属性(resourceid、xpath、aid),没有 css 属性
Appium 的元素定位
普通方式的定位
driver.find_element_by_accessibility_id() 对应 content-desc
driver.find_element_by_id() 对应 resource-id
driver.find_element_by_name() 对应 text
driver.find_element_by_xpath() 对应 xpath
By 的定位方式(重点)
首先要 from appium.webdriver.common.mobileby import MobileBy as By
self.driver.find_element(By.ID,"") 对应 resource-id
self.driver.find_element(By.XPATH,"") 对应 xpath
self.driver.find_element(By.ACCESSIBILITY_ID,"") 对应 content-desc
self.driver.find_element(By.NAME,"") 对应 text
Xpath 的定位方式(重点)
driver.find_element_by_xpath("//[@text=' 扫一扫 ']")
driver.find_element_by_xpath("//
[@resource-id='com.taobao.taobao:id/tv_scan_text']")
driver.find_element_by_xpath("//[@content-desc=' 帮助 ']")
driver.find_element(By.XPATH,"//
[@resource-id='com.xueqiu.android:id/name' and @text=' 阿里巴巴 ']") and 的使用
父类和兄弟类的方法://[@text=' 性别 ']/..//[@text=' 男 ']。其中 /.. 表示父类,//* 就是兄弟,孙子等类
//*[Contains(@text,"tong")] 这是 xpath 的 text 模糊搜索的方法
元素的方法
元素的常用方法
点击方法:element.click()
输入操作:element.send_keys("tong")
设置元素的值:element.set_value("tongtong")
清除操作:element.clear()
是否可见:element.is_displayed 返回 true or false
是否可用:element.enabled() 返回 true or false
是否被选中:element.is_selected() 返回 true or false
获取属性值:element.get_attribute(name)
属性值介绍
get_attribute(name) 获取的属性名称和 uiautomatorviewer 的一致,但是 index 的值获取不了
真假获取的值是 true 和 false 的字符串,并不是 python 的 boolean 值
元素常用的属性
获取元素文本:element.text
获取元素坐标:element.location
结果:{'y':19,'x':498}
获取元素尺寸(高和宽):element.size
结果:{'width':500,'height':22}
UIAutomator 查找元素
优缺点
优点
xpath 定位速度慢
UIAutomator 是 Android 的工作引擎,速度快
滚动查找很方便
缺点
表达式书写复杂,容易写错 IDE 没有提示
定位方式
通过 resource-id 定位
通过 classname 定位
通过 content-desc 定位
通过文本定位
组合定位
通过父子关系定位
用法
driver.find_element_by_android_uiautomator("表达式")
注:外层要用单引号,内层的字符串用双引号,因为本来就是 Java,Java 双引号才表示字符串
通过文本定位
new UiSelector().text("text文本")
通过 textContains 模糊匹配
new UiSelector().textContains("text文本")
通过某个文本开头匹配
new UiSelector().textStartWith("text文本")
正则表达式匹配
new UiSelector().textMatches("text文本")
组合定位
比如 id 与 text 的属性组合:driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/login_account").text("我的")')
父子关系定位:childSelector,先定位到父类,再用 childSelector 来定位子类
driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/login_account").childSelector(text("股票"))')
兄弟定位:fromParent
driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/login_account").fromParent(text("股票"))')
强制等待、隐式等待、显示等待
强制等待是 sleep,强烈不推荐,设定的时间太固定,如果是模拟器等待3秒,真机可能只需要等待2秒。
driver.implicitly.wat(timeout),贯穿全部元素的等待,只需要设定一次即可,通常是在创建 driver 的时候后的代码运行,是 dom 建立之后的等待。
显示等待的简介
显示等待与隐式等待相对,显示等待必须在每一个需要等待的元素前面进行声明
是针对某个特定的元素设置等待时间,在设置时间内,默认美格一段时间检测一次当前某个元素是否存在
如果在规定的时间内找到元素,则直接执行,即找到元素就执行相关操作
如果超过设置时间检测不到就抛出异常,默认检测频率为0.5s,默认抛出的异常时NoSuchElementException
用到的两个常用类
WebDriverWait
expected_condition
java版app自动化测试初始化模板
目录结构如下:
(包含:驱动的基础配置、全局异常处理、异常截图、报告自动生成、app常用操作方法封装、常用工具类封装)
各包分层关系
basepage包负责存放app公共操作方法、AndroidDriver基础配置、testNG公共执行顺序BaseTest,对外暴露驱动等。
BaseApp类包含app操作有:封装By类型的点击操作和输入框输入数据操作、切换到下一个窗口操作、上下左右滑动操作、具体坐标点击操作、直接使用adb命令的操作、前进后退刷新的操作等,其它方法可自行封住。
部分封装方法如下:
page包(通用PO模式):分为data数据包和element元素操作包,把定位元素和输入框数据统一放到data包中,元素的操作放到element包中。其中元素的操作数据来源于data包中。
testcase包是根据业务流程编写用例步骤(后面的用例维护均在此包下)
resource包下可以放chromedriver驱动或者存放异常捕获的截图、测试报告自动生成index.html报告(由于使用springboot可以直接访问报告)另一种测试报告用的最多的是allure2,一个开源很好的报告模板allure2 的GitHub地址测试报告输出到allure-results包下。
allure2报告集成,win下需要先下载allure2的zip包GitHub官网下载地址allure2,下载zip包后需要配置下环境变量,用例执行完成后会生成allure-results文件夹,在当前文件夹下执行
allureserve allure-results
即可自动打开web测试报告,如下:
extentreports报告样式如图(这里把项目源码路径修改了下,需要单独导下包)