atx测试框架实现手机应用UI自动化测试

　　最近工作中遇到游戏APP需要实现UI自动化测试，这个app中真的是典型的混合App，有Android原生控件，有webview控件，以及游戏操作页面。研究了Appium,发现appium实现跨应用操作很困难，研究了好几天也没找到实现的方法。后来在公司大佬的带领下，接触到了atx这个自动化的框架。今天来说一下，使用atx,uiautomator2,pytest,selenium 来实现混合App的UI自动化及生成测试报告。

一、环境准备

本人使用的是系统是Mac，所以接线来的都是在Mac电脑上进行的。

1、安装adb,并将adb配置到环境变量中。具体请查看：https://blog.csdn.net/qq_26287435/article/details/81513649

2、安装pytest

 # 安装
 pip install -U pytest
 # 查看安装版本
 pip show pytest
 # 或者
 pytest --version

pytest的使用方法请自行查看：https://www.jianshu.com/p/75c27fe23b4e

3、安装uiautomator2

pip install --pre -U uiautomator2 #默认安装最新版本
pip install uiautomator2=0.1.11#指定版本安装

我使用的是0.1.11版本的，安装的时候指定版本：

4. 设备安装atx-agent

首先设备连接到PC，并能够adb devices发现该设备。

# 从github下载atx-agent文件，并推送到手机。在手机上安装包名为`com.github.uiautomator`的apk
$ python -m uiautomator2 init
success

看到success ，代表atx-agent初始化成功。手机上会出现一个小汽车图标的应用。

5.安装selenium

pip install selenium 

6.安装控件定位工具

weditor beta 针对Android和iOS原生应用快速定位元素，自动生成代码。

安装方式：

pip install --pre weditor

7.安装截图工具：

在进行游戏时，游戏界面的元素是无法使用原生的控件进行定位的，所以需要用到atx基于图片识别的方式来定位游戏控件。

截图工具使用方式：

python -m atx gui

二、UI自动化实现

atx API接口使用请查看：https://github.com/NetEaseGame/ATX/blob/master/docs/API.md

接口描述了操作手机APP的各种方法。

1、废话不多说，直接上代码：

 # -*- coding: utf-8 -*-

 import atx
 import os
 from PIL import Image
 import pytest
 import allure
 from allure_commons.types import AttachmentType
 from logzero import logger
 from uiautomator2 import UiObjectNotFoundError
 # from base.chromedrvier import ChromeDriver
 from atx.ext.chromedriver import ChromeDriver

 ISMAC = 1
 TIMEOUT = 10
 @allure.step("{0}")
 def connect_phone(devices):
     global package_name,main_activity
     # devices = "D6JNOV5PCANFAURW"
     logger.info("连接：" + devices)
     package_name = 'com.netease.cloudmusic'#网易云音乐APP的包名
     main_activity = ".activity.LoadingActivity" #网易云音乐的activity
     d = atx.connect(devices)#手机的devices name
     d.start_app(package_name, main_activity)#启动网易云音乐app
     return d

 @allure.step("{1}")
 def click_text(atx_conn, action_m, text, timeout=TIMEOUT):
     """
     点击安卓原生的控件
     :param atx_conn:atx实例
     :param action_m:执行的行为描述
     :param text:需要查找的按钮的文本
     :param timeout:等待
     :return:
     """

     logger.info(action_m)
     atx_conn(text=text).click(timeout=timeout)
     report_jietu(atx_conn,action_m)#截图

 @allure.step("{1}")
 def click_id(atx_conn, action_m, id, timeout=TIMEOUT):
     """

     :param atx_conn: 连接实例
     :param action_m: 操作描述
     :param id: resureid
     :param timeout: 超时时间
     :return:
     """
     logger.info(action_m)
     atx_conn(resourceId = id).click(timeout=timeout)
     report_jietu(atx_conn,action_m)#截图

 def report_jietu(atx_conn,action_m):
     """
    截图
    :param atx_conn:atx实例
    :param action_m:action_m,被用作图片名称
    :return:
    """
     image = screenshot(atx_conn,action_m)#截图
     with open(image,"rb") as f :
         file = f.read()
     allure.attach(action_m,file,allure.attach_type.PNG)#截图附件

 def screenshot(atx_conn,url):
     """
     截图
     :param atx_conn:atx实例
     :param url:url,被用作图片名称
     :return:
     """

     path = os.path.abspath(os.path.dirname(os.getcwd()))
     if ISMAC:
         path = path + "/report/image/%s.png" % (url)
     else:
         path = path + "\\report\\image\\%s.png" % (url)
     imgname = path
     atx_conn.screenshot(imgname)
     img(imgname)
     return imgname

 def img(image):
     """
     对图片进行压缩，覆盖原图进行保存
     :param image: 图片路径
     :return:
     """

     im = Image.open(image)
     # 获得图像尺寸
     w, h = im.size
     # print('原图尺寸: %sx%s' % (w, h))
     # 缩放到25%:
     im.thumbnail((w // 4, h // 4))
     # 把缩放后的图像用jpeg格式保存:
     im.save(image)

 @allure.feature('网易云音乐')
 class Test_misuc(object):
     @allure.story('进入每日推荐，点击播放第一首歌曲')
     def test_meirituijian(self):#进入每日推荐，点击播放第一首歌曲
         d = connect_phone("D6JNOV5PCANFAURW")#连接手机，启动云音乐
         click_text(d,"点击每日推荐","每日推荐")#点击每日推荐
         click_text(d,"点击播放全部","播放全部")#点击播放全部
         click_id(d,"点击暂停播放按钮","com.netease.cloudmusic:id/tr")#点击暂停播放按钮
         d.stop_app(package_name) #关闭云音乐

     @allure.story('进入我喜欢的音乐，将第一首歌分享给好友')
     def test_share(self):#分享歌曲给好友
         d = connect_phone("D6JNOV5PCANFAURW")#连接手机，启动云音乐
         click_text(d,"点击我的","我的")
         click_text(d,"点击我喜欢的音乐","我喜欢的音乐")
         click_id(d,"点击更多","com.netease.cloudmusic:id/a")
         click_text(d,"点击分享","分享")
         click_text(d,"点击分享微信好友","微信好友")
         # driver = ChromeDriver(d).driver() #启动selenium 如果是webview页面的话，需要启动selenium，然后根据selenium的定位方式查找元素
         click_text(d,"分享给唯安格","唯安格")
         click_text(d,"点击分享","分享")
         click_text(d,"点击返回网易云音乐","返回网易云音乐")
         d.stop_app(package_name)

 if __name__ == '__main__':
     a = Test_misuc()
     a.test_meirituijian()
     a.test_share()

运行上面代码并生成测试报告：

运行用例： py.test test_aa.py -s --alluredir ./reports
生成报告：allure generate --clean reports

其他工具启动：

启动weditor :python3 -m weditor
uiautomator2 初始化：python3 -m uiautomator2 init
启动atx gui: python3 -m atx gui
指定用例运行：py.test test_ddz.py::TestClass::test_share --alluredir ./reports

2、查看测试报告：执行完：allure generate --clean reports

命令之后，会在当前文件夹生成：allure-report文件夹，该文件下会有一个index.html的文件，只用浏览器打开index.html文件，可以查看生成的测试报告。

如下图：

allure生成测试报告的方法请看官方文档：https://docs.qameta.io/allure/#_pytest

参考：

https://testerhome.com/topics/11357