一、公共环境
python安装配置
1、下载：\\172.16.15.89\02_Tools\test\python-3.9.2-amd64.exe
2、直接运行，然后选择自定义安装，记得把添加环境变量的选项勾上
3、cmd运行python命令，表示安装成功
git安装配置及使用方法
1、安装该模块的目的：
所有的测试脚本都存在公司的gitlab中，大家通过git工具获取代码、提交代码
2、安装方法：
1）下载：\\172.16.15.89\02_Tools\test\Git-2.16.2-64-bit.exe
2）一路下一步安装即可
3、使用方法
1）打开git bash
2）生成并获取ssh key
生成：ssh-keygen -t rsa -C '域账号' 然后一路回车(-C 参数是你的域账号)
获取：
cat /c/Users/kang.yang/.ssh/id_rsa.pub
3）绑定gitlab（gitlab账号需要通过oa进行申请）
打开gitlab,找到右上角头像旁边下拉列表-Settings-->SSH Keys--->Add SSH Key,并把上一步中复制的内容粘贴到Key所对应的文本框，在Title对应的文本框中给这个sshkey设置一个名字，点击Add key按钮
4）获取代码（代码库权限需要找代码库的管理员添加）：
git clone git@gitlab.qizhidao.com:qzd-qa-team/qzd_app_test.git
5）上传代码
先修改代码
然后依次执行以下 命令：
git add .
git commit -m '提交代码'
git pull
git push
python依赖库安装
1、配置清华镜像（为了下载速度更快）：
1）在用户路径如：C:\Users\userx下新建pip文件夹
2）进入pip文件夹，新建文件pip.ini（记得确认文件后缀是.ini，而不是.ini.txt）
备注：创建.ini文件可参考：https://zhidao.baidu.com/question/246969816.html
3）打开pip.ini，粘贴以下内容并保存
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
2、通过requirements.txt进行安装：
进入代码根目录，先安装virtualenv，创建并进入虚拟环境
pip install virtualenv
virtualenv venv
venv\Scripts\activate
然后再安装其他的依赖库
pip --default-timeout 360 install -r requirements.txt
元素定位工具（weditor）
1、安装：
已包含在python依赖库中
2、安卓使用
1）打开cmd，先激活之前创建的虚拟环境，输入weditor，回车后会在浏览器打开一个页面如下
2）点击Connect连接手机，右侧显示绿色叶子代表连接成功
3）点击Dump Hierarchy，即可获取当前页面所有控件的属性，选中控件即可查看
3、ios使用
1）打开cmd，先激活之前创建的虚拟环境， 输入tidevice xctest，回车后如下表示成功
2）再打开一个新的cmd，先激活之前创建的虚拟环境， 输入tidevice relay -x 8100 8100，回车后没有任何输出，挂着就行
3）再打开一个新的cmd，先激活之前创建的虚拟环境， 输入weditor，回车后浏览器自动打开页面，同上安卓第一步
4）页面中平台选择ios，输入http://localhost:8100，点击connect，后面同安卓
jdk安装配置
1、下载：\\172.16.15.89\02_Tools\test\jdk-11.0.10_windows-x64_bin.exe
2、安装：一路下一步，按默认配置安装即可
3、环境变量中先新建JAVA_HOME变量，写入jdk的安装目录
4、再把bin和jre的bin配置到Path变量中
allure安装配置
1、下载：\\172.16.15.89\02_Tools\test\allure-2.13.9.zip
2、将zip文件解压到E盘
3、把allure的bin目录配置到环境变量的Path变量中
二、安卓相关
adb安装配置
1、下载：\\172.16.15.89\02_Tools\test\platform-tools.zip
2、把platform-tools文件夹放在任意目录下，并把platform-tools目录添加到系统 PATH 路径里
3、打开cmd，输入adb devices，可以看到连上的手机id则代表成功
三、ios相关
itunes安装及使用（windows）
1、安装：在电脑的微软商店应用中搜索并安装即可
2、打开itunes，同意使用iphone
3、手机上会弹出是否信任电脑的弹窗，点击信任
webdriveragent应用安装
1、连上手机，手机端会有要求信任的弹窗，点击信任
2、启动xcode，打开WebDriverAgent工程
3、点击顶部栏的Product-Destination，选择你的手机
4、点击顶部栏的Product-Test，会开始安装
5、第一次安装完会报错，这时候只要去手机的设置-通用-描述文件与设备管理，信任Apple Development的证书
6、重新点击顶部栏的Product-Test，等xcode顶部显示“Testing WebDriverAgentRunner”就可以了，这时候关闭xcode就行
tidevice安装及使用
1、安装：
已包含在python依赖库中
2、验证：
1）连接iphone
2）打开cmd，输入tidevice list，回车后输出以下结果代表安装成功
PS：附上tidevice的简单介绍，https://testerhome.com/opensource_projects/tidevice，简单来说就是对标安卓的adb
四、代码运行方式
1、直接修改根目录下的配置文件config.yaml中的device_id，在顶层目录中通过pytest tests\ios\cases\test_launch.py 或pytest tests\android\cases\test_launch.py命令运行指定的用例（pytest还有别的执行粒度，大家可以百度一下）
2、在顶层目录中通过 python run.py -p 平台 -s 设备id 命令运行特定平台的所有用例
五、用例编写方式
1、先编写用例相关的page类
2、再根据page类的方法编写具体的用例
PS：安卓和ios的page类和用例记得要分开编写
