史上最全 Appium 自动化测试从基础到框架实战精华学习笔记(一)
本文为霍格沃兹测试学院学员学习笔记,进阶学习文末加群。
对测试人来说,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
from appium import webdriver
设置 caps 的值
desire_cap= {
#默认是 Android
"platformName":"android",
#adb devices 的 sn 名称
"deviceName":"127.0.0.1:7555",
#包名
"appPackage":"com.xueqiu.android",
#activity 名字
"appActivity":".view.WelcomeActivityAlias"
}运行 appium,前提是要打开 appium server
driver=webdriver.Remote("http://127.0.0.1:4723/wd/hub",desire_cap)
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
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
-
结果:
-
获取元素尺寸(高和宽):element.size
-
结果:
实战小案例 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(" 搜索失败 ")
更多内容,我们在后续文章分享。
**
来霍格沃兹测试开发学社,学习更多软件测试与测试开发的进阶技术,知识点涵盖web自动化测试 app自动化测试、接口自动化测试、测试框架、性能测试、安全测试、持续集成/持续交付/DevOps,测试左移、测试右移、精准测试、测试平台开发、测试管理等内容,课程技术涵盖bash、pytest、junit、selenium、appium、postman、requests、httprunner、jmeter、jenkins、docker、k8s、elk、sonarqube、jacoco、jvm-sandbox等相关技术,全面提升测试开发工程师的技术实力