appium java api文档_Appium常用API

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的属性类名。如

...

通过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控件位置