一。前置代码
1.导入driver对象
from appium import webdriver
2.声明手机驱动对象
只有声明驱动对象我们才可以让手机完成脚本的操作
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps) # 声明对象后会直接启动参数中的应用
3.手机启动参数
desired_caps:负责启动服务端时的参数设置,appium server 与手机端建立会话关系时,根据这些参数服务端可以做出相应的处理
desired_caps常用参数:
platformName 平台的名称:iOS, Android, or FirefoxOS
platformVersion 设备系统版本号
deviceName 设备号 IOS:instruments -s devices,Android: adb devices
app 安装文件路径:/abs/path/to/my.apk or http://myapp.com/app
appActivity 启动的Activity
appPackage 启动的包
unicodeKeyboard unicode设置(允许中文输入)
resetKeyboard 键盘设置(允许中文输入)
二。基础API
1.脚本内启动其他app
driver.start_activity(appPackage,appActivity)
2.安装APK到手机
driver.install_app(app_path)
参数:
app_path:脚本机器中APK文件路径
3.手机中移除APP
driver.remove_app(app_id)
参数:
app_id:需要卸载的app包名
4.判断APP是否已安装
driver.is_app_installed(bundle_id)
参数:
bundle_id: 可以传入app包名,返回结果为True(已安装) / False(未安装)
5.发送文件到手机
import base64
data = str(base64.b64encode(data.encode('utf-8')),'utf-8')
driver.push_file(path,data)
参数:
path:手机设备上的路径(例如:/sdcard/a.txt)
data:文件内数据,要求base64编码
Python3.x中字符都为unicode编码,而b64encode函数的参数为byte类型,需要先转码;
生成的数据为byte类型,需要将byte转换回去。
6.从手机中拉取文件
import base64
data = driver.pull_file(path) # 返回数据为base64编码
print(str(base64.b64decode(data),'utf-8')) # base64解码
参数:
path: 手机设备上的路径
7.获取当前屏幕内元素结构
driver.page_source
作用:
返回当前页面的文档结构,判断特定的元素是否存在
8.uiautomatorviewer
进入J:installsdk-tools-windows-4333796 oolsin打开uiautomatorviewer.bat直接运行
用来扫描和分析Android应用程序的UI控件的工具.安装后和机器人连接可获取控件的ID
,class,text,坐标等信息
如何点击坐标进入机器人界面上的一个功能:
先用ui工具找下坐标,然后输入adb shell input tap 1418 46(坐标)可进入这个按钮
-
(1)通过id定位
-
方法:find_element_by_id(id_value) # id_value:为元素的id属性值
业务场景: 1.进入设置页面 2.通过ID定位方式点击搜索按钮
代码实现: driver.find_element_by_id("com.android.settings:id/search").click() driver.quit()
-
(2)通过class定位
方法:find_element_by_class_name(class_value) # class_value:为元素的class属性值
业务场景:
1.进入设置页面
2.点击搜索按钮
3.通过class定位方式点击输入框的返回按钮
代码实现:
# id 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search").click()
# class 点击输入框返回按钮
driver.find_element_by_class_name('android.widget.ImageButton').click()
driver.quit()
-
(3)通过xpath定位
方法:find_element_by_xpath(xpath_value) # xpath_value:为可以定位到元素的xpath语句
*** android端xptah常用属性定位: 1. id ://*[contains(@resource-id,'com.android.settings:id/search')] 2. class ://*[contains(@class,'android.widget.ImageButton')] 3. text ://*[contains(@text,'WLA')] *** 模糊定位 contains(@key,value): value可以是部分值
业务场景:
1.进入设置页面
2.点击WLAN菜单栏
代码实现:
# xpath 点击WLAN按钮
driver.find_element_by_xpath("//*[contains(@text,'WLA')]").click()
- (4)定位一组元素,注意element -> elements
应用场景为元素值重复,无法通过元素属性直接定位到某个元素,只能通过elements方式来选择,返回一个定位对象的列表.
- (5)通过id方式定位一组元素
方法: find_elements_by_id(id_value) # id_value:为元素的id属性值
业务场景:
1.进入设置页面
2.点击WLAN菜单栏(id定位对象列表中第1个)
代码实现:
# 定位到一组元素
title = driver.find_elements_by_id("com.android.settings:id/title")
# 打印title类型,预期为list
print(type(title))
# 取title返回列表中的第一个定位对象,执行点击操作
title[0].click()
- (6)通过class方式定位一组元素
方法:find_elements_by_class_name(class_value) # class_value:为元素的class属性值
业务场景:
1.进入设置页面
2.点击WLAN菜单栏(class定位对象列表中第3个)
代码实现:
# 定位到一组元素
title = driver.find_elements_by_class_name("android.widget.TextView")
# 打印title类型,预期为list
print(type(title))
# 取title返回列表中的第一个定位对象,执行点击操作
title[3].click()
- (7)通过xpath方式定位一组元素
方法:find_elements_by_xpath(xpath_value) # xpath_value:为可以定位到元素的xpath语句
业务场景:
1.进入设置页面
2.点击WLAN菜单栏(xpath中class属性定位对象列表中第3个)
代码实现:
# 定位到一组元素
title = driver.find_elements_by_xpath("//*[contains(@class,'widget.TextView')]")
# 打印title类型,预期为list
print(type(title))
# 取title返回列表中的第一个定位对象,执行点击操作
title[3].click()
9.WebDriverWait 显示等待操作
在一个超时时间范围内,每隔一段时间去搜索一次元素是否存在,
如果存在返回定位对象,如果不存在直到超时时间到达,报超时异常错误。
方法:WebDriverWait(driver, timeout, poll_frequency).until(method)
参数:
1.driver:手机驱动对象
2.timeout:搜索超时时间
3.poll_frequency:每次搜索间隔时间,默认时间为0.5s
4.method:定位方法(匿名函数)
匿名函数:
lambda x: x
等价于python函数:
def test(x):
return x
使用示例:
WebDriverWait(driver, timeout, poll_frequency).until(lambda x: x.find_elements_by_id(id_value))
解释:
1.x传入值为:driver,所以才可以使用定位方法.
函数运行过程:
1.实例化WebDriverWait类,传入driver对象,之后driver对象被赋值给WebDriverWait的一个类变量:self._driver
2.until为WebDriverWait类的方法,until传入method方法(即匿名函数),之后method方法会被传入self._driver
3.搜索到元素后until返回定位对象,没有搜索到函数until返回超时异常错误.
业务场景:
1.进入设置页面
2.通过ID定位方式点击搜索按钮
代码实现:
from selenium.webdriver.support.wait import WebDriverWait # 导入WebDriverWait类
# 超时时间为30s,每隔1秒搜索一次元素是否存在,如果元素存在返回定位对象并退出
search_button = WebDriverWait(driver, 30, 1).until(lambda x: x.find_elements_by_id(com.android.settings:id/search))
search_button.click()
driver.quit()
-
10.发送数据到输入框
方法:send_keys(vaue) # value:需要发送到输入框内的文本
业务场景: 1.打开设置 2.点击搜索按钮 3.输入内容abc
代码实现:
# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search").click()
# 定位到输入框并输入abc
driver.find_element_by_id("android:id/search_src_text").send_keys("abc")
重点:
大家可以将输入的abc 改成 输入中文,得到的结果:输入框无任何值输入且程序不会抱错
解决输入中文问题:
1.server 启动参数增加两个参数配置
desired_caps['unicodeKeyboard'] = True
desired_caps['resetKeyboard'] = True
2.再次运行会发现运行成功
# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search").click()
# 定位到输入框并输入abc
driver.find_element_by_id("android:id/search_src_text").send_keys("传智播客")
-
11.清空输入框内容
方法:clear()
业务场景: 1.打开设置 2.点击搜索按钮 3.输入内容abc 4.删除已输入abc
代码实现: # 点击搜索按钮 driver.find_element_by_id("com.android.settings:id/search").click() # 定位到输入框并输入abc input_text = driver.find_element_by_id("android:id/search_src_text") # 输入abc input_text.send_keys("abc") time.sleep(1) # 删除abc input_text.clear()
-
12.获取元素的文本内容
方法: text
业务场景: 1.进入设置 2.获取所有元素class属性为“android.widget.TextView”的文本内容
代码实现: text_vlaue = driver.find_elements_by_class_name("android.widget.TextView") for i in text_vlaue: print(i.text) 执行结果: 设置 无线和网络 WLAN 更多 设备 显示 提示音和通知 存储
- 13..获取元素的属性值
方法: get_attribute(value) # value:元素的属性 ⚠️ value='name' 返回content-desc / text属性值 ⚠️ value='text' 返回text的属性值 ⚠️ value='className' 返回 class属性值,只有 API=>18 才能支持 ⚠️ value='resourceId' 返回 resource-id属性值,只有 API=>18 才能支持
业务场景: 1.进入设置 2.获取搜索按钮的content-desc属性值
代码实现: # 定位到搜索按钮 get_value = driver.find_element_by_id("com.android.settings:id/search") print(get_value.get_attribute("name")) 执行结果: 搜索
- 14..获取元素在屏幕上的坐标
方法:location
业务场景: 1.进入设置页面 2.获取搜索按钮在屏幕的坐标位置
代码实现: # 定位到搜索按钮 get_value = driver.find_element_by_id("com.android.settings:id/search") # 打印搜索按钮在屏幕上的坐标 print(get_value.location) 执行结果: {'y': 44, 'x': 408}
- 15.获取app包名和启动名
获取包名方法:current_package 获取启动名:current_activity
业务场景: 1.启动设置 2.获取包名和启动名
代码实现: print(driver.current_package) print(driver.current_activity) 执行结果: com.tencent.news .activity.SplashActivity
-
16.swip滑动事件
⚠️从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动 方法:swipe(start_x, start_y, end_x, end_y, duration=None) 参数: 1.start_x:起点X轴坐标 2.start_y:起点Y轴坐标 3.end_x: 终点X轴坐标 4.end_y,: 终点Y轴坐标 5.duration: 滑动这个操作一共持续的时间长度,单位:ms
业务场景: 1.进入设置 2.从坐标(148,659)滑动到坐标(148,248)
代码实现: # 滑动没有持续时间 driver.swipe(188,659,148,248) # 滑动持续5秒的时间 driver.swipe(188,659,148,248,5000)
-
17.scroll滑动事件
⚠️ 从一个元素滑动到另一个元素,直到页面自动停止 方法:scroll(origin_el, destination_el) 参数: 1.origin_el:滑动开始的元素 2.destination_el:滑动结束的元素
业务场景: 1.进入设置页 2.模拟手指从存储菜单位置 到 WLAN菜单位置的上滑操作
代码实现: # 定位到存储菜单栏 el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]") # 定位到WLAN菜单栏 el2 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") # 执行滑动操作 driver.scroll(el1,el2)
- 18.drag拖拽事件
⚠️ 从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置 方法:drag_and_drop(origin_el, destination_el) 参数: 1.origin_el:滑动开始的元素 2.destination_el:滑动结束的元素
业务场景: 1.进入设置页 2.模拟手指将存储菜单 滑动到 WLAN菜单栏位置
代码实现: # 定位到存储菜单栏 el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]") # 定位到WLAN菜单栏 el2 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") # 执行滑动操作 driver.drag_and_drop(el1,el2)
- 19..应用置于后台事件
APP放置后台,模拟热启动 方法:background_app(seconds) 参数: 1.seconds:停留在后台的时间,单位:秒
业务场景: 1.进入设置页 2.将APP置于后台5s
代码实现: driver.background_app(5) 效果: app置于后台5s后,再次展示当前页面
-
20.手指轻敲操作
模拟手指轻敲一下屏幕操作 方法:tap(element=None, x=None, y=None) 方法:perform() # 发送命令到服务器执行操作 参数: 1.element:被定位到的元素 2.x:相对于元素左上角的坐标,通常会使用元素的X轴坐标 3.y:通常会使用元素的Y轴坐标
业务场景: 1.进入设置 2.点击WLAN选项
代码实现: # 通过元素定位方式敲击屏幕 el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") TouchAction(driver).tap(el).perform() # 通过坐标方式敲击屏幕,WLAN坐标:x=155,y=250 # TouchAction(driver).tap(x=155,y=250).perform()
-
21.手指按操作
模拟手指按下屏幕,按就要对应着离开.
方法:press(el=None, x=None, y=None) 方法:release() # 结束动作,手指离开屏幕 参数: 1.element:被定位到的元素 2.x:通常会使用元素的X轴坐标 3.y:通常会使用元素的Y轴坐标
业务场景: 1.进入设置 2.点击WLAN选项
代码实现: # 通过元素定位方式按下屏幕 el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]") TouchAction(driver).press(el).release().perform() # 通过坐标方式按下屏幕,WLAN坐标:x=155,y=250 # TouchAction(driver).press(x=155,y=250).release().perform()
-
22.等待操作
方法:wait(ms=0) 参数: ms:暂停的毫秒数
业务场景: 1.进入设置 2.点击WLAN选项 3.长按WiredSSID选项5秒
代码实现: # 点击WLAN driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click() # 定位到WiredSSID el =driver.find_element_by_id("android:id/title") # 通过元素定位方式长按元素 TouchAction(driver).press(el).wait(5000).perform() # 通过坐标方式模拟长按元素 # 添加等待(有长按)/不添加等待(无长按效果) # TouchAction(driver).press(x=770,y=667).wait(5000).release().perform()
-
23.手指长按操作
模拟手机按下屏幕一段时间,按就要对应着离开.
方法:long_press(el=None, x=None, y=None, duration=1000) 参数: 1.element:被定位到的元素 2.x:通常会使用元素的X轴坐标 3.y:通常会使用元素的Y轴坐标 4.duration:持续时间,默认为1000ms
业务场景: 1.进入设置 2.点击WLAN选项 3.长按WiredSSID选项5秒
代码实现: # 点击WLAN driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click() # 定位到WiredSSID el =driver.find_element_by_id("android:id/title") # 通过元素定位方式长按元素 TouchAction(driver).long_press(el,duration=5000).release().perform() # 通过坐标方式长按元素,WiredSSID坐标:x=770,y=667 # 添加等待(有长按)/不添加等待(无长按效果) # TouchAction(driver).long_press(x=770,y=667).perform()
- 24.手指移动操作
模拟手机的滑动操作 方法:move_to(el=None, x=None, y=None) 参数: 1.el:定位的元素 2.x:相对于前一个元素的X轴偏移量 3.y:相对于前一个元素的Y轴偏移量
业务场景1: 1.进入设置 2.向上滑动屏幕
代码实现:
# 定位到存储
el = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到更多
el1 = driver.find_element_by_xpath("//*[contains(@text,'更多')]")
# 元素方式滑动
TouchAction(driver).press(el).move_to(el1).release().perform()
# 坐标的方式滑动
# TouchAction(driver).press(x=240,y=600).wait(100).move_to(x=240,y=100).release().perform()
# 注意press连接一个move_to实际调用的是swip方法,可在log中查询,不要给相对坐标。
业务场景2:
1.进入设置
2.向上滑动屏幕到可见"安全"选项
3.进入到安全
4.点击屏幕锁定方式
5.点击图案
6.绘制图案
代码实现:
# 定位到WLAN
el1 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 定位到存储
el2 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 存储上滑到WLAN
driver.drag_and_drop(el2,el1)
# 定位到用户
el3 = driver.find_element_by_xpath("//*[contains(@text,'用户')]")
# 注意 这次使用drag_and_drop方法,传入的"存储定位"仍使用其原始在屏幕上的位置,所以是由存储滑动到用户才可以上滑,否则需要重新"定位存储"
# 存储上滑倒用户位置
driver.drag_and_drop(el2,el3)
# 点击安全按钮
driver.find_element_by_xpath("//*[contains(@text,'安全')]").click()
# 点击屏幕锁定方式按钮
driver.find_element_by_xpath("//*[contains(@text,'屏幕锁定')]").click()
# 点击图案按钮
driver.find_element_by_xpath("//*[contains(@text,'图案')]").click()
# 绘制图案四个坐标 1:(244,967) 2:(723,967) 3:(723,1442) 4:(244,1916)
TouchAction(driver).press(x=244,y=967).wait(100).move_to(x=479,y=0).wait(100)
.move_to(x=0,y=475).wait(100).move_to(x=-479,y=474).release().perform()
- 25.获取手机时间
方法:device_time
代码实现: # 获取当前手机的时间 print(driver.device_time) 执行结果: Wed Dec 27 08:52:45 EST 2017
- 26.获取手机的宽高
获取手机的宽高,可以根据宽高做一些坐标的操作
方法:get_window_size()
代码实现: print(driver.get_window_size()) 执行结果: {'height': 800, 'width': 480}
- 27.发送键到设备
模拟系统键值的操作,比如操作honme键,音量键,返回键等。
方法:keyevent(keycode, metastate=None): 参数: keycode:发送给设备的关键代码 metastate:关于被发送的关键代码的元信息,一般为默认值
业务场景: 1.打开设置 2.按多次音量增加键
代码实现: for i in range(3): driver.keyevent(24)
- 28.操作手机通知栏
打开手机的通知栏,可以获取通知栏的相关信息和元素操作
方法:open_notifications()
业务场景: 1.启动设置 2.打开通知栏
代码实现: driver.open_notifications()
- 29.获取手机当前网络
获取手机当前连接的网络
方法:network_connection
业务场景: 获取手机当前网络模式
代码实现: print(driver.network_connection) 执行结果: 6
- 30.设置手机网络
更改手机的网络模式,模拟特殊网络情况下的测试用例
方法:set_network_connection(connectionType) 参数: connectionType:需要被设置成为的网络类型
业务场景: 1.启动设置 2.设置手机网络为飞行模式
代码实现: driver.set_network_connection(1)
- 31.手机截图
截取手机当前屏幕,保存指定格式图片到设定位置
方法:get_screenshot_as_file(filename) 参数: filename:指定路径下,指定格式的图片.
业务场景: 1.打开设置页面 2.截图当前页面保存到当前目录,命名为screen.png
代码实现: import os driver.get_screenshot_as_file(os.getcwd() + os.sep + './screen.png') 执行结果: 当前目录下会生成screen.png文件
三。后置代码
1.关闭appdriver.close_app() # 关闭当前操作的app,不会关闭驱动对象
关闭驱动对象
2.driver.quit() # 关闭驱动对象,同时关闭所有关联的app
四:自己写实例:
1.先单独创建前置函
#导入driver对象.驱动对象会帮助我们完成手机和脚本之间交互. from appium import webdriver def init_driver(): desired_caps = {}#先定义个字典变量,给下面调用 desired_caps['platformName'] = 'Android' #平台的名称:iOS, Android, or FirefoxOS desired_caps['platformVersion'] = '4.4.4' #设备系统版本号 desired_caps['deviceName'] = 'KMO3EHB90R' #设备号 IOS:instruments -s devices,Android: adb devices desired_caps['appPackage'] = 'com.avatar.settings'#启动的Activity desired_caps['appActivity'] = '.Settings' #启动的包 desired_caps['unicodeKeyboard'] = True #unicode设置(允许中文输入) desired_caps['resetKeyboard'] = True #键盘设置(允许中文输入) #脚本和服务端关联,使用webdriver.Remote的方法,并传2个参数,服务端的地址和服务端需要的启动参数 driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub',desired_caps) return driver
2.简单调用函数
from 手机自动化.init_driver.Init_Driver import init_driver #先导入,下面还要调用 def opensetting(): driver = init_driver() driver.quit() #直接使用退出方法 if __name__ == '__main__':#if name == 'main':下的代码只有直接作为脚本才会被执行,导入到其他代码下不能执行 opensetting()
3.基础API
#导入driver对象.驱动对象会帮助我们完成手机和脚本之间交互. from appium import webdriver #先定义个字典变量,给下面调用 desired_caps = {} desired_caps['platformName'] = 'Android' #平台的名称:iOS, Android, or FirefoxOS desired_caps['platformVersion'] = '4.4.4' #设备系统版本号 desired_caps['deviceName'] = 'KMO3EHB90R' #设备号 IOS:instruments -s devices,Android: adb devices desired_caps['appPackage'] = 'com.avatar.settings'#启动的Activity desired_caps['appActivity'] = '.Settings' #启动的包 desired_caps['unicodeKeyboard'] = True #unicode设置(允许中文输入) desired_caps['resetKeyboard'] = True #键盘设置(允许中文输入) #脚本和服务端关联,使用webdriver.Remote的方法,并传2个参数,服务端的地址和服务端需要的启动参数 driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub',desired_caps) # 关闭当前操作的app,不会关闭驱动对象driver driver.close_app() #安装app import os #判断APP是否已安装 driver.is_app_installed(bundle_id) bundle_id: 可以传入app包名,返回结果为True(已安装) / False(未安装) print("检查是否已经安装成功:",driver.is_app_installed("com.avatarmind.ipal")) if driver.is_app_installed("com.avatarmind.ipal"): print("ipal存在,开始卸载") driver.remove_app("com.avatarmind.ipal") else: print("ipal不存在,开始安装") os.system("adb install D:pp.apk") print("安装成功再次卸载") driver.remove_app("com.avatarmind.ipal") #发送文件到手机(创建push.txt并添加内容12345678) import base64 data = str(base64.b64encode("push 123456789".encode('utf-8')),'utf-8') driver.push_file("/sdcard/push.txt",data) #从手机中拉取文件 data = driver.pull_file("/sdcard/push.txt") print(str(base64.b64decode(data),'utf-8')) #启动app,并获取当前屏幕内元素结构来判断是否进入成功 driver.start_activity("com.avatar.settings",".Settings") current_page_data = driver.page_source for i in ("系统设置","蓝牙"): if i in current_page_data: print("进入页面成功") else: print("失败咯") driver.quit()#关闭驱动对象,同时关闭所有关联的app
4.ui定位API
注意点:使用前置函数打开设置后总是会打开一个窗口提示是否创建密码,打开ui工具后无法定位,后找到解决方法是,需要关闭该app,重新开启