Appium的使用

一、环境配置：
1、安装Node.js
2、配置JDK环境
3、配置Android SDK环境
4、安装Appium桌面版本
5、配置Python环境，安装selenium、Appium-Python-Client库
6、安装模拟器（MuMu模拟器）

环境配置参考：

这里是引用

二、使用Appium的查看元素信息

1、打开安装好的MuMu模拟器。

2、打开Appium的桌面版本，点击’启动审查器会话’。（也可以使用Android SDK自带的UiAutomatorViewer查看元素信息）

3、输入启动的初始化参数，必需输入platformName这个参数：

可选参数：

启动成功就可以在该界面看到app中元素的信息：

ps:或者使用Android sdk自带的UIAutomatorViewer查看元素信息：
步骤：
1、启动待测试的app。
2、window下打开Android sdk的tools目录，双击 uiautomatorviewer.bat；mac下打开tools/bin目录下的uiautomatorviewer。
3、在模拟器上打开元素所在的页面，然后点击UI Automator Viewer的左边起第二个按钮即可获取元素信息。
4、如果打开uiautomatorviewer闪退就可能是jdk1.9造成的，换成jdk1.8，点击第二个按钮报错的解决方法是重启adb服务：adb kill-server 、 adb start-server

4、在步骤3中找到元素后就可以在pycharm里面编写代码进行自动化逻辑操作：

'''前置代码段'''

from appium import webdriver

#初始化信息
capabilities = {} 
# Android平台测试
capabilities['platformName'] = 'Android'
# 测试手机版本为6.0
capabilities['platformVersion'] = '6.0.1'
capabilities['deviceName'] = 'Android Emulator'
# 模拟器上要测试的那个app的包名   可以用adb命令查看
capabilities['appPackage'] = 'com.codemao.lunar'
# 模拟器上要测试的app的中主入口activity(界面名)   可以用adb命令查看
capabilities['appActivity'] = '.MainActivityV2'

# 连接测试机所在服务器服务器
driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', capabilities)

三、常见的元素定位的几种方式

1、id定位
driver.find_element_by_id(id_value) # 定位一个元素，没找到的话会报错NoSuchElementException
driver.find_elements_by_id(id_value) # 定位一组元素，返回值是一个列表, 传入错误参数没找到元素不会报错，只会返回空列表

2、class定位
driver.find_element_by_class_name(class_value)
driver.find_elements_by_class_name(class_value)

3、xpath定位
driver.find_element_by_xpath(xpath_value)
driver.find_elements_by_xpath(xpath_value)

4、AccessibilityId也称为content-desc
driver.find_element_by_accessibility_id(‘题库’)

5、通过Android UIAutomator定位
driver.find_element_by_android_uiautomator(‘new UiSelector().text(“请输入手机号”)’)
具体使用参考下文

参考文章引用
UiAutomatorViewer&元素定位方法

四、元素等待
概念：找元素的时候，通过一个时间的设置，进行等待元素，等待元素出来之后，再来定位，防止报错。
应用场景：如果某个元素没有及时出来，那么我们就应该使用元素等待。
分类：隐式等待、显示等待、强制等待

隐式等待和显式等待的选择：
作用域：显式等待为单元素有效，隐式为全局元素。
方法：显式等待方法封装在WebDriverWait类中，而隐式等待则直接通过driver实例化对象调用。
从使用的角度上：隐式等待更简单，显式等待相对复杂。
从灵活性的角度上：显示等待更加灵活，因为可以针对每一个元素进行单独的设置；隐式等待是针对全局的定位元素。

1、隐私等待
概念：等待元素加载指定的时长，超出时长抛出NoSuchElementException。
应用场景：针对所有定位的元素的超时时间设置为同一个值的时候。
步骤：获取到driver对象，直接调用implicitly_wait(time_out)即可，以秒为单位。

from selenium.webdriver.support.wait import WebDriverWait
#在10秒内，找到元素就继续操作，找不到就报错
#只要设置一次，所有元素都是都会生效
driver.implicitly_wait(10) 

2、显示等待
概念：等待元素加载指定的时长，超出时长抛出TimeoutException。
应用场景：针对所有定位元素的超时时间设置为不同的值的时候。
步骤：
a.导包
b.创建WebDriverWait对象
c.调用WebDriverWait对象的until方法
示例：

from selenium.webdriver.support.wait import WebDriverWait

#在5秒内，每1s在《设置》程序中的“返回”按钮，如果找到就点击，找不到则观察对应错误信息。
#创建WebDriverWait对象
wait = WebDriverWait(driver,5,poll_frequency=1)  # poll_frequency默认是0.5，设置为1就是每秒去调用一次这个方法,
#获取元素并设置超时时间和频率
search_btn = wait.until(lambda x: x.find_element_by_xpath("//*[contains(@content-desc,'收起')]"))
#点击搜索按钮
search_btn.click()

3、强制等待

import time

time.sleep(5)  #强制等待5秒再执行下面的代码

五、driver常用的api

1、将app置于后台：
driver.background_app(5) #把app置于后台5秒再返回app

2、关闭应用，不会关闭driver：
driver.close_app（）
关闭应用及driver：
driver.quit( )

3、安装和卸载应用：
driver.install_app(app_path)
driver.remove_app(app_id) #包名

六、元素常用的api

1、点击元素：
element.click()

2、输入和清空输入框内容：
element.send_keys(vlaue)
element.clear()
注意：默认输入中文是有问题的，需要在连接手机的参数加上两行代码（我上面的前置代码初始化参数变量名是capabilities）：
capabilities[‘unicodeKeyboard’] = True
capabilities[‘resetKeyboard’] = True

3、获取元素的内容：
场景：获取按钮、文本框、输入框等控件的文本内容时使用
属性名：element.text

#获取element控件的文本内容
#返回值： 控件的文本内容
titles = driver.find_elements_by_id('com.android.settings:id/title') #获取手机系统设置的所有元素
for i in titles:
	print(i.text) #循环输出系统设置的元素名称：WiFi、电量、应用管理等...

4、获取元素的大小和位置
#获取的值是int类型的
element.location #返回值是字典类型： {“x”：xxx，“y”：xxx }
element.size #返回值是字典类型：{“width”：xxx，“height”：xxx}

5、获取元素的属性值
element.get_attribute(“属性名”)
注意：上图所示，有些元素的text和content-desc其中一个是空的其中一个不为空，这时候用element.get_attribute(“name”)就会返回content-desc或者text的值。

6、滑动和拖拽事件
swipe滑动事件
概念：从一个坐标位置滑动到另一个坐标位置，只能是两个点之间的滑动，有惯性

'''swipe(起始的x坐标值,起始的y坐标值,终点的x坐标值,终点的y坐标值,持续时间ms)'''
#当持续时间很长的时候，就没有惯性
driver.swipe(100,2000,100,1000,300) #300毫秒内实现滑动

scroll滑动事件
概念：从一个元素滑动到另外一个元素，直到页面自动停止。（有惯性，惯性很大）
driver.scroll(起始元素，结束元素，duration=600) #默认可以不传duration，默认是600ms，duration的值越大，惯性越小。

drag_and_drop拖拽事件
概念：从一个元素滑动到另外一个元素，第二个元素替代第一个元素的位置。（无惯性）
driver.scroll(起始元素，结束元素)

#手机的系统设置页面，滑动存储到更多的位置
save_button =driver.find_element_by_xpath("//*[@text='存储]")
more_button=driver.find_element_by_xpath("//*[etext='更多]")
driver.scroll(save_button，more_button)
driver.drag_and_drop(save_button，more_button)

七、高级手势TouchAction 的操作
应用场景：TouchAction 可以实现一些针对手势的操作，比如滑动、长按、拖动等。我们可以将这些基本手势组合成一个相对复杂的手势。比如，我们解锁手机或者一些应用软件都有手势解锁的这种方式。
使用步骤：
a.创建TouchAction对象
b.通过对象调用想执行的手势
c.通过perform( ) 来触发执行

1、手指轻敲
tap(元素,count=1)
tap(x=100,y=100,count=1) #count可以指定点击次数，也可以不写这个参数

 TouchAction(driver).tap(search_btn).perform()
 TouchAction(driver).tap(x=300, y=400)

2、按下和抬起
应用场景：模拟手指一直按下，模拟手机抬起。可以用来组合模拟轻敲或长按动作。
press(元素) #参数可以传元素对象或者是坐标。
press(x=650,y=650)
release()

#TouchAction(driver).press(search_btn).perform()
TouchAction(driver).press(x=650,y=650).perform()
time.sleep(2)
TouchAction(driver).press(x=650,y=650).release().pecform() #模拟松手

3、等待操作
应用场景：模拟手指等待，比如按下后等待5秒之后再抬起
TouchAction(driver).wait(second_ms).pecform()

#时间是毫秒
TouchAction(driver).press(x=650,y=650).wait(1000).release().perform()

4、长按操作
应用场景：模拟手指对元素或者坐标的长按操作。比如长按某个按钮弹出菜单。
TouchAction(driver).long_press(元素,duration=1000) #参数可以传元素，持续时间单位是毫秒
TouchAction(driver).long_press(x=100,y=200,duration=1000) #参数传坐标

TouchAction(driver).long_press(search_btn,duration=2000).perform()
TouchAction(driver).long_press(x=650,y=650,duration=2000).perform()

5、移动操作
应用场景：模拟手指的移动操作，比如手势解锁需要先按下，再移动手指，再松手。
TouchAction(driver).move_to(元素) # 参数传元素
TouchAction(driver).move_to(x=100,y=200) #参数传坐标

TouchAction(driver).press(x=650,y=650).move_to(x=100,y=200).release().perform()

![在这里插入图片描述](https://img-blog.csdnimg.cn/d981cd45022a479e97a90bb97153b58e.png
八、手机操作API
学习目的：获取手机分辨率、获取手机截图、获取和设置网络状态、能够发送按键到设备、能打开和关闭手机通知栏

1、获取手机的分辨率（计算一些点击或滑动的坐标）
driver.get_window_size( )
返回值是字典{“height”:800,“width”:480}

2、获取手机截图
使用场景：有些自动化的操作可能没有反应，但是并不报错，此时我们可以将操作过后的关键情况，截图保存。后期也可以根据图片发现问题。
driver.get_screenshot_as_file(filename) # 写文件的路径

#直接写文件名的话默认保存在项目目录下
driver.get_screenshot_as_file(os.getcwd()+os.sep+'./screen.png')

3、获取手机网络和设置手机网络
应用场景：视频应用在使用流量播放的时候，大部分都会提示用户是否继续播放。作为测试人员，我们可能需要用自动化的形式来判断是否有对应的提示。即，用流量的时候应该有提示，不用流量的时候应该没有提示。
driver.network_connection #获取当前的网络类型
下图的返回值就是数据、Wi-Fi和飞行模式。
设置网络driver.set_network_connection(value) #value是下图的0,1,2,4,6
4、发送键到设备
应用场景：模拟按手机按键，如“返回键”等。
#keycode:按键对应的编码，可以在百度搜索关键字“Android keycode”
#metastate：关于发送的关键代码的元信息，一般为默认值不传。
driver.press_keycodes(keycode,metastate=None)

driver.press_keycodes(24) #按音量加键

5、操作手机通知栏
应用场景：测试即时通信类软件的时候，如果A给B发送一条消息，B的通知栏肯定会显示对应的消息。我们想通过通知栏来判断B是否接收到消息，一定要先操作手机的通知栏。
#打开手机通知栏
driver.open_notifications( )
#关闭手机通知栏：官方没提供api，通过手势操作实现效果，手机上滑动或者模拟按返回键之类的吧。