appium的客户端(WebDriver)提供的接口按作用分为:
1、系统操作
2、获取和操作控件信息(常用)
3、控件查找(常用)
4、手势操作
系统操作
1. driver.set_network_connection(self,bundle_id) #设置网络
2. app包
2.1 is_app_install(APP_PACKAGE_NAME) #判断应用程序是否安装
返回结果为True(已安装)/False(未安装)
2.1.1 driver.install_app(APK_PATH) #将app_path路径的应用安装到手机上,此处的app_path指PC端path,需要包含目录和文件名。
2.1.2 driver.installApp(r"D:\\android_m\\apk\\ContactManager.apk")
2.1.3 driver.remove_app(APP_PACKAGE) #移除app
2.1.4 重启app(先关闭再启动) 不需要入参
driver.closeApp(); # 关闭当前操作的app,不会关闭驱动对象,相当于按home键将应用置于后台,可以通过launchApp()再次启动
driver.launchApp(); #启动app,重新启动应用也是一个测试点,该方法需要配合closeApp()使用的。
2.2 关闭程序
close_app(self) 如果desired capabilities指定的应用程序正在运行,则关闭该程序
3.resetApp() #重置当前被测试程序到初始状态,不需要入参。
4.current_activity() #获取当前正在显示的Activity信息
5.d.start_activity(appPackage,appActivity) #脚本内启动其他app,启动后需要数据线重新连接,否则报其中一个进程在运行的错误
示例d.start_activity('com.tencent.mm','plugin.account.ui.WelcomeActivity')
6.shake(self) #模拟晃动手机事件
7.background_app(self,seconds) #将被测app放至后台运行seconds时间
8.get_screenshot_as_file(self,filename) #将手机屏幕截图保存电脑filename路径中
9.get_window_size() #获取手机的分辨率,一般配合swipe使用
10.print(driver.page_source) #返回当前页面的文档结构,判断特定的元素是否存在
pull_file(self, path) #拉取手机上的一个文件,并以Base64格式编码返回文件数据,path为手机上的文件路径
// import base64
// data = driver.pull_file('/sdcard/test.txt') # 返回数据为base64编码
// print(str(base64.b64decode(data), 'utf-8')) # base64解码
push_file (self, path, base64data) #将一个Base64格式编码的数据推送到手机,path为手机上的文件路径,base64data为要推送的数据
// import base64
// data = str(base64.b64encode('推送内容'.encode('utf-8')), 'utf-8')
// driver.push_file('/sdcard/推送文件名称.txt', data)
获取和操作控件信息
和selenium差不多
1. element.text #获取控件元素的文本信息
2. send_keys(self,*value) #模拟键盘输入到控件中
3. is_selected(self) #判断控件是否被选中且返回True,否则返回false
4. element.click() #点击事件
5. element.clear() #清空控件的文本内容
6. element.get_attribute("enabled") #获取控件的enabled属性,相当于is_enabled()方法
7.is_enabled() #判断控件是否可用,可用返回True
8. is_displayed() #判断控件是否显示,显示则返回True
控件查找
WebDriver支持id,xpath,className,Accessbility id和UIAutomator来查找控件
通过ID定位元素
find_element_by_id(self,id)
find_elements_by_id(self,id) 返回list
示例
end_b=appium_driver.find_element_by_id("com.tencent.mm:id/end")
end_b.click()
通过xpath定位元素
find_element_by_xpath(self,xpath)
find_elements_by_xpath(self,xpath)
通过class name定位元素
find_element_by_class_name(self,name)
find_elements_by_class_name(self,name)
在Native App测试中,参数Nname表示控件的类型,如android.view.Text
在网页测试中,参数Name指代网页element的属性类名。如<div class='test-demo'>...</div.>
通过Content Description定位元素
find_element_by_accessibility_id(self,id)
find_elements_by_accessibility_id(self,id)
accessibility_id 指Native App控件的Content description
通过UIAutomoator定位元素
find_element_by_android_uiautomoator(self,uia_string)
手势操作
滑动操作
swipe(self,start_x,start_y,end_x,end_y,duration=None) #从A点移动到B点
duration为滑动动作执行事件,单位为毫秒,app的坐标,左上角最小(0,0)右下角最大
点击屏幕
tap(self,positions,duration=None) #点击屏幕上的位置,最多支持五个手指同时点击
positions 值是列表,列表值为屏幕上坐标xy
duration 该参数不提供,则认为是点击操作,反之认为是长按操作
示例:driver.tap([(345,1589)],500) driver.tap([(x1,y1),(x2,y2),(x3,y3)],500)
缩小操作
flick(self,element=None,precent=200,step=50) #在某个控件上执行缩小操作,默认缩放比例为200%
element:定位的元素
precent:缩放比例,默认200%
step:缩小动作分多少步完成 ,默认50
driver.flick(element)
放大操作
zoom(self,element=None,precent=200,step=50) #在某个控件上缩小操作
滚动操作
scroll(self,origin_el,destination_el) # 从origin_el控件滚动到destination_el控件上,参数必做是控件,则不是控件信息
拖拽操作
drag_and_drop(self,orgin_el,destination_el) 把origin_el控件拖拽到destination_el控件位置