[开发测试]APP移动端测试高级（二）

八、APP元素事件操作API

8.1. 前置代码

from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'

# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)

8.2. 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)
  

8.3. 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)
  

8.4. 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)
  

8.5. 应用置于后台事件

APP放置后台，模拟热启动

• 方法：background_app(seconds)
• 参数：
  1.seconds:停留在后台的时间，单位：秒
• 业务场景：
  1.进入设置页
  2.将APP置于后台5s
• 代码实现：

  driver.background_app(5)
  

• 效果：

  app置于后台5s后，再次展示当前页面
  

九、APP模拟手势高级操作

TouchAction是AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等，原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行。

9.1. 前置代码

from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'

# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)

?? 所有手势都要通过执行函数才会运行.

9.2. 手指轻敲操作

模拟手指轻敲一下屏幕操作

• 方法：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()
  

9.3. 手指按操作

模拟手指按下屏幕,按就要对应着离开.

• 方法: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()
  

9.4. 等待操作

• 方法：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()
  

9.5. 手指长按操作

模拟手机按下屏幕一段时间,按就要对应着离开.

• 方法：long_press(el=None, x=None, y=None, duration=1000)
• 参数：
  1.element：被定位到的元素
  2.x：通常会使用元素的X轴坐标
  3.y：通常会使用元素的Y轴坐标
  4.duration：持续时间，默认为1000ms
• 代码实现：

  # 点击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()
  

9.6. 手指移动操作

模拟手机的滑动操作

• 方法：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()
  

十、手机操作API

针对手机的一些常用设置功能进行操作.

10.1. 前置代码

from appium import webdriver
# server 启动参数
desired_caps = {}
# 设备信息
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# app的信息
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'

# 声明我们的driver对象
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)

10.2. 获取手机时间

• 方法：device_time
• 代码实现：

  # 获取当前手机的时间
  print(driver.device_time)
  

• 执行结果：

  Wed Dec 27 08:52:45 EST 2017
  

10.3. 获取手机的宽高

获取手机的宽高，可以根据宽高做一些坐标的操作

• 方法：get_window_size()
• 代码实现：

print(driver.get_window_size())

• 执行结果：

{'height': 800, 'width': 480}

10.4. 发送键到设备

模拟系统键值的操作，比如操作home键，音量键,返回键等。

• 参数：
  keycode：发送给设备的关键代码
  metastate：关于被发送的关键代码的元信息，一般为默认值
• 业务场景:
  1.打开设置
  2.按多次音量增加键
• 代码实现：

  for i in range(3):
      driver.keyevent(24)
  

Appium---Android的keycode键值

adb命令使用
adb shell input keyevent XX(EventCode) #输入对应的键值
adb shell input text "www.baidu.com"?#向浏览器发送文本

10.5. 操作手机通知栏

打开手机的通知栏，可以获取通知栏的相关信息和元素操作

• 方法：open_notifications()
• 业务场景:
  1.启动设置
  2.打开通知栏
• 代码实现：

driver.open_notifications()

10.6. 获取手机当前网络

获取手机当前连接的网络

• 方法：network_connection
• 业务场景：获取手机当前网络模式
• 代码实现：

print(driver.network_connection)

• 执行结果：

6

10.7. 设置手机网络

更改手机的网络模式，模拟特殊网络情况下的测试用例

• 方法：set_network_connection(connectionType)
• 参数：
  connectionType：需要被设置成为的网络类型
• 业务场景：
  1.启动设置
  2.设置手机网络为飞行模式
• 代码实现：

driver.set_network_connection(1)

10.8. 手机截图

截取手机当前屏幕，保存指定格式图片到设定位置

• 方法：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文件

十一、脚本录制

11.1. 认识界面

11.2. 点击开始录制按键开始录制脚本

1. 点击顶部导航栏左侧第一个“选择元素”按键选定搜索栏，然后点击右边点“点击”按键进行操作（录制过程就是先选择录制窗口左边的APP元素，然后录制窗口右边的操作方式）。

2. 录制完成后点击“停止录制”按键，录制窗口右上角会同步显示操作代码，选择代码类型，将模板代码转换成正式代码，复制代码到Pycharm。

3. 代码复制到pycharm后，最好是在每个操作或者页面切换处加上等待时间，否则会因为网速、APP设计问题或者其他原因，无法及时到达下一个页面，导致APPIUM无法获取页面元素而定位元素失败，在pycharm运行时报错。代码编辑好后点击pycharm的运行按键，APPium就会在手机上面自动运行脚本了。