Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地

一 . 前言

由于IOS系统比Android系统相对封闭,所以进行IOS自动化测试也是相对复杂,不过大家不用担心,小编已经帮你们踩了大部分坑,网上大部分文章都是CV过来的,没有真正的从0到1落地,我们需要具备开源精神,只为让更多的小伙伴们少走弯路,欢迎大家在留言区评论交流!

二 . 环境依赖

*mac
*xcode
*python
*pycharm
*appium
*pytest
*jdk1.8
*allure
*git
*node
*jenkins
*npm or cnpm
*ios-deploy
*brew
*libimobiledvice
*carthage
*ios phone
*apple id
*webdriveragent

三 . 环境配置

1. 安装xcode

方式一:

如果已经升级至最新macOS系统,可以直接通过App Store安装最新版本的Xcode

方式二:

如果不想升级最新macOS系统,可以使用离线包的形式安装,安装地址:Xcode 版本(官方)

2. 安装python

小编这边采用的是python3.9,需要使用其他版本也可以,建议3.6+,安装地址:python3.9(官方)

3. 安装pycharm

下载社区版本免费,一般满足我们日常使用,安装地址:pycharm(官方)

4. 安装appium

小编这边采用的是appium 1.17.1,下载 Appium-mac-1.17.1.dmg 包即可, 安装地址:github appium 1.17.1(官方)

4.1 下载appium命令版,需要先安装npm,在文章后面有介绍

版本:1.17.1
终端:sudo npm install --unsafe-perm=true --allow-root -g [email protected]

4.2 配置appium GUI版本

版本:1.17.1
参数:{
“bundleId”: “被测应用”,
“platformName”: “iOS”,
“platformVersion”: “15.2”,
“deviceName”: “设备名称”,
“automationName”: “XCUITest”,
“udid”: “可以使用xcode查询”
}

5. 安装pytest

打开已安装的Pycharm左下角,在Terminal打开当面目录下的命令行窗口,输入命令:

pip install pytest

6. 安装jdk1.8

6.1 使用allure报告或Android SDK必须依赖Java环境,下载dmg包进行安装即可,安装地址: oracle jdk1.8(官方)
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第1张图片

6.2. 配置JDK环境变量

6.2.1 如果此前建过.bash_profile隐藏配置文件,直接在终端输入$ open -e .bash_profile打开文件即可,如果没有则输入下方命令

$ touch .bash_profile

6.2.2 输入下方命令打开此文件

$ open -e .bash_profile

6.2.3 打开.bash_profile文件输入环境配置参数,将下方参数放入其中,并保存(如果用的是vi打开的按esc 输入:wq退出如果是文本直接command + S)退出即可,JAVA_HOME是JDK安装路径,然后保存

JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
PATH=$JAVA_HOME/bin:$PATH:.
CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:.
export JAVA_HOME
export PATH
export CLASSPATH

6.2.4 输入以下命令使配置文件生效

$ source .bash_profile

6.2.5 最后检查下环境变量是否配置成功

$ echo $JAVA_HOME

Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第2张图片
6.2.6 查询JDK版本信息

$ java -version

Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第3张图片
7. 安装allure

7.1 allure官网

	http://allure.qatools.ru/

7.2 allure下载地址,小编版本使用的是2.19.0

https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline/2.19.0/

7.3 allure运行原理

allure属于第三方工具,展现更好看的测试报告,allure服务兼容pytest生成allure能识别的json文件,类似于 Apache ECharts你负责提供 ECharts能识别的json数据, ECharts负责展示不同的可视化图表

7.4 allure使用

7.4.1 下载zip包,默认在mac /users/用户/Downloads,然后解压到任意目录

7.4.2 配置环境变量,打开终端

$ open -e .bash_profile

添加此内容,和上面配置JDK环境变量一样

#allure 2.19.0
export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin
export PATH=${PATH}:/Users/用户/allure-2.19.0/bin

PATH更换自己的,然后保存退出即可

7.4.3 验证allure环境变量是否安装成功

$ allure --version

在这里插入图片描述

7.4.4 结合pytest生成json测试文件

7.4.4.1 安装三方库

pip install allure-pytest

7.4.4.2 生成json测试文件,在pytest.ini文件中配置

[pytest]
addopts = -vs --alluredir ./temp

会自动生成json文件
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第4张图片

在主函数中添加产生报告的代码 ,注意:路径应该与json测试文件路径保持一致

if __name__ == '__main__':
    pytest.main(["-vs", "test_case/test_all.py", '--clean-alluredir', '--alluredir=./temp'])
    os.system("allure generate ./temp -o ./report --clean")

打开自动生成的report目录下index.html即可
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第5张图片
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第6张图片
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第7张图片

8. 安装git

方式一:

一般Xcode安装好后不需要再单独安装Git,Xcode自带git

方式二:

可以先安装后面的brew再安装git,终端输入该命令即可

brew install git

验证git是否安装成功,终端输入该命令即可

git --version

在这里插入图片描述

9. 安装node

说明:安装就有npm命令了,可以使用npm -v 查询是否安装成功,node -v 验证node.js版本
地址: node.js(官方)
版本:12.15.0

10. 安装jenkins

使用brew安装可能会存在更新的问题,小编这边使用包安装方式
安装地址:jenkins(官方)
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第8张图片Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第9张图片

11. 安装npm or cnpm

说明:中国版的npm,速度更快
版本:5.2.0
终端:npm install -g cnpm --registry=https://registry.npm.taobao.org
提示:added 845 packages from 976 contributors in 11.97s,表示安装成功

12. 安装ios-deploy

说明:用于转发xcode的ip地址,对于一些国外的ios我们需要转发端口
终端:cnpm install -g ios-deploy

提示:** BUILD SUCCEEDED **表示安装成功

13. 安装brew

说明:使用终端命令brew -v去查看电脑是否已经安装,一般mac会自带,如果没有自行安装
版本:1.9.1
终端:ruby <(curl -fsSKL raw.github.com/mxcl/homebrew/go)

14. 安装libimobiledvice

说明:真机调试,检查是否连接设备,类似于安卓adb
终端:brew install --HEAD libimobiledevice

15. 安装carthage

说明:webdiverAgent需要
终端:brew install carthage

16. 注册apple id

说明:app store下载xcode时会跳出登录弹框
使用公司公共账号也可以,后续该账号需要加入公司开发者团队,一个团队可以加100个开发者账号
注册地址:注册apple id(官方)

17. 安装webdriveragent

原理:appium->WebDriverAgent->XCUITest
iOS 9 之前一直以 instruments 下的 UIAutomation 为驱动底层技术(弊端由于 instruments 的限制,单台 mac 只能对应单台设备);
iOS 9.3 时代推出 XCUITest 工具,用以替代 UIAutomation;
iOS 10 时代苹果直接废弃了 UIAutomation,Facebook 推出 WebDriverAgent(实现的 server 能够支持单台 mac 对应多个设备);
Appium 在 iOS 9.3 后全面采用 WebDriverAgent 的方案;
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第10张图片
facebook下载地址:https://github.com/facebookarchive/WebDriverAgent
WebDriverAgent2年前facebook已不在维护!!!本人使用appium分支
appium下载地址:https://github.com/appium/WebDriverAgent
下载完成后终端进入该目录(你桌面WebDriverAgent项目的地址):cd /Users/用户名/Desktop/WebDriverAgent-master
终端:./Scripts/bootstrap.sh
最后使用xcode打开WebDriverAgent项目的WebDriverAgent.xcodeproj文件进行配置

Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第11张图片
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第12张图片
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第13张图片配置完成之后,真机连接mac,使用command+u运行,ios上会自动安装一个runner程序,这是我们需要去手机设置描述文件信任该程序,运行成功后xcode控制台打印已下信息表示成功
Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第14张图片

18. 使用脚本获取driver对象

18.1 添加依赖 requirements.txt

allure_python_commons==2.8.19
Appium_Python_Client==0.46
HTMLTestRunner==0.8.0
pytest==6.2.5
selenium==3.141.0

18.2 恭喜你,到最后一步了,一段简单的代码,只是为了测试IOS自动化测试环境是否搭建成功

import time
from appium import webdriver
from tools.LoggerUtil import LoggerUtil

logger = LoggerUtil()

class InitDevices(object):
    driver: webdriver = None

    @classmethod
    def start(cls, port: str, ip: str = '127.0.0.1', **kwargs):
        caps = {
            'bundleId': '填写你需要测试的app bundleId ',
            'platformName': 'iOS',
            'platformVersion': '14.4',
            'deviceName': 'iPhone',
            'automationName': 'XCUITest',
            'udid': '00008020-001434C42232002E',
            'newCommandTimeout': '21600'
        }
        if kwargs:
            for k, v in kwargs.items():
                caps[k] = v
                logger.info("{} 我是主函数的驱动参数".format(caps))
            cls.driver = webdriver.Remote(f"http://{ip}:{port}/wd/hub", caps)
            cls.driver.implicitly_wait(10)
            logger.info("---连接设备成功---")
            logger.info("{} 我是主函数的driver".format(cls.driver))
            return cls.driver
        else:
            logger.info("{} 我是主函数的驱动参数".format(caps))
            cls.driver = webdriver.Remote(f"http://{ip}:{port}/wd/hub", caps)
            cls.driver.implicitly_wait(10)
            logger.info("---连接设备成功---")
            logger.info("{} 我是主函数的driver".format(cls.driver))
            return cls.driver

    @classmethod
    def quit(cls):
        """
        关闭driver对象
        :return:
        """
        cls.driver.quit()

if __name__ == '__main__':
    comm = InitDevices.start('4723', noReset=True)
    time.sleep(1)
    comm.quit()

注意:连接设备后一定要quit()关闭连接,不然下次连接会出现端口占用的情况,本地运行不报错,控制台返回driver对象即成功了!

Appium+Python+Pytest+Allure+Git+Node+Jenkins+Xcode IOS自动化测试从0到1落地_第15张图片

你可能感兴趣的:(python,pytest,git,自动化,测试工具)