跨端 UI 自动化测试方案 -- Flybirds

 																
├─ cli	                        脚手架
├─ core
|   ├─ config_manage.py         配置管理
|   ├─ dsl
|   │    ├─ globalization       国际化处理
|   │    └─ step                Step 列表
|   ├─ global_resource.py       全局配置
|   ├─ launch_cycle             生命周期管理
|   └─ plugin
|        ├─ event               事件管理
|        ├─ plugin_manager.py   插件管理
|        └─ plugins					
|             ├─ android        Andriod 相关处理
|             ├─ ios            iOS 相关处理
|             └─ web            Web 相关处理
├─ report                       报告
├─ template                     模板处理
└─ utils

DSL step 列表

当然在这个架构中, 各端略有不同，主要是各端的平台差异性导致，以下是各端具体支持的 DSL step 列表, 大部分 step 能够适用于多端

语句模板	语义	适用于
等待[]秒	等待一段时间	ALL
页面渲染完成出现元素[]	进入新的页面时检查指定元素是否渲染完成	ALL
点击[]	点击指定属性的元素	ALL
点击文案[]	点击指定文案的元素	ALL
点击屏幕位置[][]	点击屏幕指定位置	ALL
在 [] 中输入[]	在指定选择器中输入字符串	ALL
向[] 查找[]的元素	向指定方向查找指定属性的元素	ALL
全屏向[] 滑动[]	全屏向指定方向滑动指定距离	ALL
[] 向[] 滑动[]	在指定区域内向指定方向滑动指定距离	ALL
存在[]的文案	检查页面中存在指定的字符串	ALL
不存在[]的文案	检查页面中不存在指定的字符串	ALL
存在[]的元素	检查页面中存在指定属性的元素	ALL
不存在[]的元素	检查页面中不存在指定属性的元素	ALL
文案[] 的属性[] 为 []	检查页面中指定文案的指定属性为指定值	ALL
元素[] 的属性[] 为 []	检查页面中指定元素的指定属性为指定值	ALL
[] 的文案为[]	检查页面中指定元素的文案等于指定值	ALL
[] 的文案包含[]	检查页面中指定元素的文案包含指定值	ALL
回到首页	回到首页	ALL
全屏截图	保存当前屏幕图像	ALL
登录账号[] 密码[]	使用账号密码进行登录	ALL
退出登录	退出系统登录	ALL
结束录屏	结束录制视频	ALL
在[] 中向 [] 查找 [] 的元素	在指定选择器的元素内向指定方向滑动查找指定选择器的元素	ALL
跳转到[]	跳转到指定的 url 地址	Android,Web
返回上一页	返回上一页面	Android,Web
开始录屏	开始录制视频	Android,iOS
开始录屏超时[]	开始录屏并设置超时时间	Android,iOS
连接设备[]	连接测试设备	Android,iOS
启动 APP[]	启动 APP	Android,iOS
重启 APP	重启 APP	Android,iOS
关闭 App	关闭 App	Android,iOS
安装 APP[]	安装 APP	Android
删除 APP[]	删除 APP	Android
-----	-----	-----

多端应用例子

测试用例

功能: 乘机人模块

@p1 @android @web
场景:外露乘机人_选择列表页乘机人
   当   跳转页面到[单程填写页]
   那么 页面渲染完成出现元素[已选乘机人姓名]
   那么 [选择乘机人文案]的文案为[选择乘机人]
   那么 [已选乘机人姓名]的文案为[李易峰]
   那么 [已选乘机人证件类型]的文案为[护照]
   那么 [已选乘机人证件号]的文案为[YHE77]
   那么 存在[乘客类型标签儿童]的元素
   那么 返回上一页

页面对象管理

多端项目中的页面对象管理，是通过 json 文件进行统一管理，通常存在以下两种情况

各端相同时，参考以下配置

// 元素定位配置 ele_locator.json
{
  "选择乘机人文案": “testid=passger_check”,
  "已选乘机人姓名": “testid=passger_name_checked”,
  "已选乘机人证件类型": “testid=passger_ct_checked”,
  "已选乘机人证件类型": “testid=passger_cn_checked”
}

各端不同时，通过 android 、ios 、web 区分

// scheme 配置 schema_url.json  
{
  "单程填写页": {
    "android": "urlschemel://auth_activity",
    "web": "https://address"
  }
}

// 元素定位配置 ele_locator.json
{
  "乘客类型标签儿童": {
    "android": "textid=passger_type_child",
    "web": "xpath=//html/body/div"
  }
}

数据驱动参数化

实际项目中，大部分的自动化测试都是基于数据驱动参数化，因此还需要搭配「场景大纲+例子」一起使用，这里我们对上面的例子进行改造：

功能: 乘机人模块

@p1 @android @web
场景大纲:  外露乘机人_选择列表页乘机人
     当   跳转页面到[单程填写页]
     那么 页面渲染完成出现元素[已选乘机人姓名]
     那么 <element>的文案为<title>
     那么 存在[乘客类型标签儿童]的元素
     那么 返回上一页

     例子:
        |   element          |   title      |
        |   选择乘机人文案     |   选择乘机人   |
        |   已选乘机人姓名     |   李易峰      |
        |   已选乘机人证件类型  |   护照       |
        |   已选乘机人证件号    |   YHE77     |

多浏览器并发

依托 PlayWright 的跨浏览器能力，Flybirds 支持所有的现代渲染引擎，包括 Chromium 、WebKit 和 Firefox 。

Flybirds 支持多浏览器并发模式，方便高效的进行浏览器兼容性测试

配置参数

// browserType: 配置浏览器内核
  "web_info": {
    "headless": true,
    "browserType": ["firefox","chromium","webkit"],  
    "defaultTimeout": 30
  },

执行命令

# 可通过参数指定浏览器内核
flybirds run -D browserType=webkit,firefox,chromium

运行前检查

接下来，开始运行前，请先对运行环境进行检查

Android 、iOS

请确保配置的测试设备能够正常连接
- Android: 执行命令 adb devices , 检查设备列表中是否包含测试设备
- iOS：以tidevice库举例，执行命令 tidevice list，检查设备列表中是否包含测试设备
下载安装测试包
- Android：框架会通过config中配置的packagePath自动下载测试包并安装（请确保手机已经打开”允许安装未知来源“ ），也可手动下载安装。
- iOS:
  1. 请手动下载演示 APP 进行安装
  2. 开启 wdaproxy
```
$udid wdaproxy -B $web_driver_angnt_bundle_id -p $port```
```

Web

Web 项目执行前，先检查浏览器环境是否已安装

# 查看支持安装的浏览器
playwright install --help

# 不带参数的运行，将安装默认所有的浏览器
playwright install

# 通过提供一个参数来安装特定的浏览器
playwright install webkit

运行

你可以很方便的通过 cli 切换执行环境, 筛选 case 和控制并发数量，下面列出了一些常用命令

# 查看运行项目时支持的操作
flybirds run --help

#  执行 features 目录下所有的 feature 文件
cd {PATH_TO_PROJECT_FOLDER}
flybirds run  

# 指定需要执行的 feature 集合，可以是目录，也可以指定到具体 feature 文件
flybirds run -P ./features/test/demo.feature

# 运行有特定 tag 的场景，多个用逗号隔开，‘-’开头表示不运行包含此 tag 的场景
flybirds run -T tag1,tag2,-tag3,tag4

# 切换到 Web 环境执行用例
flybirds run -D platform=web 

# 切换到 Android 环境执行用例
flybirds run -D platform=Android

# 切换到 iOS 环境执行用例
flybirds run -D platform=iOS 

# 执行 tag 为 android 的用例
flybirds run -T android -D platform=Android 

# 指定并发执行时开启进程的最大数量。默认是 4 ，只在 web 环境生效
flybirds run --path features -p 5

配置

以下是各端运行前必须的配置项

Android 配置项：deviceId 、packageName
IOS 配置项：platform 、deviceId 、packageName 、webDriverAgent 、
Web 配置项：platform 、browserType 、headless

自定义框架扩展

Flybirds 的插件式设计模式，保留了良好的扩展，未来我们会开放更多。

修改扩展

如果你希望在项目中修改当前扩展，你可以用本地文件替换 plugin 下面的（ app,device,element,app,step,screen,screen_record ），并在 "plugin_info.json" 中做相应配置。

比如你希望修改 web 中 screen.py 文件:

1. 在本地创建一个 py 文件命名为 screen.py
2. 在 plugin_info.json 的 web 中添加如下配置:

  "screen": {
  "path": "{local_path}/screen.py",
  "ns": "screen.plugin.myextend"
  }

{local_path} 为本地路径，"ns"为包名,注意包名的唯一性(以上包名只是例子不做强制限制)

内部增强包

对于团队内部通用的自定义功能，可以考虑创建一个 extend package ，Flybirds 支持动态加载，package 命名包含“-flybirds-plugin”即可。携程机票内部，针对 DevOps 的各类工具，增强包中都进行了对接，安装后即可使用。

持续集成

cli 提供的命令行执行模式，可以非常方便加入各种持续集成工具.

以 Jenkins 为例：

# Inside the jenkins shell command
cd {PATH_TO_PROJECT_FOLDER}
# Run
flybirds run -P ./features/test/everything.feature -define platform=Android
cp -R reports $WORKSPACE