ce
一 Appium简介
1. 什么是APpium
- Appium是一个移动端的自动化测试框架,可用于测试原生应用移动网页应用和混合型应用,且是跨平台的
- 原生的应用指androi或ios的sdk编写的应用
- 移动网页应用是指网页应用,类似于ios中的Safari或Chrome应用
- 混合型应用是介于web-app和native-app之间的应用
- Appium是模拟人的操作进行功能自动化,通常用于功能测试和兼容性测试
2. Appium的设计
- 采用底层驱动商提供的自动化框架
- IOS : 苹果的UIAutonmation
- Android4.2+ : 谷歌的UIAutomator
- 采用底层驱动商提供统一API,即WebDriverAPI
- WebDriver(也称Selenium WebDriver)是一个C/S架构的协议,通过这个协议,用任何语言写成的客户端都可以发送HTTP请求给服务器,也就是说可以自由选择想要的测试框架和执行器,也可以将任何包含HTTP客户端的库文件加入到你的代码中。
- 在WEbDriver的基础上,扩展了一些适合移动端自动化协议的API
3. Appium原理
- 核心是Web服务器
- 它接受客户端的连接,执行客户端的命令,在手机设备上执行命令,然后通过HTTP的响应手机命令执行的结果
- Session
- 自动化的过程通常在Session上下文执行
- 客户端初始化一个Session会话,虽然不同的语言初始化的方式不同,但他们都要发送POST/session请求到服务器,这个请求里面会带有一个对象:desired capabilities,这个时候服务器端会启动自动化session然后返回一个session ID,以后的命令都会用这个session ID去匹配
- Desired Capabilities
- Desired Capabilities对象其实一个key-value的集合,里面包含了各种各样的信息,发送到服务器端后,服务器解析这些嘻嘻就知道 客户端端对哪种session感兴趣,然后会启动相应的session
- 里面的信息会影响服务器启动session的类型,比如你platformName值是ios,就会告诉服务器启动一个ios的session,而不是Android sess,之后适应js打开新窗口
- Appium Server
- Appium 是一个用Node。js编写的HTTP Server,它创建并管理多个WebDriver session来和不同平台交互,如IOS,Android等
- Appium Clients
- Appium开始一个测试后,就会在被测设备(手机)上启动一个Server监听来自Appium Server的指令,每种平台像IOS和Android都有不同的运行和交互方式,所以Appium会用米格桩程序“侵入”该平台,并接受指令,来完成测试用例的运行
- 客户端的概念不是我们传统意义上的客户端,这里的客户端更好的理解是一个扩展WebDriver的协议库,你在用自己喜欢的语言写case的时候,将该语言扩展WebDriver的库添加到你的环境,你就可以理解这是个客户端
二 Appium环境搭建
1. 基础环境
-
安装node.js :是JavaScript运行环境
-
安装.NET framework : 是微软的开发程序的框架
-
安装vc_redist:VisualC++的运行库
-
安装jdk并配置环境变量
-
安装Python
-
安装Appium :
https://github.com/appium/appium-desktop/releases/tag/v1.15.1
-
安装Appium Python Client
-
Appium Client 是配合原生的WebDriver来使用的
pip install Appium-Python-Client 利用命令pip list查看安装列表查找是否已经安装上
-
2. 通过Python编写自动化测试脚本
-
导包 :
from appium import webdriver
-
设置desired_capabilities
-
创建字典 :
desired_caps = {}
-
指定设备信息
# 指定移动平台操作系统 desired_caps["platformName"] = "Android" # 指定操作系统版本 desired_caps["platformVersion"] = "8.0.0" # 指定设备 可通过adb device查看 desired_caps["deviceName"] = "62963179" # 指定需要测试的app的程序包名 desired_caps["appPackage"] = "com.miui.calculator" # 指定启动页面的名字 desired_caps["appActivity"] ="cal.CalculatorActivity" ''' 查看app启动页Activity 1. 使用adb shell 命令进入Android端shell命令界面 2. 执行命令 : dumpsys package 包名 在前几行找到带有Activity的一串即为启动页面 '''
-
首先打开appium服务
-
启动app
driver=webdriver.Remote("http://localhost:4723/wd/hub",desired_caps)
-
-
appium保存能力
{ "platformName":"Android", "platformVersion":"8.0.0", "deviceName":"62963179", "appPackage":"com.miui.calculator", "appActivity":"cal.CalculatorActivity" }
这样软件就会识别并截图app应用,为接下来的定位元素做准备
-
操作元素
driver.find_element_by_id("xxx").click() #定位元素并点击
-
指定每次运行测试前不重新安装被测试app
desired_caps["noReset] = True
-
简单测试miui的计算器
# 导包 from appium import webdriver import time # 设置desired_capablities 字典 desired_caps = {} # 指定移动平台操作系统 desired_caps["platformName"] = "Android" # 指定操作系统版本 desired_caps["platformVersion"] = "8.0.0" # 指定设备 可通过adb device查看 desired_caps["deviceName"] = "62963179" # 指定需要测试的app的程序包名 desired_caps["appPackage"] = "com.miui.calculator" # 指定启动页面的名字 desired_caps["appActivity"] ="cal.CalculatorActivity" # 指定每次运存测试前重新安装测试的app desired_caps['noReset'] = True ''' 查看app启动页Activity 1. 使用adb shell 命令进入Android端shell命令界面 2. 执行命令 : dumpsys package 包名 在前几行找到带有Activity的一串即为启动页面 ''' # 启动app driver = webdriver.Remote("http://localhost:4723/wd/hub",desired_caps) # 操作元素 (自动完成2+5的操作) driver.find_element_by_id("com.miui.calculator:id/btn_2_s").click() # 点击事件 driver.find_element_by_id("com.miui.calculator:id/btn_plus_s").click() # 点击事件 driver.find_element_by_id("com.miui.calculator:id/btn_5_s").click() # 点击事件 # driver.find_element_by_xpath('//android.widget.ImageView[@content-desc="等于"]').click() # 点击事件 # 回车代替等号 driver.press_keycode(66) time.sleep(5) # 退出app driver.quit()
-
键盘输入数据 - send_keys(),clear()-清空
driver.page_source # 获取网页源数据
from appium import webdriver import time desired_caps = {} desired_caps["platformName"] = "Android" desired_caps["platformVersion"] = "8.0.0" desired_caps["deviceName"] = "62963179" desired_caps["appPackage"] = "com.android.browser" desired_caps["appActivity"] ="BrowserActivity" # 指定每次运存测试前重新安装测试的app desired_caps['noReset'] = True # 启动app driver = webdriver.Remote("http://localhost:4723/wd/hub",desired_caps) # 操作元素 (用浏览器搜索"appium"关键字) driver.find_element_by_id("com.android.browser:id/search_hint").click() driver.find_element_by_id("com.android.browser:id/url").send_keys("appium") # 回车代替等号 driver.press_keycode(66) time.sleep(5) # 退出app driver.quit()
若不能输入中文,用一下设置
desired_caps['UnicodeKeyboard']=True desired_caps['resetKeyboard']=True driver.find_element_by_id("com.android.browser:id/url").send_keys(u"appium")
3. 断言
# 导包
from appium import webdriver
import time
# 设置desired_capablities 字典
desired_caps = {}
# 指定移动平台操作系统
desired_caps["platformName"] = "Android"
# 指定操作系统版本
desired_caps["platformVersion"] = "8.0.0"
# 指定设备 可通过adb device查看
desired_caps["deviceName"] = "62963179"
# 指定需要测试的app的程序包名
desired_caps["appPackage"] = "com.miui.calculator"
# 指定启动页面的名字
desired_caps["appActivity"] ="cal.CalculatorActivity"
# 指定每次运存测试前重新安装测试的app
desired_caps['noReset'] = True
'''
查看app启动页Activity
1. 使用adb shell 命令进入Android端shell命令界面
2. 执行命令 : dumpsys package 包名
在前几行找到带有Activity的一串即为启动页面
'''
# 启动app
driver = webdriver.Remote("http://localhost:4723/wd/hub",desired_caps)
# 操作元素 (自动完成2+5的操作)
driver.find_element_by_id("com.miui.calculator:id/btn_2_s").click() # 点击事件
driver.find_element_by_id("com.miui.calculator:id/btn_plus_s").click() # 点击事件
driver.find_element_by_id("com.miui.calculator:id/btn_5_s").click() # 点击事件
# driver.find_element_by_xpath('//android.widget.ImageView[@content-desc="等于"]').click() # 点击事件
# 回车代替等号
driver.press_keycode(66)
# 断言
result = driver.find_element_by_id("com.miui.calculator:id/result").text
print(result)
if result=="= 7":
print("通过")
else:
print("失败")
time.sleep(5)
# 退出app
# driver.quit()
4. 获取列表文件
5. 获取文本文件
6. 获取excel文件
-
安装pandas
pip install pandas
-
获得数据
import pandas data = pandas.read_excel("test.xlsx", sheet_name=0, names=["数值1", "运算符", "数值2", "预期结果"], dtype={"数值1": str, "运算符": str, "数值2": str, "预期结果": str},header=None) datalist = data.values.tolist() # 将数据转换为二维列表
三 unittest测试框架
基本代码
-
导包 :
from appium import webdriver from time import sleep import unittest
-
创建全局变量 driver
driver=None
放在类之外
-
创建测试类
class 类名(unittest.TestCase)
-
创建初始化和还原环境的函数
@classmethod def setUpClass(cls): # 所有测试函数运行前运行一次 device = {} device={} device['deviceName']='192.168.120.102:5555' device['platformName']='Android' device['platformVersion']='9' device['noReset']=True device['appPackage']='com.android.quicksearchbox' device['appActivity']='com.android.quicksearchbox.SearchActivity' device['unicodeKeyboard']= True device['resetKeyboard']=True global driver # 需要声明全局变量 @classmethod def tearDownClass(cls): 所有测试幻术运行完后运行一次 # 关闭app driver.quit()
-
测试函数
def test函数名(self): # 函数名必须以test开头 u"测试描述" # 省略此行时显示函数名 global driver 测试代码 # 多个测试函数按照函数名的ASSCII顺序执行
-
运行测试
if __name__ == '__main__': unittest.main(verbosity=2) # verbosity=2 表示显示每个用例的详细信息,可以省略,但测试结果不详细
-
测试结果
测试结果 .:代表测试通过。 F:代表测试失败,F 代表 failure。 E:代表测试出错,E 代表 error。 s:代表跳过该测试,s 代表 skip。
-
百度搜索测试示例
from appium import webdriver from time import sleep import unittest driver = None class Webapp(unittest.TestCase): # 创建初始化和还原环境的函数 @classmethod def setUpClass(cls): # 所有测试函数运行前运行一次 # 指定设备信息 device = {} device["deviceName"] = "emulator-5554" device["platformName"] = "Android" device["platformVersion"] = "7" device["appPackage"] = "com.android.browser" device["appActivity"] = "BrowserActivity" device["noReset"] = True global driver driver = webdriver.Remote("http://localhost:4723/wd/hub", device) @classmethod def tearDownClass(cls): # 所有测试函数运存完后运行一次 # 关闭app global driver driver.quit() # 测试函数 def testBaidu(self): # 操作元素 u"测试百度搜索" global driver driver.find_element_by_id("com.android.browser:id/url").clear() driver.find_element_by_id("com.android.browser:id/url").click() driver.find_element_by_id("com.android.browser:id/url").send_keys("https://www.baidu.com") driver.press_keycode(66) sleep(1) driver.find_element_by_xpath( '/hierarchy/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout[2]/android.widget.LinearLayout/android.widget.FrameLayout/android.webkit.WebView/android.webkit.WebView/android.view.View/android.view.View[1]/android.view.View/android.view.View[2]/android.view.View[3]/android.widget.EditText').send_keys( "Python学习") driver.find_element_by_xpath( '/hierarchy/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.FrameLayout/android.widget.LinearLayout/android.widget.FrameLayout[2]/android.widget.LinearLayout/android.widget.FrameLayout/android.webkit.WebView/android.webkit.WebView/android.view.View/android.view.View[1]/android.view.View/android.view.View[2]/android.view.View[3]/android.widget.EditText').click() driver.press_keycode(66) sleep(3) if __name__ == '__main__': unittest.main(verbosity=2)
断言
设定断言方式一 :
assert str1 in str2,断言失败时的消息文本
设定断言方式二 :
assert 表达式 1==表达式 2
设置断言方式三 :
self.assertIn(str1,str2) # 断言 str1 是否在 str2 中
设置断言方式四 :
self.assertEqual(实际,预期)
WebApp 中的断言:
driver.page_source # 获得网页返回结果/所有页面元素
参数化
-
安装 nose_parameterized :
pip install nose_parameterized
-
导入包parameterized
import parameterized
-
定义参数
将参数放在了列表中 data = [ [数据11,数据12], [数据21,数据22], ... ]
-
引用参数
@parameterized.parameterized.expand(data): # data的数据一行一行获取 def test函数名(self,参数1,参数2,...):
测试报告
-
导包 :
import HTMLTestRunner
-
创建测试套件
suit = unittest.TestSuite() tests = unittest.defaultTestLoader.discover("测试模块的目录, pattern="test_*.py") # pattern="test_*.py" 指的是目录下所有test_开头的py文件都运存并生成测试报告 suite.addTest(tests)
-
运行测试报告,保存报告
now = time.strftime("%Y%m%d %H%M%S", time.localtime()) # 获取当前时间并设置格式 reportFile = "./" + now + "_result.html" # 生成报告的路径及文件名 fp = open(reportFile, "w",encoding="utf-8") runner = HTMLTestRunner.HTMLTestRunner(stream=fp, title="功能测试", description="报告说明与描述,") runner.run(suite) fp.close()
四 安装APK
-
安装 Genymotion-ARM-Translation
Genymotion 是一款基于 x86 架构的 Android 模拟器,而大部分应用是 arm 架构,所以 两者不兼容。 对于 x86 的真机,X86 处理器已经能够基本兼容 ARM 了指令。 对于 Genymotion 模拟器,则通过安装 Genymotion-ARM-Translation 来进行兼容。 genymotion 使用 Genymotion-ARM-Translation.zip 文件是不通用的,每个 Android 版本 对应 ARM 指令集的版本也是不一样。 1. 将文件复制到模拟器 adb push Genymotion_ARM_Translation.zip /sdcard/Download 2. 将 Genymotion-ARM-Translation.zip 继续拖动到模拟器中 3. 重启模拟器 :adb reboot 4. 如果拖动没安装成功,可以使用下面的命令安装 adb shell cd /sdcard/Download/ sh /system/bin/flash-archive.sh /sdcard/Download/Genymotion_ARM_Translation.zip
-
安装apk
- 命令安装 :
adb install apk文件名
- 拖动安装
- 命令安装 :
-
操作app权限弹窗
显示当前app的包名及界面的Activity adb shell dumpsys window w | findstr \/ | findstr name=
toast=('xpath','//*[contains(@text,"ALLOW")]') 查找 xpath 路径,标记任意,text 属性中包括 ALLOW id 有时候会发生变化 t=WebDriverWait(driver,10,0.1).until(expected_conditions.presence_of_element_located(toa st)) 寻找指定的 toast 元素 最大超时时间 10s,默认 30s,间隔查询时间 0.1s,默认 0.5s 查询一次 需要导入包、 from selenium.webdriver.support.ui import WebDriverWait 等待模块 from selenium.webdriver.support import expected_conditions 判断模块 t.click() 单击找到的元素
-
滑动
-
获取屏幕分辨率尺寸
width = driver.get_windows_size()['width'] height = driver.get_windows_size()['height']
for i in range(1,7): driver.swipe(width/2,height*3/4,width/2,height/4,1000) 向上滑,每次间隔 1000ms
判断是否出现指定窗口
第一种 : if driver.current_activity()=='activity 名称' : # driver.current_activity():获得当前 activity 名称 适当提前延时 第二种 : if driver.wait_activity("activity 名称",超时时间) 返回值 :窗口存在是返回 True
-
-
其他
-
device['autoLaunch] = False
-
有时不想让appium每次都自动启动app, 而是想自己打开activity或者在原来activity基础上继续操作,可以方便使用此项
-
但是device[‘appPackage’]和device[‘appActivity’]不能省略
-
启动app
driver.launch_app()
-
关闭app
driver.close_app()
-
重置app
driver.reset()
: 清除设置以后启动或重启 App -
自己启动 activity
driver.start_activity('包名','Activity页面名')
-
在已经打开的Activity页面继续操作
-
-
查看当前的App类型/上下文
driver.contexts
-
查看当前的app类型/上下文
driver.current_context
-
切换到指定app类型/上下文
返回值 :窗口存在是返回 True
-
-
其他
-
device['autoLaunch] = False
-
有时不想让appium每次都自动启动app, 而是想自己打开activity或者在原来activity基础上继续操作,可以方便使用此项
-
但是device[‘appPackage’]和device[‘appActivity’]不能省略
-
启动app
driver.launch_app()
-
关闭app
driver.close_app()
-
重置app
driver.reset()
: 清除设置以后启动或重启 App -
自己启动 activity
driver.start_activity('包名','Activity页面名')
-
在已经打开的Activity页面继续操作
-
-
查看当前的App类型/上下文
driver.contexts
-
查看当前的app类型/上下文
driver.current_context
-
切换到指定app类型/上下文
driver.switch_to.context("app名")
-