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
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的本地或远程路径。
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()
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特有的方法)
driver.wait_activity("homepage.activity", 15, 1) pass
其它API
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')```
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