史上最全 Appium 自动化测试从基础到框架实战精华学习笔记（一）

本文为霍格沃兹测试学院学员学习笔记，进阶学习文末加群。

对测试人来说，Appium 是非常重要的一个开源跨平台自动化测试工具，它允许测试人员在不同的平台（iOS、Android 等）使用同一套 API 来写自动化测试脚本，这样可大幅提升代码复用率和工作效率。

本文汇总了从 Appium 基础到自动化测试高级实战中，所涉及到的方方面面的知识点精华内容（如下所示），希望对大家快速总结和复习有所帮助。

Appium 从基础到自动化测试框架实战
Appium 基础 1(环境搭建和简介)
Appium 基础 2(元素定位和元素常用方法)
Appium 基础 3(手势操作和 uiautomator 查找元素)
Appium 基础 4(显式等待)
Appium 基础 5(toast 和参数化)
Appium 基础 6(webview)
Appium_ 企业微信练习 (非 PO，增加和删除联系人)
Appium_ 企业微信练习 (PO–增加联系人)
Appium 环境搭建
JDK 的搭建
下载 1.8 的 jdk
新建环境变量：JAVA_HOME 值为：D:\Program Files\Java\jdk1.7.0
新建环境变量：CLASSPATH 值为：.;%JAVA_HOME%\lib;（注意：点号表示当前目录，不能省略）
在系统变量 Path 的值的前面加入以下内容：%JAVA_HOME%\bin
SDK 的配置
下载 sdk
打开 sdk 的 sdk manager，安装 tools 前 3 个东西和 google 的 usb 驱动
配置 Android home 里面的 platform-tools 和 tools
Appium 的搭建
安装 node.js，配置 node.js 的环境变量
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install -g appium
cnpm install -g appium-doctor
pip install appium-python-client
appium 运行的 python 代码
mumu 连接 adb 是：adb connect 127.0.0.1:7555

Appium 的简介
Appium 的引擎
Android 是 uiautomator2
ios 是 xcuitest
Appium 的设计理念
webdriver 是基于 http 协议的，第一连接会建立一个 session 会话，并通过 post 发送一个 json 告知服务端相关测试信息
client/server 设计模式
客户端通过 webdriver json wire 协议与服务器通讯
多语言支持
server 可以放在任何地方
服务器 nodejs 开发的 http 服务
appium 使用 appium-xcuitest-driver 来测试 iphone 设备，其中需要安装 Facebook 出的 WDA(webdriver agent) 来驱动 ios 测试
Appium 的生态工具
adb：Android 控制工具
appium Destkop：内嵌 appium server 和 inspector 的综合工具
appium server：appium 的核心工具，命令行工具
appium client：各种语言的客户端封装库，用户连接 appium server，包含 python、java、ruby 等
appcrawler 自动遍历工具
获取 App 的信息
获取当前元素界面：adb shell dumpsys activity top
获取任务列表：adb shell dumpsys activity activities
获取 app 的 package 和 activity：adb shell；然后 logcat | grep -i displayed
启动应用:adb shell am start -W -n “com.xueqiu.android/.view.WelcomeActivityAlias -S
Capability 设置
文档地址：http://appium.io/docs/en/writing-running-appium/caps/index.html
platformName:android 通常都是写 android
deviceName:127.0.0.1:7555 这个通常是 adb devices 的名称
appPackage:com.xueqiu.android 这个是 app 的 package 包名
appActivity:.view.WelcomeActivityAlias 这个是 app 的 activity 名
noReset：true, false 是否重置测试的环境（例如首次打开弹框，或者登陆信息）
unicodeKeyboard：true, false 是否需要输入非英文之外的语言并在测试完成后重置输入法，比如输入中文
dontStopAppOnReset：true, false 首次启动的时候，不停止 app
skipDeviceInitialization：true, false 跳过安装，权限设置等操作
测试用的 apk
https://github.com/appium/appium/tree/master/sample-code/apps
Android 的基础知识
Android 的布局
Android 是通过容器的布局属性来管理子控件的位置关系，布局过程就是把界面上的所有的控件，根据他们的间距的大小，摆放在正确的位置
线性布局：LinearLayout
相对布局：RelativeLayout
帧布局：FrameLayout
绝对布局：AbsoluteLayout
表格布局：TableLayout
网格布局：GirdLayout
约束布局：ConstraintLayout
Android 四大组件
activity：与用户交互的可视化界面
service：实现程序后台运行的解决方案，比如 qq 音乐的音乐在后台运行，没有界面
content provide：内容提供者，提供程序所需要的数据，比如？提供数据库？
broadcast receiver：广播接收器，监听外部事件的到来（比如来电）
Android 常用的控件
TextView：文本控件
EditText：可编辑文本控件
Button：按钮
ImageButton：图标按钮
ToggleButton:开关按钮
ImageView：图片控件
CheckBox：复选框控件
RadioButton：单选框控件
控件知识
dom：Document Object Model 文档对象模型
dom 应用：最早应用于 html 和 js 的交互，用户表示界的控件层级，界面的结构化描述，常见的格式为 html、xml。核心元素为节点和属性
xpath：xml 路径语言，用于 xml 中的节点定位
Android 的应用层级结构是定制的 xml
app source 类似于 dom，表示 app 的层级，表示界面里面所有的控件数的结构
每个控件都有它的属性（resourceid、xpath、aid），没有 css 属性
Appium 的元素定位
普通方式的定位
driver.find_element_by_accessibility_id() 对应 content-desc
driver.find_element_by_id() 对应 resource-id
driver.find_element_by_name() 对应 text
driver.find_element_by_xpath() 对应 xpath
By 的定位方式
首先要 from appium.webdriver.common.mobileby import MobileBy as By
self.driver.find_element(By.ID,”") 对应 resource-id
self.driver.find_element(By.XPATH,"") 对应 xpath
self.driver.find_element(By.ACCESSIBILITY_ID,"") 对应 content-desc
self.driver.find_element(By.NAME,"") 对应 text
Xpath 的定位方式
driver.find_element_by_xpath("//[@text=’ 扫一扫 ']")
driver.find_element_by_xpath("//[@resource-id=‘com.taobao.taobao:id/tv_scan_text’]")
driver.find_element_by_xpath("//[@content-desc=’ 帮助 ']")
driver.find_element(By.XPATH,"//[@resource-id=‘com.xueqiu.android:id/name’ and @text=’ 阿里巴巴 ‘]") and 的使用
父类和兄弟类的方法：//[@text=’ 性别 ‘]/…//[@text=’ 男 ']。其中 /… 表示父类，//* 就是兄弟，孙子等类
//*[Contains(@text,“tong”)] 这是 xpath 的 text 模糊搜索的方法
元素的方法
元素的常用方法
点击方法：element.click()
输入操作：element.send_keys(“tong”)
设置元素的值：element.set_value(“tongtong”)
清除操作：element.clear()
是否可见：element.is_displayed 返回 true or false
是否可用：element.enabled() 返回 true or false
是否被选中：element.is_selected() 返回 true or false
获取属性值：element.get_attribute(name)
属性值介绍
get_attribute(name) 获取的属性名称和 uiautomatorviewer 的一致，但是 index 的值获取不了
真假获取的值是 true 和 false 的字符串，并不是 python 的 boolean 值
元素常用的属性
获取元素文本：element.text
获取元素坐标：element.location
结果：{‘y’:19,‘x’:498}
获取元素尺寸（高和宽）：element.size
结果：{‘width’:500,‘height’:22}
实战小案例 1
打开雪球 app
点击搜索输入框
向搜索输入框输入 “阿里巴巴”
在搜索的结果里选择阿里巴巴，然后点击
获取这只上香港 阿里巴巴的股价，并判断这只股价的价格>200
代码

from time import sleep
from appium import webdriver
from appium.webdriver.common.mobileby import MobileBy as By

class TestFind():
    #设置 caps 的值
    def setup(self):
        self.desire_cap= {
            #默认是 Android
            "platformName":"android",
            #adb devices 的 sn 名称
            "deviceName":"127.0.0.1:7555",
            #包名
            "appPackage":"com.xueqiu.android",
            #activity 名字
            "appActivity":".view.WelcomeActivityAlias",
            "noReset":"true",
            "unicodeKeyboard":True
        }
        #运行 appium，前提是要打开 appium server
        self.driver=webdriver.Remote("http://127.0.0.1:4723/wd/hub",self.desire_cap)
        self.driver.implicitly_wait(5)

    def test_search(self):
        """
        1. 打开雪球 app
        2. 点击搜索输入框
        3. 向搜索输入框输入 “阿里巴巴”
        4. 在搜索的结果里选择阿里巴巴，然后点击
        5. 获取这只上香港 阿里巴巴的股价，并判断这只股价的价格>200
        :return:
        """
        sleep(3)
        #点击搜索框
        self.driver.find_element(By.ID,"com.xueqiu.android:id/tv_search").click()
        #向搜索框输入阿里巴巴
        self.driver.find_element(By.ID,"com.xueqiu.android:id/search_input_text").send_keys(" 阿里巴巴 ")
        #找到搜索框预览结果的阿里巴巴，并点击
        self.driver.find_element(By.XPATH,"//*[@resource-id='com.xueqiu.android:id/name' and @text=' 阿里巴巴 ']").click()
        #选择 HK 股价的元素
        prices=self.driver.find_elements(By.ID,"com.xueqiu.android:id/current_price")[1]
        #提取股价的 text 属性
        price=float(prices.text)

        #判断股价是否大于 200
        assert price > 200

实战小案例 2
打开雪球首页
定位首页的搜索框
判断搜索框是否可用，并查看搜索框 name 属性值
打印搜索框这个元素的左上角坐标和它的宽高
向搜索框输入：alibaba
判断阿里巴巴是否可见
如果可见，打印搜索成功点击，如果不可见，打印搜索失败
代码

from time import sleep
from appium import webdriver
from appium.webdriver.common.mobileby import MobileBy as By


class TestFind():
    #设置 caps 的值
    def setup(self):
        self.desire_cap= {
            #默认是 Android
            "platformName":"android",
            #adb devices 的 sn 名称
            "deviceName":"127.0.0.1:7555",
            #包名
            "appPackage":"com.xueqiu.android",
            #activity 名字
            "appActivity":".view.WelcomeActivityAlias",
            "noReset":"true",
            "unicodeKeyboard":True
        }
        #运行 appium，前提是要打开 appium server
        self.driver=webdriver.Remote("http://127.0.0.1:4723/wd/hub",self.desire_cap)
        self.driver.implicitly_wait(5)

    def test_element_function(self):
        """
        1. 打开雪球首页
        2. 定位首页的搜索框
        3. 判断搜索框是否可用，并查看搜索框 name 属性值
        4. 打印搜索框这个元素的左上角坐标和它的宽高
        5. 向搜索框输入：alibaba
        6. 判断阿里巴巴是否可见
        7. 如果可见，打印搜索成功点击，如果不可见，打印搜索失败
        :return:
        """
        sleep(8)
        #找到搜索框的元素
        search=self.driver.find_element(By.ID, "com.xueqiu.android:id/tv_search")
        #当搜索框是可用（类似可点击）后才进行下面的操作，is_enabled() 返回 Ture or False
        if search.is_enabled():
            #打印搜索框的 text 值
            print(search.text)
            #打印搜索框左上角的坐标
            print(search.location)
            #打印搜索框的高和宽
            print(search.size)
            #点击搜索框，才可以进行下面的操作
            search.click()
            #在搜索框中输入阿里巴巴
            self.driver.find_element(By.ID, "com.xueqiu.android:id/search_input_text").send_keys(" 阿里巴巴 ")
            #定义找到预览结果的阿里巴巴的元素
            alibaba=self.driver.find_element(By.XPATH, "//*[@resource-id='com.xueqiu.android:id/name' and @text=' 阿里巴巴 ']")
            #当 alibaba 元素可见，打开搜索成功，否则打印搜索失败
            if alibaba.is_displayed():
                print(" 搜索成功 ")
            else:
                print(" 搜索失败 ")

更多内容，我们在后续文章分享。

（文章来源于霍格沃兹测试学院）