对测试人来说,Appium 是非常重要的一个开源跨平台自动化测试工具,它允许测试人员在不同的平台(iOS、Android 等)使用同一套 API 来写自动化测试脚本,这样可大幅提升代码复用率和工作效率。
本文汇总了从 Appium 基础到自动化测试高级实战中,所涉及到的方方面面的知识点精华内容(如下所示),希望对大家快速总结和复习有所帮助。
Appium 从基础到自动化测试框架实战
Appium 基础 1(环境搭建和简介)
Appium 基础 2(元素定位和元素常用方法)
Appium 基础 3(手势操作和 uiautomator 查找元素)
Appium 基础 4(显式等待)
Appium 基础 5(toast 和参数化)
Appium 基础 6(webview)
Appium_ 企业微信练习 (非 PO,增加和删除联系人)
Appium_ 企业微信练习 (PO–增加联系人)
Appium 环境搭建
JDK 的搭建
下载 1.8 的 jdk
新建环境变量:JAVA_HOME 值为:D:\Program Files\Java\jdk1.7.0
新建环境变量:CLASSPATH 值为:.;%JAVA_HOME%\lib;(注意:点号表示当前目录,不能省略)
在系统变量 Path 的值的前面加入以下内容:%JAVA_HOME%\bin
SDK 的配置
下载 sdk
打开 sdk 的 sdk manager,安装 tools 前 3 个东西和 google 的 usb 驱动
配置 Android home 里面的 platform-tools 和 tools
Appium 的搭建
安装 node.js,配置 node.js 的环境变量
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install -g appium
cnpm install -g appium-doctor
pip install appium-python-client
appium 运行的 python 代码
mumu 连接 adb 是:adb connect 127.0.0.1:7555
Appium 的简介
Appium 的引擎
Android 是 uiautomator2
ios 是 xcuitest
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.xueqiu.android/.view.WelcomeActivityAlias -S
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 跳过安装,权限设置等操作
测试用的 apk
https://github.com/appium/appium/tree/master/sample-code/apps
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}
实战小案例 1
打开雪球 app
点击搜索输入框
向搜索输入框输入 “阿里巴巴”
在搜索的结果里选择阿里巴巴,然后点击
获取这只上香港 阿里巴巴的股价,并判断这只股价的价格>200
代码
from time import sleep
from appium import webdriver
from appium.webdriver.common.mobileby import MobileBy as By
class TestFind():
#设置 caps 的值
def setup(self):
self.desire_cap= {
#默认是 Android
"platformName":"android",
#adb devices 的 sn 名称
"deviceName":"127.0.0.1:7555",
#包名
"appPackage":"com.xueqiu.android",
#activity 名字
"appActivity":".view.WelcomeActivityAlias",
"noReset":"true",
"unicodeKeyboard":True
}
#运行 appium,前提是要打开 appium server
self.driver=webdriver.Remote("http://127.0.0.1:4723/wd/hub",self.desire_cap)
self.driver.implicitly_wait(5)
def test_search(self):
"""
1. 打开雪球 app
2. 点击搜索输入框
3. 向搜索输入框输入 “阿里巴巴”
4. 在搜索的结果里选择阿里巴巴,然后点击
5. 获取这只上香港 阿里巴巴的股价,并判断这只股价的价格>200
:return:
"""
sleep(3)
#点击搜索框
self.driver.find_element(By.ID,"com.xueqiu.android:id/tv_search").click()
#向搜索框输入阿里巴巴
self.driver.find_element(By.ID,"com.xueqiu.android:id/search_input_text").send_keys(" 阿里巴巴 ")
#找到搜索框预览结果的阿里巴巴,并点击
self.driver.find_element(By.XPATH,"//*[@resource-id='com.xueqiu.android:id/name' and @text=' 阿里巴巴 ']").click()
#选择 HK 股价的元素
prices=self.driver.find_elements(By.ID,"com.xueqiu.android:id/current_price")[1]
#提取股价的 text 属性
price=float(prices.text)
#判断股价是否大于 200
assert price > 200
实战小案例 2
打开雪球首页
定位首页的搜索框
判断搜索框是否可用,并查看搜索框 name 属性值
打印搜索框这个元素的左上角坐标和它的宽高
向搜索框输入:alibaba
判断阿里巴巴是否可见
如果可见,打印搜索成功点击,如果不可见,打印搜索失败
代码
from time import sleep
from appium import webdriver
from appium.webdriver.common.mobileby import MobileBy as By
class TestFind():
#设置 caps 的值
def setup(self):
self.desire_cap= {
#默认是 Android
"platformName":"android",
#adb devices 的 sn 名称
"deviceName":"127.0.0.1:7555",
#包名
"appPackage":"com.xueqiu.android",
#activity 名字
"appActivity":".view.WelcomeActivityAlias",
"noReset":"true",
"unicodeKeyboard":True
}
#运行 appium,前提是要打开 appium server
self.driver=webdriver.Remote("http://127.0.0.1:4723/wd/hub",self.desire_cap)
self.driver.implicitly_wait(5)
def test_element_function(self):
"""
1. 打开雪球首页
2. 定位首页的搜索框
3. 判断搜索框是否可用,并查看搜索框 name 属性值
4. 打印搜索框这个元素的左上角坐标和它的宽高
5. 向搜索框输入:alibaba
6. 判断阿里巴巴是否可见
7. 如果可见,打印搜索成功点击,如果不可见,打印搜索失败
:return:
"""
sleep(8)
#找到搜索框的元素
search=self.driver.find_element(By.ID, "com.xueqiu.android:id/tv_search")
#当搜索框是可用(类似可点击)后才进行下面的操作,is_enabled() 返回 Ture or False
if search.is_enabled():
#打印搜索框的 text 值
print(search.text)
#打印搜索框左上角的坐标
print(search.location)
#打印搜索框的高和宽
print(search.size)
#点击搜索框,才可以进行下面的操作
search.click()
#在搜索框中输入阿里巴巴
self.driver.find_element(By.ID, "com.xueqiu.android:id/search_input_text").send_keys(" 阿里巴巴 ")
#定义找到预览结果的阿里巴巴的元素
alibaba=self.driver.find_element(By.XPATH, "//*[@resource-id='com.xueqiu.android:id/name' and @text=' 阿里巴巴 ']")
#当 alibaba 元素可见,打开搜索成功,否则打印搜索失败
if alibaba.is_displayed():
print(" 搜索成功 ")
else:
print(" 搜索失败 ")
更多内容,我们在后续文章分享。
(文章来源于霍格沃兹测试学院)