Need help with AutomationTest?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

yanchunhuo
286 Stars 147 Forks 189 Commits 0 Opened issues

Description

自动化测试框架,支持接口自动化、WEB UI自动化、APP UI自动化、性能测试;支持多系统相互调用;支持接口与UI相互调用;支持dubbo接口调用

Services available

!
?

Need anything else?

Contributors list

avatar

自动化测试

概况

  • 本项目支持接口自动化测试、app ui自动化测试、web ui自动化测试、性能测试
  • 本项目由以下工具组成
    • pytest:python的一个单元测试框架,https://docs.pytest.org/en/latest/
    • pytest-xdist:pytest的一个插件,可多进程同时执行测试用例,https://github.com/pytest-dev/pytest-xdist
    • allure-pytest:用于生成测试报告,http://allure.qatools.ru/
    • assertpy:一个包含丰富的断言库,支持pytest,https://github.com/ActivisionGameScience/assertpy
    • requests:http请求框架,http://docs.python-requests.org/en/master/
    • Appium:移动端的自动化测试框架,https://github.com/appium/appium/tree/v1.15.1
    • selenium:web ui自动化测试框架,https://www.seleniumhq.org/
    • cx_Oracle:oracle操作库,https://cx-oracle.readthedocs.io/en/latest/index.html
    • JPype1:用于执行java代码,https://github.com/jpype-project/jpype
    • paramiko:ssh客户端,http://docs.paramiko.org/en/2.4/
    • Pillow:用于图片处理,https://pillow.readthedocs.io/en/latest/
    • PyMySQL:用于操作MySQL数据库,https://github.com/PyMySQL/PyMySQL
    • redis:redis客户端,https://pypi.org/project/redis/
    • tess4j:java的图片识别工具,https://github.com/nguyenq/tess4j/

使用

一、环境准备

1、脚本运行环境准备

1.1、安装系统依赖

  • Linux:
    • apt-get install g++ libgraphicsmagick++1-dev libboost-python-dev 【用于pgmagick所需依赖】
    • apt-get install python-pgmagick 【pgmagick所需依赖】
  • Windows:
    • 安装Microsoft Visual C++ 2019 Redistributable,下载地址:https://visualstudio.microsoft.com/zh-hans/downloads/ 【jpype1、图像识别字库所需依赖】

1.2、安装python依赖模块

  • pip3 install -r requirements.txt
  • 安装pgmagick
    • Linux:
      • pip3 install pgmagick==0.7.6
    • Windows:
      • 下载安装对应版本:https://www.lfd.uci.edu/~gohlke/pythonlibs/#pgmagick
  • 安装xmind-sdk-python
    • 下载地址:https://github.com/xmindltd/xmind-sdk-python

1.3、安装allure

  • 源安装
    • sudo apt-add-repository ppa:qameta/allure
    • sudo apt-get update
    • sudo apt-get install allure
    • 其他安装方式:https://github.com/allure-framework/allure2
  • 手动安装
    • 下载2.7.0版本:https://github.com/allure-framework/allure2/releases
    • 解压allure-2.7.0.zip
    • 加入系统环境变量:export PATH=/home/john/allure-2.7.0/bin:$PATH

1.4、安装openjdk8或jdk8

  • sudo add-apt-repository ppa:openjdk-r/ppa
  • sudo apt-get update
  • sudo apt-get install openjdk-8-jdk

1.5、安装maven

  • 完成maven的安装配置

1.6、安装Oracle Instant Client

  • Linux

    • 安装libaio包
      • centos:yum install libaio
      • ubuntu:apt-get install libaio1
    • 配置Oracle Instant Client

      • 下载地址:http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html
      • 下载安装包instantclient-basic-linux.x64-18.3.0.0.0dbru.zip
      • 解压zip包,并配置/etc/profile
        • unzip instantclient-basic-linux.x64-18.3.0.0.0dbru.zip
        • export LDLIBRARYPATH=/home/john/oracleinstantclient/instantclient183:$LDLIBRARYPATH
      • 中文编码设置

        import os
        os.environ['NLS_LANG'] = 'SIMPLIFIED CHINESE_CHINA.UTF8'
        
  • Windows

    • 下载地址:http://www.oracle.com/technetwork/topics/winx64soft-089540.html
    • 下载安装包instantclient-basic-windows.x64-11.2.0.4.0.zip
    • 解压zip包,并配置环境变量
      • 系统环境变量加入D:\instantclient-basic-windows.x64-11.2.0.4.0\instantclient112
      • 配置中文编码,环境变量创建NLSLANG=SIMPLIFIED CHINESECHINA.UTF8
    • 注意:如果使用64位,python和instantclient都需要使用64位

1.7、图像识别字库准备

  • 下载对应字库:https://github.com/tesseract-ocr/tessdata
  • 将下载的字库放到common/java/lib/tess4j/tessdata/
  • Linux
    • 安装依赖
      • ubuntu:sudo apt install pkg-config aclocal libtool automake libleptonica-dev
      • centos:yum install autoconf automake libtool libjpeg-devel libpng-devel libtiff-devel zlib-devel
    • 安装leptonica,下载leptonica-1.78.0.tar.gz,下载地址:https://github.com/DanBloomberg/leptonica/releases
      • 安装步骤同tesseract-ocr的安装
    • 安装tesseract-ocr,下载tesseract-4.1.1.tar.gz,下载地址:https://github.com/tesseract-ocr/tesseract/releases
      • ./autogen.sh
      • ./configure
      • sudo make
      • sudo make install
      • sudo ldconfig
  • Windows
    • 安装Microsoft Visual C++ 2019 Redistributable,下载地址:https://visualstudio.microsoft.com/zh-hans/downloads/

2、selenium server运行环境准备

2.1、安装jdk1.8,并配置环境变量

  • export JAVA_HOME=/usr/lib/jvm/jdk8
  • export JREHOME=${JAVAHOME}/jre
  • export CLASSPATH=.:${JAVAHOME}/lib:${JREHOME}/lib
  • export PATH=${JAVA_HOME}/bin:$PATH

2.2、安装配置selenium

  • 配置selenium server
    • 下载selenium-server-standalone-3.141.0.jar
    • 下载地址:http://selenium-release.storage.googleapis.com/index.html
    • 以管理员身份启动服务:java -jar selenium-server-standalone-3.141.0.jar -log selenium.log
  • 下载浏览器驱动
    • 谷歌浏览器:https://chromedriver.storage.googleapis.com/index.html
      • 驱动支持的最低浏览器版本:https://raw.githubusercontent.com/appium/appium-chromedriver/master/config/mapping.json
    • 火狐浏览器:https://github.com/mozilla/geckodriver/
      • 驱动支持的浏览器版本:https://firefox-source-docs.mozilla.org/testing/geckodriver/geckodriver/Support.html
    • IE浏览器(建议使用32位,64位操作极慢):http://selenium-release.storage.googleapis.com/index.html
    • 将驱动所在目录加入到selenium server服务器系统环境变量:export PATH=/home/john/selenium/:$PATH
  • IE浏览器设置
    • 在Windows Vista、Windows7系统上的IE浏览器在IE7及以上版本中,需要设置四个区域的保护模式为一样,设置开启或者关闭都可以。
      • 工具-->Internet选项-->安全
    • IE10及以上版本增强保护模式需要关闭。
      • 工具-->Internet选项-->高级
    • 浏览器缩放级别必须设置为100%,以便本地鼠标事件可以设置为正确的坐标。
    • 针对IE11需要设置注册表以便于浏览器驱动与浏览器建立连接
      • Windows 64位:HKEYLOCALMACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE
      • Windows 32位:HKEYLOCALMACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE
      • 如果FEATRUE_BFCACHE项不存在,需要创建一个,然后在里面创建一个DWORD(32位),命名为iexplore.exe,值为0
      • Windows 64位两个注册表建议都设置
    • IE8及以上版本设置支持inprivate模式,以便多开IE窗口时cookies能够独享
      • HKKYCURRENTUSER\Software\Microsoft\Internet Explorer\Main 下建一个名为TabProcGrowth的DWORD(32位),值为0
    • 重启系统
    • 注:https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver#required-configuration

3、appium server运行环境准备

3.1、安装jdk1.8,并配置环境变量

  • export JAVA_HOME=/usr/lib/jvm/jdk8
  • export JREHOME=${JAVAHOME}/jre
  • export CLASSPATH=.:${JAVAHOME}/lib:${JREHOME}/lib
  • export PATH=${JAVA_HOME}/bin:$PATH

3.2、安装配置appium server

  • 安装appium desktop server

    • 下载Appium-windows-1.15.1.exe
    • 下载地址:https://github.com/appium/appium-desktop/releases
    • 以管理员身份启动服务
  • Android环境准备

    • 安装java(JDK),并配置JAVA_HOME=/usr/lib/jvm/jdk8
    • 安装Android SDK,并配置ANDROID_HOME="/usr/local/adt/sdk"
    • 使用SDK manager安装需要进行自动化的Android API版本
  • IOS环境准备

    • 由于测试IOS真实设备没办法直接操作web view,需要通过usb,实现通过usb创建连接需要安装ios-webkit-debug-proxy
    • 下载安装地址:https://github.com/google/ios-webkit-debug-proxy/tree/v1.8.5
  • 手机chrome环境准备

    • 确保手机已安装chrome浏览器
    • 下载chrome浏览器驱动:https://chromedriver.storage.googleapis.com/index.html
    • 驱动支持的最低浏览器版本:https://raw.githubusercontent.com/appium/appium-chromedriver/master/config/mapping.json
    • 在appium desktop上设置驱动的路径
  • 混合应用环境准备

    • 方法一:安装TBS Studio工具查看webview内核版本:https://x5.tencent.com/tbs/guide/debug/season1.html
    • 方法二:打开地址(该地址在uc开发工具中可查到)查看webview内核版本:https://liulanmi.com/labs/core.html
    • 下载webview内核对应的chromedriver版本:https://chromedriver.storage.googleapis.com/index.html
    • 配置文件进行驱动路径的配置
    • 注:webview需要开启debug模式
  • Windows环境准备

    • 支持Windows10及以上版本
    • 设置Windows处于开发者模式
    • 下载WinAppDriver并安装(V1.1版本),https://github.com/Microsoft/WinAppDriver/releases
    • [可选]下载安装WindowsSDK,在Windows Kits\10\bin\10.0.17763.0\x64内包含有inspect.exe用于定位Windows程序的元素信息
  • 其他更多配置:https://github.com/appium/appium/tree/v1.15.1/docs/en/drivers

二、修改配置

  • vim config/appuiconfig.conf 配置app ui自动化的测试信息
  • vim config/webuiconfig.conf 配置web ui自动化的测试信息
  • vim config/projectName/projectName.conf 配置测试项目的信息
  • 修改性能测试负载机的系统最大打开文件数,避免并发用户数大于最大打开文件数

三、运行测试

1、API测试

  • cd AutomationTest/
  • python3 -u runapitest.py --help
  • python3 -u runapitest.py 运行cases/api/目录所有的用例
  • python3 -u runapitest.py -k keyword 运行匹配关键字的用例,会匹配文件名、类名、方法名
  • python3 -u runapitest.py -d dir 运行指定目录的用例,默认运行cases/api/目录
  • python3 -u runapitest.py -m mark 运行指定标记的用例

2、web ui测试

  • cd AutomationTest/
  • python3 -u runwebui_test.py --help
  • python3 -u runwebuitest.py 运行cases/webui/目录所有的用例
  • python3 -u runwebui_test.py -k keyword 运行匹配关键字的用例,会匹配文件名、类名、方法名
  • python3 -u runwebuitest.py -d dir 运行指定目录的用例,默认运行cases/webui/目录
  • python3 -u runwebui_test.py -m mark 运行指定标记的用例

3、app ui测试

  • cd AutomationTest/
  • python3 -u runappui_test.py --help
  • python3 -u runappuitest.py 运行cases/appui/目录所有的用例
  • python3 -u runappui_test.py -tt phone -k keyword 运行匹配关键字的用例,会匹配文件名、类名、方法名
  • python3 -u runappuitest.py -tt phone -d dir 运行指定目录的用例,默认运行cases/appui/目录
  • python3 -u runappui_test.py -m mark 运行指定标记的用例

4、性能测试

  • cd AutomationTest/
  • ./startlocustmaster.sh
  • ./startlocustslave.sh

四、生成测试报告

1、API测试

  • cd AutomationTest/
  • python3 -u generateapitest_report.py -p 9080
  • 访问地址http://ip:9080
  • 在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持

2、web ui测试

  • cd AutomationTest/
  • python3 -u generateReportwebuitestreport.py -ieport 9081 -chromeport 9082 -firefoxport 9083
  • 访问地址http://ip:908[1-3]
  • 在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持

3、app ui测试

  • cd AutomationTest/
  • python3 -u generateReportappuitestreport.py -sp 9084
  • 访问地址http://ip:9084

注:在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持

五、项目说明

1、API测试

  • 项目
    • demoProject 例子项目

2、web ui测试

  • 元素的显式等待时间默认为30s
  • 封装的显式等待类型支持:pageobjects/webui/wait_type.py
  • 封装的定位类型支持:pageobjects/webui/locator_type.py
  • 默认使用4个worker进行并行测试
  • 文件下载处理暂不支持ie浏览器
  • 无头浏览器暂不支持ie浏览器
  • 项目
    • demoProject 例子项目

3、app ui测试

  • 元素的显式等待时间默认为30s
  • 封装的显式等待类型支持:pageobjects/appui/wait_type.py
  • 封装的定位类型支持:pageobjects/appui/locator_type.py
  • 项目
    • android
      • demoProject 例子项目

项目结构

  • base 基础请求类
  • cases 测试用例目录
  • common 公共模块
  • common_projects 每个项目的公共模块
  • config 配置文件
  • init 初始化
  • logs 日志目录
  • output 测试结果输出目录
  • packages app ui测试的安装包
  • page_objects 页面映射对象
  • pojo 存放自定义类对象
  • test_data 测试所需的测试数据目录
  • runapitest.py 运行api测试脚本
  • runwebui_test.py 运行web ui测试脚本
  • runappui_test.py 运行app ui测试脚本
  • generateapitest_report.py 生成api测试报告
  • generateReportwebuitestreport.py 生成web ui测试报告
  • generateReportappuitestreport.py 生成app ui测试报告
  • startlocustmaster.sh 启动locust主节点
  • startlocustslave.sh 启动locust从节点

编码规范

  • 统一使用python 3.6
  • 编码使用-*- coding:utf8 -*-,且不指定解释器
  • 类/方法的注释均写在class/def下一行,并且用三个双引号形式注释
  • 局部代码注释使用#号
  • 所有中文都直接使用字符串,不转换成Unicode,即不是用【u'中文'】编写
  • 所有的测试模块文件都以testprojectNamemoduleName.py命名
  • 所有的测试类都以Test开头,类中方法(用例)都以test_开头
  • 每个测试项目都在cases目录里创建一个目录,且目录都包含有api、scenrarios两个目录
  • case对应setup/teardown的fixture统一命名成fixture[testcasemethodname]
  • 每一个模块中测试用例如果有顺序要求【主要针对ui自动化测试】,则自上而下排序,pytest在单个模块里会自上而下按顺序执行

pytest常用

  • @pytest.mark.skip(reason='该功能已废弃')
  • @pytest.mark.parametrize('key1,key2',[(key1value1,key2value2),(key1value2,key2value2)])
  • @pytest.mark.usefixtures('func_name')

注意点

  • 运行pytest时指定的目录内应当有conftest.py,方能在其他模块中使用。@allure.step会影响fixture,故在脚本中不使用@allure.step
  • 由于web ui配置的驱动是直接设置在系统环境变量,app ui指定了混合应用的浏览器驱动,在运行app ui时appium有可能会读取到系统的环境变量的配置,故运行时请排查此情况
  • web ui测试
    • 统一使用Firefox浏览器进行元素定位
    • 能用id、name、link(不常变化的链接)定位的,不使用css定位,能使用css定位,不使用xpath定位
    • 项目使用并发运行,故编写测试用例时,应该避免模块与模块直接的用例会相互影响测试结果
  • app ui测试
    • 能用id、name、link(不常变化的链接)定位的,不使用css定位,能使用css定位,不使用xpath定位
    • 如需要上传文件到手机或者从手机下载文件,请确保有手机对应目录的读写权限
    • 视频录制统一对单个单个case进行,保证录制时间不超过3分钟,且录制文件不要过大,否则会引起手机内存无法存储视频 * 确认手机是否能进行视频录制执行命令adb shell screenrecord /sdcard/test.mp4,能正常执行即可
    • 设备屏幕坐标系原点都在最左上角,往右x轴递增,往下y轴递增

交流

avatar

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.