Appium-Python各种元素定位及操作方法解析

元素定位方法 # /site-packages/selenium/webdriver/remote/webdriver.py

通过id定位元素

1 2	find_element_by_id(self, id_) # Usage: driver.find_element_by_id('foo') find_elements_by_id(self, id_) # Usage: driver.find_elements_by_id('foo')

通过xpath(相对路径)定位元素

1 2	find_element_by_xpath(self, xpath) # Usage: driver.find_element_by_xpath('//div/td[1]') find_elements_by_xpath(self, xpath) # Usage: driver.find_elements_by_xpath("//div[contains(@class, 'foo')]")

通过link_text定位元素

1 2	find_element_by_link_text(self, link_text) # Usage: driver.find_element_by_link_text('Sign In') find_elements_by_link_text(self, link_text) # Usage: driver.find_elements_by_link_text('Sign In')

通过partial_link_text定位元素

1 2	find_element_by_partial_link_text(self, link_text) # Usage: driver.find_element_by_partial_link_text('Sign') find_elements_by_partial_link_text(self, link_text) # Usage: driver.find_elements_by_partial_link_text('Sign')

通过name定位元素（被accessibility_id替代）

1 2	find_element_by_name(self, name) # Usage: driver.find_element_by_name('foo') find_elements_by_name(self, name) # Usage: driver.find_elements_by_name('foo')

通过accessibility_id定位元素

1 2	find_element_by_accessibility_id(self, id) # Usage: driver.find_element_by_accessibility_id('id') find_elements_by_accessibility_id(self, id) # Usage: driver.find_elements_by_accessibility_id('id')

通过tag_name定位元素（被class_name替代）

1 2	find_element_by_tag_name(self, name) # Usage: driver.find_element_by_tag_name('foo') find_elements_by_tag_name(self, name) # Usage: driver.find_elements_by_tag_name('foo')

通过class_name定位元素

1 2	find_element_by_class_name(self, name) # Usage: driver.find_element_by_class_name('foo') find_elements_by_class_name(self, name) # Usage: driver.find_elements_by_class_name('foo')

通过css_selector定位元素

1 2	find_element_by_css_selector(self, css_selector) # Usage: driver.find_element_by_css_selector('#foo') find_elements_by_css_selector(self, css_selector) # Usage: driver.find_elements_by_css_selector('#foo')

截取当前窗口的截图，如果有写入错误会返回False，其它返回True

1	get_screenshot_as_file(self, filename) # Usage: driver.get_screenshot_as_file('c:/foo.png')

获取当前屏幕的分辨率（长和宽）

1	get_window_size(self, windowHandle= 'current') # Usage: driver.get_window_size()

获取当前页面的网址

1	current_url(self) # Usage: driver.current_url

获取当前页面的源

1	page_source(self) # driver.page_source

关闭当前窗口

1	close(self) # driver.close()

退出脚本运行并关闭每个相关的窗口连接

1	quit(self) # driver.quit()

切换webview与native

1	driver.switch_to.context( "WEBVIEW")

操作 # python-client/appium/webdriver/webdriver.py

从元素origin_el滚动至元素destination_el

1	scroll(self, origin_el, destination_el) # Usage: driver.scroll(el1, el2)

将元素origin_el拖到目标元素destination_el

1	drag_and_drop(self, origin_el, destination_el) # Usage: driver.drag_and_drop(el1,el2)

模拟手指点击（最多五个手指），可设置按住时间长度（毫秒）

1	tap(self, positions, duration= None) # Usage: driver.tap([(x,y),(x1,y1),(x2,y2)],500)

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

1	swipe(self, start_x, start_y, end_x, end_y, duration= None) # Usage: driver.swipe(x1,y1,x2,y2,500)

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

1	flick(self, start_x, start_y, end_x, end_y) # Usage: driver.flick(100, 100, 100, 400)

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

1	pinch(self, element= None, percent= 200, steps= 50) # Usage: driver.pinch(element)

在元素上执行放大操作

1	zoom(self, element= None, percent= 200, steps= 50) # Usage: driver.zoom(element)

重置应用（类似删除应用数据）

1	reset(self) # Usage: driver.reset()

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

1	hide_keyboard(self, key_name= None, key= None, strategy= None) # Usage: driver.hide_keyboard()

发送按键码（安卓仅有），按键码可以上网址中找到

1	keyevent(self, keycode, metastate= None) # Usage: driver.keyevent('4')

发送按键码（安卓仅有），按键码可以上网址中找到

1	press_keycode(self, keycode, metastate= None) # Usage: driver.press_keycode('4')

发送一个长按的按键码（长按某键）

1	long_press_keycode(self, keycode, metastate= None) # Usage: driver.long_press_keycode(4)

获取当前的activity

1	current_activity(self) # Usage: print(driver.current_activity)

等待指定的activity出现直到超时，interval为扫描间隔1秒；即每隔几秒获取一次当前的activity；返回的True 或 False

1	wait_activity(self, activity, timeout, interval= 1) # Usage: driver.wait_activity('.activity.xxx',5,2)

后台运行app多少秒

1	background_app(self, seconds) # Usage: driver.background_app(5) 置后台5秒后再运行

检查app是否有安装

1	is_app_installed(self, bundle_id) # Usage: driver.is_app_installed("com.xxxx")

安装app,app_path为安装包路径

1	install_app(self, app_path) # Usage: driver.install_app(app_path)

删除app

1	remove_app(self, app_id) # Usage: driver.remove_app("com.xxx.")

启动app

1	launch_app(self) # Usage: driver.launch_app()

关闭app

1	close_app(self) # Usage: driver.close_app()

在测试过程中打开任意活动。如果活动属于另一个应用程序，该应用程序的启动和活动被打开。

1	start_activity(self, app_package, app_activity, **opts) # Usage: driver.start_activity(app_package, app_activity)

摇一摇手机

1	shake(self) # Usage: driver.shake()

打系统通知栏（仅支持API 18 以上的安卓系统）

1	open_notifications(self) # Usage: driver.open_notifications()

返回网络类型 数值

1	network_connection(self) # Usage: driver.network_connection

设置网络类型

1	set_network_connection(self, connectionType) # Usage: dr.set_network_connection(ConnectionType.WIFI_ONLY) //from appium.webdriver.connectiontype import ConnectionType

打开安卓设备上的位置定位设置

1	toggle_location_services(self) # Usage: driver.toggle_location_services()

设置设备的经纬度

1	set_location(self, latitude, longitude, altitude) # Usage: driver.set_location(纬度，经度，高度)

安卓输入法操作

返回安卓设备可用的输入法

1	available_ime_engines(self) # Usage: print(driver.available_ime_engines)

检查设备是否有输入法服务活动。返回真/假。

1	is_ime_active(self) # Usage: print(driver.is_ime_active())

激活安卓设备中的指定输入法，设备可用输入法可以从“available_ime_engines”获取

1	activate_ime_engine(self, engine) # Usage: driver.activate_ime_engine(“com.android.inputmethod.latin/.LatinIME”)

关闭安卓设备当前的输入法

1	deactivate_ime_engine(self) # Usage: driver.deactivate_ime_engine()

返回当前输入法的包名

1	active_ime_engine(self) # Usage: driver.active_ime_engine