day06--appium

Appium入门的第一个例子

手机驱动对象

驱动对象会帮助我们完成手机和脚本之间交互.

导入driver对象

from appium import webdriver

声明手机驱动对象

只有声明驱动对象我们才可以让手机完成脚本的操作,声明的方法如下:

driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps) # 声明对象后会直接启动参数中的应用

desired_caps: ？？？

手机启动参数

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                  键盘设置(允许中文输入)

#server   启动参数
caps = {}
caps["platformName"] = "Android"
caps["deviceName"] = "127.0.0.1:62001"
caps["appPackage"] = "com.android.settings"
caps["appActivity"] = "com.android.settings.Settings
caps['unicodeKeyboard'] = True
caps['resetKeyboard'] = True

脚本内启动其他app

driver.start_activity(appPackage,appActivity)

关闭app

driver.close_app() # 关闭当前操作的app，不会关闭驱动对象

关闭驱动对象

driver.quit() # 关闭驱动对象，同时关闭所有关联的app

实例代码

Appium常用元素定位方式

 前置代码

from appium import webdriver

caps = {}
# 设备信息
caps["platformName"] = "Android"
caps["deviceName"] = "127.0.0.1:62001"
# app的信息
caps["appPackage"] = "com.android.settings"
caps["appActivity"] = "com.android.settings.Settings"
# 声明我们的driver对象
driver = webdriver.Remote("http://localhost:4723/wd/hub", caps)

通过id定位

方法：find_element_by_id(id_value) # id_value:为元素的id属性值

代码实现

driver.find_element_by_id("com.android.settings:id/search")

通过class定位

方法：find_element_by_class_name(class_value) # class_value:为元素的class属性值

 

通过xpath定位

方法：find_element_by_xpath(xpath_value) # xpath_value:为可以定位到元素的xpath语句

通过class方式定位一组元素

方法：find_elements_by_class_name(class_value) # class_value:为元素的class属性值

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

 1.点击元素
1.1.发送数据到输入框， 方法：send_keys(vaue) # value：需要发送到输入框内的文本
1.2清空输入框内容，方法：clear()

获取元素的文本内容：方法: text

 获取元素的属性值 ，方法: get_attribute(value) # value:元素的属性

 获取元素在屏幕上的坐标： 方法:location

 获取app包名和启动名
获取包名方法：current_package
获取启动名：current_activity

 APP元素事件操作：
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。

 scroll滑动事件：从一个元素滑动到另一个元素，直到页面自动停止；
方法：scroll(origin_el, destination_el)
参数：
1.origin_el：滑动开始的元素
2.destination_el：滑动结束的元素

 drag拖拽事件：从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置。
方法：drag_and_drop(origin_el, destination_el)
参数：
1.origin_el：滑动开始的元素
2.destination_el：滑动结束的元素

 应用置于后台事件： APP放置后台，模拟热启动。
方法：background_app(seconds)
参数：
seconds:停留在后台的时间，单位：秒

 APP模拟手势高级操作：
TouchAction是AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等，
原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行。
1：手指轻敲操作
模拟手指轻敲一下屏幕操作
方法：tap(element=None, x=None, y=None)
方法：perform() # 发送命令到服务器执行操作
参数：
1.element：被定位到的元素
2.x：相对于元素左上角的坐标，通常会使用元素的X轴坐标
3.y：通常会使用元素的Y轴坐标 

 手指按操作
模拟手指按下屏幕,按就要对应着离开.
方法:press(el=None, x=None, y=None)
方法：release() # 结束动作，手指离开屏幕
参数：
1.element：被定位到的元素
2.x：通常会使用元素的X轴坐标
3.y：通常会使用元素的Y轴坐标

 手指长按操作：模拟手机按下屏幕一段时间,按就要对应着离开.
方法：long_press(el=None, x=None, y=None, duration=1000)
参数：
1.element：被定位到的元素
2.x：通常会使用元素的X轴坐标
3.y：通常会使用元素的Y轴坐标
4.duration：持续时间，默认为1000ms