Appium是一款开源的自动化测试工具,其支持iOS和安卓平台上的原生的,基于移动浏览器的,混合 的应用。Appium在不同平台中使用了标准的自动化APIs,所以在跨平台时,不需要重新编译或者修改 自己的应用。Appium支持Selenium WebDriver支持的所有语言,如java、Object-C、JavaScript、 Php、Python、Ruby、C#、,或者Perl语言,更可以使用Selenium WebDriver的Api。Appium支持任何一种测试框架.Appium实现了真正的跨平台自动化测试。
appium 是一个node.js 编写的http server ,它的创建、并管理多个webDriver sessiion 来和不同平台交互,如ios,Android等等,appium 开始一个测试后,就会在被测设备(手机)上启动一个server,监听来自appium server 的指令,每种平台ios 和android 都有不同的运行、和交互方式。4所以appiium会用某个桩程序 入侵该平台,并接受指令,来完成测试用例的运行
2.appium 的工作原理
client端发送自动化指令给appium server ,appium server 接收到client发送的指令后,转换为移动端能够识别的指令,然后发送给移动端设备,并对移动端设备进行操作。
工作流程,脚本请求--->4723端口appium server --->解析参数给pc端4724端口---->发送给设备4724端口---->通过设备4724端口发给bootstrap.jar --->bootstrap.jar把命令发给 uiautomator
注意:bootstrap.jar:是push到android手机上的一个应用程序,主要是接受appium server的执行并且运行这些测试指令。而指令的执行正式通过UIAutomator来驱动
1.安装jdk
下载好后点击进行安装。安装好后进行环境变量的配置
打开计算机-》系统属性-》高级系统设置-》环境变量-》新建(系统变量),如图所示:
配置JAVA_HOME C:\Program Files\Java\jdk\jdk1.8.0_91(根据自己的安装磁盘决定盘符)
配置Path: ;%JAVA_HOME%/bin;%JAVA_HOME%/jre/bin; 追加进Path中;
配置CLASSPATH .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
验证:
验证一下JDK的环境是否配置好,win+r 输入cmd进入dos下输入java -version检查环境是否配置成 功。
安装 Android sdk ---安装步骤类似jdk,不在赘述
验证:
建议使用我提供下载的6.9.4版本,类似jdk,不再赘述
验证:
下载:AppiumForWindows_1_4_16_1.zip
验证:
cmd打开命令行窗口,输入appium-doctor ,出现以下提示,All Checks were successful ,说明环境 配置成功
appium-pytho-client 目的是需要将python 与appium 关联起来,首先要安装python3.x ,进行环境配置。配置的默认环境是本地的python 环境,如果后期使用pycharm的虚拟环境,这需要在虚拟环境中再次安装。
在需要的环境下,输入:pip install Appium-Python-Client==1.3.0,(此处需要配合appium版本使 用,所以需要指定版本安装)提示成功就可以了,我这边是已经安装过了。同时selenium的包要指定安 装4.8.0,安装命令:pip install selenium==4.8.0
验证 :出现successfully,就安装成功。
1.appium 已经启动
双击该软件appium-desktop,启动appium服务器
点击start server,启动appium服务器
看到以上图形,代表服务启动成功
adb命令进行连接模拟器
命令:adb connect 127.0.0.0.1:port
端口号:逍遥安卓模拟器:21503
安卓真机,需要在设置里面进入关于手机,里面连击版本号,会提示手机已进入开发者模式,在回到设 置中查找开发者选项,开启USB调试,再次通过数据线连接手机即可。(如果提示手机连接模式,应该 选择文件传输,不能选择仅充电)连接成功后,可以使用adb devices查看,如图:
将目标apk安装到目标机器上,如果是模拟器,如下图
四、启动目标app
此处我们以模拟器上的今日头条的apk为例 代码如下:
代码如下:
import time
from appium import webdriver
def startUp():
print("启动中")
#启动参数设置dict数据格式
desire_caps = {
#通过adb devices获取,此处是模拟器所以填写的是ip和port
"deviceName": "127.0.0.1:21503",
# 使用哪个移动操作系统平台
"platformName": "Android",
# 使用移动操作平台的版本
"platformVersion": "5.1.1",
# app的包名,通过aapt dumpsys bading xxx.apk获取
"appPackage": "com.ss.android.article.news",
"appActivity": "com.ss.android.article.news.activity.MainActivity",
"noReset": True,
"unicodeKeyboard": True
# "autoLaunch": False
}
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub',desire_caps)
print("启动成功,等待6s关闭")
time.sleep(6)
#智能等待
driver.implicitly_wait(1)
time.sleep(4)
driver.quit()
if __name__ == '__main__':
startUp()
报错:
ValueError: Timeout value connect was
其实是selenium版本和urllib3版本不兼容问题。更换urllib3版本:
pip uninstall urllib3
pip install urllib3==1.26.2
也可以更换selenium版本,参考以下文章:
https://blog.csdn.net/qq_48302722/article/details/130861992
参数 | 描述 | 值 |
appPackage | App的包名,通过aapt dumpsys badging xxx.apk获取 |
例如:'appPackage': 'com.jyibb.shell_customer', |
platformName | 使用哪个移动操作系统平台 | 例如:'platformName': 'Android' |
platformVersion | 移动操作系统版本 | 例如:'platformVersion': '5.1' |
deviceName | 使用的移动设备或模拟器的名称,通过adb devices获取 | 例如:'deviceName':'8TB6V4ZPZ54LPJ5P' |
app | 如果为第一次启动则需要 通过该参数指定app安装 包的位置,一般为绝对路径 |
例如:'app': ‘D:\shell_customer-debug.apk' |
newCommandTimeout | 在假定客户端退出并结束 会话之前,Appium将等 待来自客户端的新命令 (以秒为单位) |
例如 60 |
appActivity | 通过aapt dumpsys badging xxx.apk获取 |
例如 appActivity': 'com.jyibb.module_launch_customer.SplashActivity', |
udid | 连接的物理设备的唯一设 备标识符,此参数为ios 特有参数 |
例如 :'udid':'1ae203187fc012g' |
noReset | 在此会话之前不要重置应 用程序状态。 | true, false |
fullReset | 执行完整的重置 | true, false |
unicodeKeyboard | 解决输入中文的问题,否 则不能用sendkeys输入 中文 | 例如, ‘unicodeKeyboard':'True' |
resetKeyboard | 将键盘隐藏起来,默认 true | true, false |
autolunch | Appium是否要自动启动 或安装app | 默认true ,该参数在设计框架时开启了lunchapp方法 后使用可以避免每次第一个用例失败 |
automationName | UiAutomator2 | 有些手机定位不到元素,或调不动时,可以使用此参数 |
注意: "udid":设备唯一标识,通过adb devices获取,显示的设备标识,如果当前连接了多台设备,可以通过 此参数区分要启动的设备,安卓的deviceName不会校验正确性(可以随便写),ios必须校验 系统版本:打开模拟器里面的设置,查看系统版本即可,类似手机操作系统,如下图
appPackage和appActivity获取:
1、 将目标apk放在一个已知目录下
2、 进入该目录的dos环境,输入以下命令
aapt dump badging jinritoutiao.apk |findstr package ----用来查看package
aapt dump badging jinritoutiao.apk |findstr activity ----用来查看activity
如果是linux或者mac 则把findstr换成grep
aapt dump badging d:\xxx.apk #获取安装包的所有信息
adb devices(查看手机是否连接到电脑,可以看到设备名称)
adb shell 可以进入默认连接设备的linux环境
如果不想进入linux环境好需要输入命令进行操作的话可以通过一下方式:
adb shell ls -l(shell后直接跟命令)
如果是连接了多台设备,可以通过adb -s 127.0.0.1:21503 shell来进入指定设备的linux环境
adb shell pm list packages 列出所有的包名
adb shell dumpsys package com.android.xxx:查看某个包的具体信息
adb logcat | grep xxx:查看当前app的日志并过滤关键字
自动化测试用例的实现
以今日头条发微头条为例
手工执行用例的步骤:
前提:启动头条app,且是登录状态
1- 打开首页,点击发表按钮
2- 点击微头条,输入内容
3- 点击发布
4- 检查是否发表成功(数据库/页面)
1、 定位目标元素(坐标,元素属性),操作目标元素(点击,滑动,输入)
2、 定位目标元素(坐标,元素属性),操作目标元素(点击,滑动,输入)
3、 定位目标元素(坐标,元素属性),操作目标元素(点击,滑动,输入)
4、 断言(接口状态码,数据库字段,app页面)
1. uiautomator
Android SDK自带的一个工具,在sdk的tools目录下(一定关闭appium-desktop的自带的定位工具后打 开,否则连接不上模拟器/真机 )
找到sdk下的tools里面的uiautomatorviewer.bat
2. appium-desktop
优先使用desktop,启动appium-desktop,点击服务器右上角的查找按钮,界面如下
点击启动后:
3-monitor:Android SDK自带的一个工具,在tools目录下,此工具主要用来监控Android手机的运行情 况,比如线程、堆内存,日志输出、等等。
用法:driver.find_element(By.属性,'属性值'),传递两个参数:一个是定位属性,一个是该属性的值
1. 通过id定位 取resource-id的属性值,替换到xxx
driver.find_element(By.ID," xxxx ")
2. 通过class_name定位
取class的属性值,替换到xxx
driver.find_element(By.CLASS_NAME," xxxx ")
3. 通过xpath定位 取xpath的属性值,替换到xxx
driver.find_element(By.XPATH," xxxx ")
4. 通过link_text定位 取text属性值,替换到xxx
写法一:
driver.find_element(By.LINK_TEXT," xxxx ")
写法二:
driver.find_element_by_android_uiautomator("new UiSelector().text(\"+关注
\")")
5. 通过css_selector定位(webview)
driver.find_element(By.CSS_SELECTOR,"XXXX")
6. 通过name定位(webview) web view容器中的html页面可以用name定位,native并没有name属性
driver.find_element(By.NAME," xxxx ")
方法:find_elements
用法:与find_element方式一致,但是返回一个数组。可以通过数组的索引来访问具体的某个结果 例如:通过ID定位到多个元素,我想点击第一个元素
driver.find_elements(By.ID,"xxxxx")[0].click()
# 或采用以下写法
list1 = driver.find_elements(By.ID,"xxxxx")
list1[0].click()
找到元素后可以对元素进行的操作
1. click() 点击操作,也可以用tab实现点击操作
driver.find_element(By.ID," xxxx ").click()
2. clear() 清空输入框内容
driver.find_element(By.ID," xxxx ").clear()
3. send_keys() 输入框内输入内容
driver.find_element(By.ID," xxxx ").send_keys("test content")
4. text 获得元素的text内容
result = driver.find_element(By.XPATH," xxxx").text
print(result)
5. get_attribute() 通过传入xx属性,获取xx属性值
driver.find_element(By.ID,' xxxx ').get_attribute('text')
6. size 获取元素的大小,得到一个字典如:{'height': 48, 'width': 640}
driver.find_element(By.ID,' xxxx ').size