Appium之python API

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)