• pytest：python的一个单元测试框架,https://docs.pytest.org/en/latest/
• pytest-xdist：pytest的一个插件,可多进程同时执行测试用例,https://github.com/pytest-dev/pytest-xdist
• allure-pytest：用于生成测试报告,http://allure.qatools.ru/
• PyHamcrest：一个匹配器对象的框架，用于断言，https://github.com/hamcrest/PyHamcrest
• 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客户端,https://docs.paramiko.org/en/stable/
• 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/
• allpairspy: 用于将参数列表进行正交分析，实现正交分析法用例覆盖，https://pypi.org/project/allpairspy/
• python-binary-memcached：用于操作memcached，https://github.com/jaysonsantos/python-binary-memcached
• kazoo：用于操作zookeeper，https://github.com/python-zk/kazoo
• websockets：用于websocket请求，https://github.com/aaugustin/websockets
• Js2Py：用于执行js代码，https://github.com/PiotrDabkowski/Js2Py
• sqlacodegen：用于根据数据库表结构生成python对象，https://github.com/agronholm/sqlacodegen
• SQLAlchemy：SQL工具包及对象关系映射（ORM）工具，https://github.com/sqlalchemy/sqlalchemy

• apt-get install libpq-dev python3-dev 【用于psycopg2-binary所需依赖】
• apt-get install g++ libgraphicsmagick++1-dev libboost-python-dev 【用于pgmagick所需依赖】
• apt-get install python-pgmagick 【pgmagick所需依赖】

• yum install python3-devel postgresql-devel 【用于psycopg2-binary所需依赖】
• yum install GraphicsMagick-c++-devel boost boost-devel【用于pgmagick所需依赖】

• 安装Microsoft Visual C++ 2019 Redistributable，下载地址：https://visualstudio.microsoft.com/zh-hans/downloads/ 【jpype1、图像识别字库所需依赖】

• Linux:
  • pip3 install pgmagick==0.7.6
• Windows:
  • 下载安装对应版本：https://www.lfd.uci.edu/~gohlke/pythonlibs/#pgmagick

• 下载地址:https://github.com/xmindltd/xmind-sdk-python

• 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

• 安装libaio包
  • Linux-CentOS:yum install libaio
  • Linux-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 LD_LIBRARY_PATH=/home/john/oracle_instant_client/instantclient_18_3:$LD_LIBRARY_PATH

  • 中文编码设置

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

• 下载地址: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\instantclient_11_2
  • 配置中文编码,环境变量创建NLS_LANG=SIMPLIFIED CHINESE_CHINA.UTF8
• 注意:如果使用64位,python和instantclient都需要使用64位

• 安装依赖
  • Linux-Ubuntu:sudo apt install pkg-config aclocal libtool automake libleptonica-dev
  • Linux-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的安装
  • 修改/etc/profile添加如下内容，然后source

  export LD_LIBRARY_PATH=$LD_LIBRARY_PAYT:/usr/local/lib
  export LIBLEPT_HEADERSDIR=/usr/local/include
  export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
  

• 安装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

• 安装Microsoft Visual C++ 2019 Redistributable，下载地址：https://visualstudio.microsoft.com/zh-hans/downloads/

• 下载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

• 在Windows Vista、Windows7系统上的IE浏览器在IE7及以上版本中，需要设置四个区域的保护模式为一样，设置开启或者关闭都可以。
  • 工具-->Internet选项-->安全
• IE10及以上版本增强保护模式需要关闭。
  • 工具-->Internet选项-->高级
• 浏览器缩放级别必须设置为100%，以便本地鼠标事件可以设置为正确的坐标。
• 针对IE11需要设置注册表以便于浏览器驱动与浏览器建立连接
  • Windows 64位：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE
  • Windows 32位：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE
  • 如果FEATRUE_BFCACHE项不存在，需要创建一个，然后在里面创建一个DWORD(32位)，命名为iexplore.exe，值为0
  • Windows 64位两个注册表建议都设置
• IE8及以上版本设置支持inprivate模式，以便多开IE窗口时cookies能够独享
  • HKKY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main 下建一个名为TabProcGrowth的DWORD(32位)，值为0
• 重启系统
• 注:https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver#required-configuration

安装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

• demoProject 例子项目

• demoProject 例子项目

• android
  • demoProject 例子项目

• 统一使用Firefox浏览器进行元素定位
• 能用id、name、link(不常变化的链接)定位的，不使用css定位，能使用css定位，不使用xpath定位
• 项目使用并发运行，故编写测试用例时，应该避免模块与模块直接的用例会相互影响测试结果

• 能用id、name、link(不常变化的链接)定位的，不使用css定位，能使用css定位，不使用xpath定位
• 如需要上传文件到手机或者从手机下载文件，请确保有手机对应目录的读写权限
• 视频录制统一对单个单个case进行，保证录制时间不超过3分钟，且录制文件不要过大，否则会引起手机内存无法存储视频 * 确认手机是否能进行视频录制执行命令adb shell screenrecord /sdcard/test.mp4，能正常执行即可
• 设备屏幕坐标系原点都在最左上角，往右x轴递增，往下y轴递增