基础内容：

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.tengyun.yyn/.ui.SplashActivity" -S

（网易mumu连接端口默认为7555||adb connect 127.0.0.1:7555 ,然后再查下驱动就有了

<Forwarding name="ADB_PORT" proto="1" hostip="127.0.0.1" hostport="7555" guestport="5555"/>）

入坑解决：Did not get confirmation UiAutomator2 deleteSession worked; Error was: UnknownError: An unknown server-side error occurred while processing the command. Original error: Trying to proxy a session command without session id。

上面提示解决：删除原有的Settings，【win路径：C:\Users\Administrator\AppData\Roaming\appium-desktop】重新配置参数重新打开窗口解决了问题【jkd1.8、appium1.18.0】

或者是改下automationName参数值："automationName":"uiautomator1"

appium连接网易mumu模拟器：

进入cmd后，输入adb devices，会显示目前处于5037端口，并且守护进程成功启动的说明。

打开mumu模拟器之后找到的安装路径，点开bin文件夹，找到adb_server.exe的文件，在上方地址栏中输入cmd，进入cmd后，输入adb_server.exe connect 127.0.0.1:7555

之后关掉模拟器，打开platform-tools，并进入cmd，输入adb devices，如下图所示就表示成功连接了

---

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 跳过安装，权限设置等操作

---

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}

---

UIAutomator 查找元素

优缺点

优点

xpath 定位速度慢

UIAutomator 是 Android 的工作引擎，速度快

滚动查找很方便

缺点

表达式书写复杂，容易写错 IDE 没有提示

定位方式

通过 resource-id 定位

通过 classname 定位

通过 content-desc 定位

通过文本定位

组合定位

通过父子关系定位

用法

driver.find_element_by_android_uiautomator("表达式")

注：外层要用单引号，内层的字符串用双引号，因为本来就是 Java，Java 双引号才表示字符串

通过文本定位

new UiSelector().text("text文本")

通过 textContains 模糊匹配

new UiSelector().textContains("text文本")

通过某个文本开头匹配

new UiSelector().textStartWith("text文本")

正则表达式匹配

new UiSelector().textMatches("text文本")

组合定位

比如 id 与 text 的属性组合：driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/login_account").text("我的")')

父子关系定位:childSelector，先定位到父类，再用 childSelector 来定位子类

driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/login_account").childSelector(text("股票"))')

兄弟定位：fromParent

driver.find_element_by_android_uiautomator('new UiSelector().resourceId("com.xueqiu.android:id/login_account").fromParent(text("股票"))')

强制等待、隐式等待、显示等待

强制等待是 sleep，强烈不推荐，设定的时间太固定，如果是模拟器等待3秒，真机可能只需要等待2秒。

driver.implicitly.wat(timeout)，贯穿全部元素的等待，只需要设定一次即可，通常是在创建 driver 的时候后的代码运行，是 dom 建立之后的等待。

显示等待的简介

显示等待与隐式等待相对，显示等待必须在每一个需要等待的元素前面进行声明

是针对某个特定的元素设置等待时间，在设置时间内，默认美格一段时间检测一次当前某个元素是否存在

如果在规定的时间内找到元素，则直接执行，即找到元素就执行相关操作

如果超过设置时间检测不到就抛出异常，默认检测频率为0.5s,默认抛出的异常时NoSuchElementException

用到的两个常用类

WebDriverWait

expected_condition

---

java版app自动化测试初始化模板

目录结构如下：

（包含：驱动的基础配置、全局异常处理、异常截图、报告自动生成、app常用操作方法封装、常用工具类封装）

各包分层关系

basepage包负责存放app公共操作方法、AndroidDriver基础配置、testNG公共执行顺序BaseTest,对外暴露驱动等。

BaseApp类包含app操作有：封装By类型的点击操作和输入框输入数据操作、切换到下一个窗口操作、上下左右滑动操作、具体坐标点击操作、直接使用adb命令的操作、前进后退刷新的操作等，其它方法可自行封住。

部分封装方法如下：

page包(通用PO模式)：分为data数据包和element元素操作包，把定位元素和输入框数据统一放到data包中，元素的操作放到element包中。其中元素的操作数据来源于data包中。

testcase包是根据业务流程编写用例步骤（后面的用例维护均在此包下）

resource包下可以放chromedriver驱动或者存放异常捕获的截图、测试报告自动生成index.html报告（由于使用springboot可以直接访问报告）另一种测试报告用的最多的是allure2，一个开源很好的报告模板allure2 的GitHub地址测试报告输出到allure-results包下。

allure2报告集成，win下需要先下载allure2的zip包GitHub官网下载地址allure2，下载zip包后需要配置下环境变量，用例执行完成后会生成allure-results文件夹，在当前文件夹下执行

allureserve allure-results

即可自动打开web测试报告，如下：

extentreports报告样式如图（这里把项目源码路径修改了下，需要单独导下包）