Appium_Python_Api 文档

Appium_Python_Api 文档

1.contexts contexts(self):

Returns the contexts within the current session.

返回当前会话中的上下文，使用后可以识别H5页面的控件

:Usage:

driver.contexts用法 driver.contexts

2. current_context current_context(self):

Returns the current context of the current session.

返回当前会话的当前上下文

:Usage:

driver.current_context用法driver. current_context

3. context context(self):

Returns the current context of the current session.

返回当前会话的当前上下文。

:Usage:

driver.context用法driver. Context

4. find_element_by_ios_uiautomation find_element_by_ios_uiautomation(self, uia_string):

Finds an element by uiautomation in iOS.

通过iOS uiautomation查找元素

:Args:

- uia_string - The element name in the iOS UIAutomation library

:Usage:

driver.find_element_by_ios_uiautomation('.elements()[1].cells()[2]')用法dr. find_element_by_ios_uiautomation(‘elements’)

5. find_element_by_accessibility_id find_element_by_accessibility_id(self, id):

Finds an element by accessibility id.

通过accessibility id查找元素

:Args:

- id - a string corresponding to a recursive element search using the

Id/Name that the native Accessibility options utilize

:Usage:

driver.find_element_by_accessibility_id()用法driver.find_element_by_accessibility_id(‘id’)

6.scroll scroll(self, origin_el, destination_el):

Scrolls from one element to another

从元素origin_el滚动至元素destination_el

:Args:

- originalEl - the element from which to being scrolling

- destinationEl - the element to scroll to

:Usage:

driver.scroll(el1, el2)用法 driver.scroll(el1,el2)

7. drag_and_drop drag_and_drop(self, origin_el, destination_el):

Drag the origin element to the destination element

将元素origin_el拖到目标元素destination_el

:Args:

- originEl - the element to drag

- destinationEl - the element to drag to用法 driver.drag_and_drop(el1,el2)

8.tap tap(self, positions, duration=None):

Taps on an particular place with up to five fingers, holding for a certain time模拟手指点击（最多五个手指），可设置按住时间长度（毫秒）

:Args:

- positions - an array of tuples representing the x/y coordinates of

the fingers to tap. Length can be up to five.

- duration - (optional) length of time to tap, in ms

:Usage:

driver.tap([(100, 20), (100, 60), (100, 100)], 500)用法 driver.tap([(x,y),(x1,y1)],500)

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

Swipe from one point to another point, for an optional duration.

从A点滑动至B点，滑动时间为毫秒

:Args:

- start_x - x-coordinate at which to start

- start_y - y-coordinate at which to start

- end_x - x-coordinate at which to stop

- end_y - y-coordinate at which to stop

- duration - (optional) time to take the swipe, in ms.

:Usage:

driver.swipe(100, 100, 100, 400)用法 driver.swipe(x1,y1,x2,y2,500)

10.flick flick(self, start_x, start_y, end_x, end_y):

Flick from one point to another point.

按住A点后快速滑动至B点

:Args:

- start_x - x-coordinate at which to start

- start_y - y-coordinate at which to start

- end_x - x-coordinate at which to stop

- end_y - y-coordinate at which to stop

:Usage:

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

用法 driver.flick(x1,y1,x2,y2) 11.pinch pinch(self, element=None, percent=200, steps=50):

Pinch on an element a certain amount

在元素上执行模拟双指捏（缩小操作）

:Args:

- element - the element to pinch

- percent - (optional) amount to pinch. Defaults to 200%

- steps - (optional) number of steps in the pinch action

:Usage:

driver.pinch(element)

用法 driver.pinch(element) 12.zoom zoom(self, element=None, percent=200, steps=50):

Zooms in on an element a certain amount

在元素上执行放大操作

:Args:

- element - the element to zoom

- percent - (optional) amount to zoom. Defaults to 200%

- steps - (optional) number of steps in the zoom action

:Usage:

driver.zoom(element)

用法 driver.zoom(element) 13.reset reset(self):

Resets the current application on the device.重置应用(类似删除应用数据)用法 driver.reset()

14. hide_keyboard hide_keyboard(self, key_name=None, key=None, strategy=None):

Hides the software keyboard on the device. In iOS, use `key_name` to press a particular key, or `strategy`. In Android, no parameters are used.

隐藏键盘,iOS使用key_name隐藏，安卓不使用参数

:Args:

- key_name - key to press

- strategy - strategy for closing the keyboard (e.g., `tapOutside`)driver.hide_keyboard()

15. keyevent keyevent(self, keycode, metastate=None):

Sends a keycode to the device. Android only. Possible keycodes can be found in http://deve