App基础操作API

完成app自动化需要一些基础条件的支持，本节将讲解APP初始化API.
3.1.1前置代码

server 启动参数

desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
desired_caps['unicodeKeyboard'] = True
desired_caps['resetKeyboard'] = True

声明driver对象

driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
3.1.2安装APK到手机
driver.install_app(app_path)
参数：
app_path：脚本机器中APK文件路径
3.1.3手机中移除APP
driver.remove_app(app_id)
参数：
app_id：需要卸载的app包名
3.1.4判断APP是否已安装
driver.is_app_installed(bundle_id)
参数：
bundle_id: 可以传入app包名,返回结果为True(已安装) / False(未安装)
3.1.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转换回去。
3.1.6从手机中拉取文件
import base64
data = driver.pull_file(path) # 返回数据为base64编码
print(str(base64.b64decode(data),'utf-8')) # base64解码
参数：
path: 手机设备上的路径
3.1.7获取当前屏幕内元素结构
driver.page_source
作用：
返回当前页面的文档结构，判断特定的元素是否存在

手机控件查看工具uiautomatorviewer

• 工具简介

    用来扫描和分析Android应用程序的UI控件的工具.
  
  

• 如何使用

    1.进入SDK目录下的tools目录，打开uiautomatorviewer

    2.电脑连接真机或打开android模拟器

    3.启动待测试app

    4.点击uiautomatorviewer的左上角Device Screenshot,会生成app当前页面的UI控件截图

我是在bin目录下

image.png

    5.选择截图上需要查看的控件，即可浏览该控件的id,class,text,坐标等信息

image.png

.APP元素定位操作
手工测试主要通过可见按钮操作，而自动化是通过元素进行交互操作.
⚠️⚠️⚠️ 元素的基本定位基于当前屏幕范围内展示的可见元素。
3.3.1Appium常用元素定位方式
name value
id id属性值
class class属性值
xpath xpath表达式
3.3.2.前置代码

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)

3.3.3.通过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()
3.3.4.通过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.3.5.通过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()
3.3.6.定位一组元素,注意element -> elements
应用场景为元素值重复，无法通过元素属性直接定位到某个元素，只能通过elements方式来选择，返回一个定位对象的列表.
3.3.7.通过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()
3.3.8.通过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()
3.3.9.通过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()
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 driver: driver.find_element_by_id("com.android.settings:id/search"))
search_button.click()
driver.quit()