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')]")
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')
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
Donate comment here