Appium之常用API

Appium常用API解析

1、current_activity：获取当前页面的activity名，比如com.taobao.tao.TBMainActivity 或 com.taobao.browser.BrowserActivity

如判断当前页面是否为收藏夹：

if driver.current_activity == "com.taobao.weex.WXActivity":
    pass

2、page_source：返回页面的树形结构源码

如通过断言判断是否进入某个页面（该页面包含特定内容信息）

content = driver.page_source
try:
    assert "我的淘宝" in content
except Exception as e:
    raise e

3、contexts：返回当前会话的上下文（可以用来识别native和H5混合页面）

如在native和html5混合页面测试时，需要在native层和html5层切换，则首先需要得到context层的名称：

print(driver.contexts)

结果输出:
['NATIVE_APP', 'WEBVIEW_com.codoon.gps']

然后使用driver.switch_to.context("NATIVE_APP")，就可以切换到native层了

4、find_element_by_xxx：查找当前页面的一个元素

ele = driver.find_element_by_name("foo")

还可以使用如下：
ele = driver.find_element(by="name", value="foo")

5、find_elements_by_xxx：查找当前页面的多个元素

eles = driver.find_elements_by_name("foo")

还可以使用如下：
eles = driver.find_elements(by="name", value="foo")

6、click()：点击（在移动端的时候，会有200~300ms的延迟）

driver.find_element(by="xpath", value="//slhsjh").click()

7、tap()：在特定位置上轻击，并保持一定的时间（可以减少click在移动端的延迟，提高了性能）

函数原型：tap(positions: List[Tuple[int, int]], duration: Optional[int] = None)

driver.tap([(100, 20), (100, 60), (100, 100)], 500)

click和tap都能实现单击的效果。其区别在于click是作用于driverelement的实例化对象，而tap是对屏幕上的坐标位置进行点击。前者对元素的位置变化并不敏感，而后者是针对具体的像素坐标点击，受分辨率和元素位置影响较大。

8、send_keys()：调用设备的系统输入法键盘，输入文本内容

driver.find_element(by="xpath", value="//slhsjh").send_keys("Test")

9、swipe()、flick()：滑动，从[start_x, start_y]划到[end_x, end_y]的过程。

区别：swipe比flick多了一个duration参数，有了这个参数就可以自定义从start到end动作的作用时间duration（单位为ms），以达到快速滑动或者慢速滑动的效果。

函数原型：

swipe(start_x: int, start_y: int, end_x: int, end_y: int, duration: int = 0)
flick(start_x: int, start_y: int, end_x: int, end_y: int)

driver.swipe(100, 100, 100, 400, 500)
driver.flick(100, 100, 100, 400)

TouchAction类

TouchAction是APPium中封装的一个方法，主要是都手势控制的一些操作：点击、短按、长按、移动操作。

导入模块：from appium.webdriver.common.touch_action import TouchAction

TouchAction(driver)：获取的是TouchAction对象

TouchAction对象的操作方法

release()和perform()方法一般跟添加的动作后面。

（1）release()：通过将指针离开屏幕（释放指针）来结束动作

（2）perform()：通过向服务器发送命令来执行动作

from appium.webdriver.common.touch_action import TouchAction

方法1：tap(element=None, x=None, y=None, count=1)
'''
模拟手势触摸元素或坐标点。
（1）element：要点击的元素
（2）x/y：移动到的屏幕坐标点，默认为空
'''

方法2：press(el=None, x=None, y=None, pressure=None)
'''
模拟手势短按元素或坐标。
（1）el：要点击的元素
（2）x/y：移动到的屏幕坐标点，默认为空
（3）pressure：压力; [iOS只]按作为强制触摸
'''

方法3：long_press(el=None, x=None, y=None, duration=1000)
'''
模拟手势长按元素或坐标点，持续duration时间。
（1）el：要点击的元素
（2）x/y：移动到的屏幕坐标点，默认为空
（3）duration：持续按压时间，单位为ms
'''

方法4：wait(ms=0)
"""
模拟动作后的等待的时间。
"""

方法5：move_to(el=None, x=None, y=None)
'''
模拟从一个点移动到指定元素或指定点。
（1）el： 移动到的元素，默认为空
（2）x/y：移动到的屏幕坐标点，默认为空
'''

方法6：release()
 '''
 通过将指针离开屏幕（释放指针）来结束动作。
 '''

方法7：perform()
'''
通过向服务器发送命令来执行动作。
'''

例如：
from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction

ele = driver.find_element_by_xpath("//test")
TouchAction(driver).tap(element=ele).release().perform()
TouchAction(driver).tap(x=920, y=950).release().perform()
TouchAction(driver).press(el=ele).release().perform()
TouchAction(driver).long_press(el=ele).perform()
TouchAction(driver).wait(100)
TouchAction(driver).move_to(el=ele).release().perform()

MultiTouch类

MultiTouch类主要用于多点触控操作，可用于对界面执行放大、缩小操作。

导入模块：from appium.webdriver.common.multi_action import MultiAction

MultiAction(driver, element=None)：获取的是MultiAction对象
driver：操作的设备
element：操作的元素，默认为None

1. MultiAction对象的操作方法

1.1、添加TouchAction对象到MultiAction对象

（1）add(*touch_actions)

touch_actions：1个或多个TouchAction对象（描述一个手指要执行的一系列动作）

1.2、执行储存在对象中的所有动作

（1）perform()

当perform执行被调用时，添加到多点触摸的所有触摸动作都被发送到appium，并执行，就像它们同时发生一样。appium首先执行所有触摸动作的第一个事件，然后执行第二个......。

# 初始化MultiAction对象
MultiActionObject = MultiAction(driver)
# 向MultiAction对象中添加动作
touchAction1 = TouchAction(driver).press(x=100, y=200)
touchAction2 = TouchAction(driver).press(x=100, y=300)
MultiActionObject.add(touchAction1, touchAction2)
# 执行操作
MultiActionObject.perform()

元素事件类API

（1）reset()：重置应用（类似删除应用数据）

如通过driver.reset()来模拟实现首次登录app时出现的引导页需求：

driver.reset()

（2）is_app_installed()：检查设备上是否已安装app，参数为package_name（appPackage）。返回True表示已安装，False表示未安装。

如判断是否已安装淘宝app：

if driver.is_app_installed("com.taobao.taobao"):
    '''参数为package_name（appPackage）'''
    pass
else:
    pass

（3）install_app()：安装特定路径的app；参数为app的本地或远程路径。

如若检测到未安装淘宝app，则安装该app：

if driver.is_app_installed("com.taobao.taobao"):
    '''参数为package_name（appPackage）'''
    pass
else:
    driver.install_app(r"E:\AndroidTest\base.apk")

（4）remove_app()：在设备上移除特定的app，参数为package_name（appPackage）。

如测试旧版本兼容用例时，需要先卸载新版本，再安装旧版本：

driver.remove_app("com.taobao.taobao_new")
driver.install_app("com.taobao.taobao_old")

（5）launch_app()：在设备上启动desired capabilities中指定的app。

driver.launch_app()

（6）close_app()：在设备上停止运行desired capabilities中指定的app。

driver.close_app()

（7）start_activity()：在测试任务期间启动新的app活动，参数为appPackage和appActivity。

driver.start_activity('com.tencent.mobileqq','com.tencent.mobileqq.activity.SplashActivity')
print(driver.current_activity)

（8）wait_activity()：隐式等待某个activity出现，参数分别为目标activity、超时时间、检测间隔（单位均为s）。

（类似于webdriver的WebDriverWait，且是Android特有的方法）

如在后续操作需要在当前activity为主页的前提下：

driver.wait_activity("homepage.activity", 15, 1)
pass

其它API

（1）get_screenshot_as_file()：截屏并保存在特定路径，参数为图片路径和图片名称。

driver.get_screenshot_as_file('/Screenshots/foo.png')

（2）get_attribute()：获取已知元素控件的属性值，参数为控件。

driver.find_element_by_xpath("//test").get_property("checkable")

driver.find_element_by_xpath("//test").get_property("text")

（3）background_app()：将 app 置于后台，把当前应用放到后台去，参数为后台运行的时间，单位为s。

driver.background_app(5)

（4）pull_file()：从设备中提取文件。

driver.pull_file('Library/AddressBook/AddressBook.sqlitedb')

如在手机号注册时需要获取手机验证码，此时的实现方式是用另一个apk提取到验证码存在手机内存中，再用pull_file获取到验证码内容，使得appium可以将正确的验证码填入。

（5）push_file()：推送文件到设备中去

driver.pull_file('Library/AddressBook/AddressBook.sqlitedb')```

（6）keyevent()、press_keycode()：按键事件，向设备发送按键编码，参数为按键编码。（Android特有的方法）

driver.keyevent(66)         # 回车键
driver.press_keycode(3)     # Home键

（7）hide_keyboard()：收起键盘

driver.hide_keyboard()

（8）open_notifications()：打开通知栏（仅Android特有）

driver.open_notifications()

（9）shake()：模拟设备摇晃

driver.shake()

参考：https://www.jianshu.com/p/0e852c58609f

参考：https://www.cnblogs.com/7chentest/p/6396551.html