Appium之python API

时间:2023-03-08 15:50:53
webdriver

contexts(self)

说明:返回多个会话内容

使用:driver.contexts

current_context(self)

说明:返回单个会话的内容

使用:driver.current_context

context(self)

返回current_context(self)

使用方法:driver.context

find_element_by_ios_uiautomation(self,uia_string)

说明:通过uiautomation在iOS元素中查找uia_string

参数:uia_string :iOS uiautomation库元素名称为uia_string

使用:driver.find_element_by_ios_uiautomation('.elements()[1].cells()[2]')

find_elements_by_ios_uiautomation(self, uia_string)

说明:通过uiautomation在iOS多个重复元素uia_string中查找

参数:uia_string :iOS uiautomation库元素名称为uia_string

使用:driver.find_element_by_android_uiautomator('.elements()[1].cells()[2]')

find_element_by_android_uiautomator(self, uia_string)

说明:通过uiautomation在Android元素中查找uia_string

参数:uia_string :Android uiautomation库元素名称为uia_string

使用:driver.find_elements_by_android_uiautomator('.elements()[1].cells()[2]')

find_elements_by_android_uiautomator(self, uia_string)

说明:通过uiautomation在Android多个重复元素uia_string中查找

参数:uia_string :Android uiautomation库元素名称为uia_string

使用:driver.find_elements_by_android_uiautomator('.elements()[1].cells()[2]')

find_element_by_accessibility_id(self, id)

说明:可查找元素的ID

参数:id: 一个字符串对应一个递归元素的搜索使用

ID /名称,当地的辅助功能选项利用

使用:driver.find_element_by_accessibility_id()

find_elements_by_accessibility_id(self, id)

说明:可查找元素多个相同的ID
参数:id: 一个字符串对应一个递归元素的搜索使用

ID /名称,当地的辅助功能选项利用

使用:driver.find_element_by_accessibility_id()

scroll(self, origin_el, destination_el)

说明:滑动界面

参数:originalel -开始元素,destination_el:-结束元素

使用:driver.scroll(el1, el2)

drag_and_drop(self, origin_el, destination_el)
说明:拖拽到指定区域

参数:originalel :开始元素

destination_el: 结束元素

使用:driver. drag_and_drop( origin_el, destination_el)

swipe(self, start_x, start_y,end_x ,end_y, duration=None)

说明:屏幕滑动

参数:start_x-起始x坐标,start_y-起始y坐标,

end_x-结束x坐标,end_y结束y坐标

使用:driver.swipe(100, 100, 100, 400)

flick(self, start_x, start_y, end_x,end_y)

说明:

参数:start_x-起始x坐标,start_y-起始y坐标,

end_x-结束x坐标,end_y结束y坐标

用法:driver.flick(100,100,100,400)

pinch(self, element=None, percent=200,steps=50)

说明:缩放0x0到800x600的图片

参数:element-缩放的元素,percent-缩放百分比,steps-缩放的步长

用法:driver.pinch(element)

zoom(self, element=None, percent=200,steps=50)

说明:缩放超过800x600的图片

参数:element-缩放的元素,percent-缩放百分比,steps-缩放的步长

用法:driver.zoom(element)

app_strings(self, language=None)

说明:返回应用程序从设备指定的字符串语言

参数:language-字符串语言代码

使用:driver.app_strings(language)

reset(self)

说明:重置当前设备上应用

参数:

使用:driver.reset()

hide_keyboard(self, key_name=None,key=None, strategy=None)

说明:隐藏设备上的软键盘。在IOS使用”key_name”按某个键,或”策略”。使用Android,没有参数

参数:key_name -按键名称,key-按键编码,strategy-关闭键盘

用法:driver.hide_keyboard(key_name=None,key=None, strategy=’tapOutside’)

keyevent(self, keycode, metastate=None)

说明:向设备发送一个键码。Android。可能的键码可以发现

参数:keycode-被发送到设备的键码,metastate-关于发送的键码元信息

使用:driver.keyevent(keycode, metastate=None)

press_keycode(self, keycode,metastate=None)

说明:向设备发送一个键码。Android。

参数:keycode-被发送到设备的键码,metastate-关于发送的键码元信息

使用:driver.press_keycode(keycode,metastate=None)

long_press_keycode(self, keycode,metastate=None)

说明:向设备发送一个键码。Android。

参数:keycode-被发送到设备的键码,metastate-关于发送的键码元信息

使用:driver.long_press_keycode(keycode,metastate=None)

current_activity(self)

说明:获取当前应用的activity

参数:

使用:driver.current_activity()

set_value(self,element,value)

说明:设置应用中元素的值

参数:element-设置的元素,value-设置的值

使用:driver.set_value

pull_file(self, path)

说明:在“路径”检索文件。返回文件的内容作为Base64编码

参数:path-手机的路径

使用:driver.pull_file(‘path)

push_file(self, path, base64data)

说明:把数据,以Base64编码,文件指定的路径

参数:path-手机的路径,base64data- Base64编码

使用:driver.push(path, base64data)

background_app(self, seconds)

说明:把设备上的当前应用置于后台一定时间

参数:seconds-置于后台时间

使用:driver.background_app(seconds)

is_app_installed(self, bundle_id)

用法:检查是否“bundle_id”指定的应用程序安装到设备上

参数:bundle_id-查询应用程序的id

使用:driver.is_app_installed(bundle_id)

install_app(self, app_path)

用法:安装应用到手机目录

参数:app_path-应用程序的本地或远程路径安装

使用:driver.install_app(path)

remove_app(self,app_id)

用法:删除指定的应用程序从设备

参数:app_id-被删除应用程序id

使用:driver.remove(app_id)

launch_app(self)

用法:设备中运行指定的应用程序

参数:

用法:driver.launch_app()

close_app(self)

用法:停止当前运行的应用程序

语法:

用法:driver.close_app()

start_activity(self, app_package,app_activity, app_wait_package='', app_wait_activity='')

用法:打开一个任意的活动的activity。等待下一个activity启动。这是一个Android-only方法

参数:app_package-包名,app_activity-包启动activity,app_wait_package-等待启动包,app_wait_activity-等待启动包的activity

用法:driver.start_activity(app_package,app_activity, app_wait_package='', app_wait_activity='')

end_test_coverage(self, intent, path)

参数:intent-描述要执行的操作,path-从设备下载覆盖测试文件路径

用法:driver.end_test_coverage(intent,path)

lock(self, seconds)

说明:锁屏,只限ios

参数:seconds-锁屏时长

用法:driver.lock()

shake(self)

说明:震动设备

参数:

用法:driver.shake()

open_notifications(self)

说明:打开通知栏

参数:

用法:driver.open_notifications()

network_connection(self)

说明:返回一个整数位掩码指定网络连接类型.只限于Android。可能的值可以通过枚举的appium.webdriver.ConnectionType

参数:

用法:driver. network_connection()

set_network_connection(self, connectionType)

说明:设置网络连接类型。仅限Android。可能的值可以通过枚举的appium.webdriver.ConnectionType

Possible values:

Value (Alias)      | Data | Wifi |Airplane Mode

-------------------------------------------------

0 (None)           | 0    | 0   | 0

1 (Airplane Mode)   | 0     | 0    |1

2 (Wifi only)       | 0     | 1    |0

4 (Data only)      | 1     |0    | 0

6 (All network on)  | 1     |1    | 0

参数:connectionType-枚举成员appium.webdriver.ConnectionType.

用法:driver. set_network_connection(connectionType)

available_ime_engines(self)

说明:获得一个Android设备可用的输入方法。包和activity(如返回。(' com.android.inputmethod.latin /.LatinIME ')),仅限安卓

参数:

使用:driver. available_ime_engines()

is_ime_active(self)

说明:检查设备是否有输入法服务活动。返回真或假;仅限安卓

参数:

使用:driver. is_ime_active()

activate_ime_engine(self, engine)

说明:激活设备上给定的启动输入法的包和acticity。仅限安卓

参数:engine-启动输入法的包和acticity(例如,

“com.android.inputmethod.latin /.LatinIME”)

使用:driver. activate_ime_engine( engine)

deactivate_ime_engine(self)

说明:取消激活设备上定的启动输入法的包和acticity。仅限安卓

参数:engine-启动输入法的包和acticity(例如,

“com.android.inputmethod.latin /.LatinIME”)

使用:driver. deactivate_ime_engine( engine)

active_ime_engine(self)

说明:返回当前活跃的activity和包输入法引擎(例如,

“com.android.inputmethod.latin /.LatinIME”)

参数:

使用:driver. active_ime_engine()

get_settings(self)

说明:返回appium服务器设置为当前会话。

不要设置与期望的功能混淆,他们是谁

单独的概念。

参数:

用法:driver.get_settings()

update_settings(self, settings)

说明:设置当前会话的设置。

参数:settings-设置当前应用测试会话字典

用法:driver.update_settungs(setinngs)

toggle_location_services(self)

说明:开关设备上的定位服务。仅限安卓

参数:

用法:driver. toggle_location_services()

_addCommands(self)

说明:添加命令

参数:

用法:driver._addCommands()

set_value(self, value)

说明:在应用程序中设置值在这个元素

参数:

用法:driver.set_value(value)

tap(self, positions, duration=None)

说明:点击特定的地方,特定的时间

参数:positions -一个数组的元组代表的x / y坐标,长度可达5。

duration-tap时间的长度,单位:ms

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