一：搭建appium环境
1、JDK和Android SDK配置
2、安装Node.js
3、安装.net framework
4、安装Appium
5、安装appium - python - client
google教程很多，可以参照网上的教程，这里就不赘述了。最后使用appium-doctor检测环境搭建是否ok。
这篇文章主要介绍下基础函数的封装。
二：让appium跑起来
打开appium-server（我这里版本是V1.10.0），点击：Start Server:
1.png
进到如下这个界面，然后点击页面右上角的放大镜:
3.png
进到appium-server的基础信息设置界面，点击Saved Capability Sets:
2.png
这里面可以配置物理机或者模拟器的设备信息，然后开始一个session，需要配置的信息如下：
capabilities = {
"platformName": "Android",
"deviceName": "0acfd8d5",
"appActivity": "com.imooc.component.imoocmain.splash.MCSplashActivity",
"appPackage": "cn.com.open.mooc",
"noReset": "true"#在当前 session 下不会重置应用的状态。默认值为 false，设置为true后，不需要每次运行用例都安装apk(特别是有开屏页的app，不需要每次都经过开屏页，打开app直接进入主页)
}
根据appium版本不同，可能有些参数不是必须的，但是能加上就加上，避免出现问题。其中deviceName可以通过在cmd（windows）窗口下执行adb devices 获取，前提是要先打开设备的调试模式以及windows电脑需要具备adb环境；appActivity和appPackage的获取有很多种方法获取，这里有两种情况：第一种是本地有apk包的情况下，那么直接使用命令aapt dump badging XXX.apk（后面是apk包的绝对路径）；第二种情况是没有apk包，但是模拟器或者真机上安装了应用，这时候可以使用adb logcat >c:\log.txt，把app的启动日志输出到本地的log文件，然后去log文件过滤查找，如何过滤查找关键字，这个百度也有，我一般是过滤START或者cmp关键字，后面一般跟的就是apk的Activity和Package名称（不推荐使用这个方法，因为我在多次尝试的过程中遇到华为手机有一个坑爹的问题，就是系统日志默认是关闭的，需要输入一串命令来打开log开关：*#*#2846579#*#*，进入projectmenu--后台设置--LOG设置--LOG开关--打开，最终以失败告终）；或者使用adb logcat | grep START命令（windows使用findstr过滤），在cmd窗口输入这个命令后，启动app，然后查看cmd窗口输出的日志
4.png
可以看到输出的日志中，有一个LAUNCHER关键字，后面紧接着flg=0x10200000cmp=cn.com.open.mooc/com.imooc.component.imoocmain.splash.MCSplashActivity中的cn.com.open.mooc就是包名，com.imooc.component.imoocmain.splash.MCSplashActivity就是启动页的Activity（推荐使用这种方法）。
准备工作做完之后，在appium-server的基础信息设置界面选择一个自己已保存的设备，然后点击start session，就可以看到appium-server端有日志输出，这个日志很重要，后续可以作为调试信息来定位问题，同时也能看到手机也就运行起了相应的apk（整个过程都是需要打开调试模式的）
三、页面滑动初级使用
appium的滑动函数是：driver.swipe(x,y,x1,y1,time)。起始点：x,y；终点x1,y1；time是可选参数，左右滑动Y坐标不变，X变化；上下滑动X坐标不变，Y变化。appium中的坐标和数学的坐标不同，appium坐标原点在界面左上角。
滑动函数的封装：
代码和数据分离可以有效减少由于数据变化而维护代码的成本，所以封装一个获取手机屏幕大小和滑动的类，达到的效果是：只需要告诉程序我想要滑动的方向即可，滑动坐标的起始点并不需要关心。
代码实现:
from appium import webdriver
from time import sleep
capabilities = {
"platformName": "Android",
#"automationName":"Uiautomator2",#获取toast元素需要的
"deviceName": "0acfd8d5",
"appActivity": "com.imooc.component.imoocmain.splash.MCSplashActivity",
# "appWaitActivity":"cn.com.open.mooc.index.splash.GuideActivity"#真机启动页等待
"appPackage": "cn.com.open.mooc",
"noReset": "true"#在当前 session 下不会重置应用的状态。默认值为 false，设置为true后，不需要每次运行用例都安装apk
}
class getSizeAndSwipe():
def __init__(self):#构造函数，实例化类的对象时调用
self.driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", capabilities)
self.size = self.driver.get_window_size()#获取屏幕的大小,返回的形式是{'width': 1080, 'height': 1812}
self.width = self.size["width"]#获取宽
self.height = self.size["height"]#获取高
def swipeUp(self):
x1 = self.width / 2
y1 = self.height / 10 * 9#获取高的十分之九的位置
x2 = x1
y2 = self.height / 10 * 1#获取十分之一的位置
self.driver.swipe(x1,y1,x2,y2)#向上滑动x坐标不变，y坐标变小
def swipeDown(self):
x1 = self.width / 2
y1 = self.height / 10 * 1
x2 = x1
y2 = self.height / 10 * 9
self.driver.swipe(x1, y1, x2, y2)
def swipeRight(self):
x1 = self.width / 10 * 1
y1 = self.height / 2
x2 = self.width / 10 * 9
y2 = y1
self.driver.swipe(x1, y1, x2, y2)
def swipeLeft(self):
x1 = self.width / 10 * 9
y1 = self.height / 2
x2 = self.width / 10 * 1
y2 = y1
self.driver.swipe(x1, y1, x2, y2)
def swipeAction(self,direction):#定义一个滑动函数，传入一个方向即可
if direction == "up":
self.swipeUp()
elif direction == "down":
self.swipeDown()
elif direction == "left":
self.swipeLeft()
else:
self.swipeRight()
if __name__ == "__main__":
vivoSwipe = getSizeAndSwipe()
vivoSwipe.swipeAction("up")#告知滑动的方向即可
四、元素定位
1、id定位
2、class_name定位
3、层级定位
4、uiautomator定位
5、Xpath定位
6、原生页面和webview页面切换，以及toast元素获取
封装一个登陆页面元素定位的类，每种定位方式封装为一个方法，代码实现：
from appium import webdriver
from time import sleep
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
capabilities = {
"platformName": "Android",
"automationName":"Uiautomator2",#获取toast元素需要的
"deviceName": "0acfd8d5",
"appActivity": "com.imooc.component.imoocmain.splash.MCSplashActivity",
# "appWaitActivity":"cn.com.open.mooc.index.splash.GuideActivity"#真机启动页等待
"appPackage": "cn.com.open.mooc",
"noReset": "true"#在当前 session 下不会重置应用的状态。默认值为 false，设置为true后，不需要每次运行用例都安装apk
}
class handleLoginElement():
def __init__(self):
self.driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub",capabilities)#初始化driver
def goLoginById(self):#id定位的方式登陆
bottoms = self.driver.find_elements_by_id("cn.com.open.mooc:id/lav")#底部的四个按钮（首页，手记，我的学习，账号的id属性是一样的，先找出所有的，然后再通过索引查找需要的元素）
count = bottoms[3]#账号元素的索引为3
count.click()#做一个点击操作
sleep(1)
self.driver.find_element_by_id("cn.com.open.mooc:id/rl_login_before").click()
self.driver.find_element_by_id("cn.com.open.mooc:id/right_text").click()#若是已有账号，那么直接点击登陆跳转到登陆界面；非首次登陆，不需要这一步，点击登陆会直接跳转到登陆界面
self.driver.find_element_by_id("cn.com.open.mooc:id/accountEdit").clear()#先清理一下默认的上次输入过的文本
self.driver.find_element_by_id("cn.com.open.mooc:id/accountEdit").send_keys("15555555555")#输入
self.driver.find_element_by_id("cn.com.open.mooc:id/passwordEdit").clear()
self.driver.find_element_by_id("cn.com.open.mooc:id/passwordEdit").send_keys("XXXX")
self.driver.find_element_by_id("cn.com.open.mooc:id/loginLabel").click()#点击登陆
sleep(2)
def goLoginByClassName(self):#name定位的方式登陆
bottoms = self.driver.find_elements_by_class_name("android.widget.ImageView")
print(len(bottoms))#可以打印看下找到了几个name属性为android.widget.ImageView的元素
count = bottoms[25]
count.click()
sleep(1)
self.driver.find_elements_by_class_name("android.widget.TextView")[0].click()#通过索引来操作元素
#第二次登陆，没有上面的这一步self.driver.find_element_by_id("cn.com.open.mooc:id/right_text").click()
self.driver.find_elements_by_class_name("android.widget.EditText")[0].clear()
self.driver.find_elements_by_class_name("android.widget.EditText")[0].send_keys("15555555555")
self.driver.find_elements_by_class_name("android.widget.EditText")[1].clear()
self.driver.find_elements_by_class_name("android.widget.EditText")[1].send_keys("XXXX")
self.driver.find_elements_by_class_name("android.widget.TextView")[2].click()
sleep(2)
def goLoginByUiAutomator(self):
bottoms = self.driver.find_elements_by_android_uiautomator('new UiSelector().resourceId("cn.com.open.mooc:id/lav")')
count = bottoms[3]
count.click()
sleep(1)
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.TextView")')[0].click()
self.driver.find_element_by_android_uiautomator('new UiSelector().resourceId("cn.com.open.mooc:id/right_text")').click()#若是已有账号，那么直接点击登陆跳转到登陆界面；非首次登陆，不需要这一步，点击登陆会直接跳转到登陆界面
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.EditText")')[0].clear()
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.EditText")')[0].send_keys("15555555555")
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.EditText")')[1].clear()
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.EditText")')[1].send_keys("XXXX")
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.TextView")')[2].click()
sleep(2)
def goLoginByXpath(self):
# self.driver.find_elements_by_xpath('//*[contains(@text,"账号")]')[1].click()#写法一，找到页面上text属性包含“账号“的元素
# self.driver.find_element_by_xpath('//android.widget.TextView[@text="账号"]').click()#写法二，找到页面上classname为android.widget.TextView并且text属性等于”账号”的元素
self.driver.find_element_by_xpath('//android.widget.TextView[@text="账号"]/../../preceding-sibling::*[@index="2"]').click()#定位页面上classname为android.widget.TextView并且text等于”账号”的元素；/../../代表向上两个层级，preceding-sibling代表兄弟节点，意思是找到兄弟节点下面index=2的元素
def getWebView(self):#原生和H5页面之间的切换
webview = self.driver.contexts
print(webview)#打印看下当前的上下文窗口有几个，获取要切换的窗口
for view in webview:
if view == "XXX":#XXX是要切换过去的窗口
self.driver.switch_to.content(view)
break
def getToast(self):
sleep(1)
bottoms = self.driver.find_elements_by_id("cn.com.open.mooc:id/lav") # 底部的四个按钮（首页，手记，我的学习，账号的id属性是一样的，先找出所有的，然后再通过索引查找需要的元素）
count = bottoms[3] # 账号元素的索引为3
count.click() # 做一个点击操作
sleep(1)
self.driver.find_elements_by_class_name("android.widget.TextView")[0].click() # 通过索引来操作元素
self.driver.find_element_by_android_uiautomator('new UiSelector().resourceId("cn.com.open.mooc:id/right_text")').click()
self.driver.find_elements_by_class_name("android.widget.EditText")[0].clear()
self.driver.find_elements_by_class_name("android.widget.EditText")[0].send_keys("15555555555")
self.driver.find_elements_by_class_name("android.widget.TextView")[2].click()
self.driver.find_elements_by_class_name("android.widget.EditText")[1].send_keys("123456")
self.driver.find_elements_by_android_uiautomator('new UiSelector().className("android.widget.TextView")')[2].click()
toast_element = ("xpath", "//*[contains(@text,'登录密码错误')]")#//代表根目录，*是通配符。表示根目录下所有text属性包含“登录密码错误”的元素
try:
toast = WebDriverWait(self.driver, 10, 0.1).until(EC.presence_of_element_located(toast_element))
print(toast.text)
except:
print("toast未找到")
if __name__ == "__main__":
handleelement = handleLoginElement()
handleelement.getToast()
其中，获取toast元素，需要
1、Appium1.6.3以上（包括1.6.3）
2、Android版本在5.0以上
引入了两个包：
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
WebDriverWait用于智能等待；expected_conditions用于直到某个条件满足
toast = WebDriverWait(self.driver, 10, 0.1).until(EC.presence_of_element_located(toast_element))
这段代码的含义是：智能等待10s，每隔0.1秒检测一次，直到某个定位元素出现为止。
