aduir / ios-perf

A iOS APP Performance Testing Tool. 这是一款iOS性能监控工具，支持Mac以及Windows端运行，电脑通过USB连接手机后运行脚本即可。本项目基于jlintxia开源的iOS测试方案修改而来，增加动态建表，动态增加grafana面板以及docker打包环境等特性。其中iOS性能数据来源于开源工具tidevice和py-ios-device。

iOS-perf

READ IN ENGLISH

这是一款iOS性能监控工具，支持Mac以及Windows端运行，电脑通过USB连接手机后运行脚本即可。

当前支持获取的性能数据包括GPU、CPU、内存、FPS、功耗、网络、温度，以及一系列手机硬件数据，并将根据需求继续新增。

本项目基于jlintxia开源的iOS测试方案修改而来，增加动态建表，动态增加grafana面板以及docker打包环境等特性。其中iOS性能数据来源于开源工具tidevice和py-ios-device。

注意：本项目依赖MySQL进行性能数据存储，Grafana进行数据动态展示，也就是说需要在本机或者可达的网络（比如公司局域网） 上搭建MySQL+Grafana服务，我提供了一份docker-compose.yml文件，可以使用docker快速搭建一套环境。

效果展示

准备工作

服务端搭建依赖docker以及docker-compose，安装指南：

https://dockerdocs.cn/get-docker/

https://dockerdocs.cn/get-started/08_using_compose/

运行测试依赖python3环境，安装指南：

https://www.python.org/downloads/

服务端搭建

命令行运行

docker -v && docker-compose -v

如果能正常输出版本，如下，则表示docker环境正常，可以继续

Docker version 20.10.8, build 3967b7d

docker-compose version 1.29.2, build 5becea4c

拉取镜像并启动服务：

docker-compose up -d  

提示：初次打开Grafana时，系统会提示你修改密码，为了方便建议不修改，即保持账号密码均为admin，否则在python运行指令中将要进行对应的传参。

本地环境搭建

命令行执行

pip install -r requirements.txt

运行命令

命令行执行：

python run.py --udid=00008110-001A4D483CF2801E \
--bundleid=com.apple.Preferences \
--grafana_host=localhost \
--grafana_port=30000 \
--grafana_user=admin \
--grafana_password=admin \
--mysql_host=localhost \
--mysql_port=33306 \
--mysql_username=root \
--mysql_password=admin \
--mysql_db=iOSPerformance

运行参数说明

建议修改参数

• --bundleid：待测APP的包名，通过ideviceinstaller -l获取，默认值为com.apple.Preferences
• --udid iPhone：手机的唯一标识符，通过 idevice_id -l 获取，客户端只连接一台手机时不用写

Grafana可选参数

• --grafana_host：Grafana的主机地址，只写ip，不用写Scheme，也就是http://或者https//，默认值localhost
• --grafana_port：Grafana的端口号，默认值30000
• --grafana_user：Grafana的用户名，默认值admin
• --grafana_password：Grafana的密码，默认值admin

MySQL可选参数

• --mysql_host：MySQL的主机地址，不用写Scheme，也就是http://或者https//，默认值localhost
• --mysql_port：MySQL的端口号，默认值33306
• --mysql_user：MySQL的用户名，默认值root
• --mysql_password：MySQL的密码，默认值admin

数据导出

命令行执行：

python mysql.py --runid=iphone6_1008_1532 \
--mysql_host=localhost \
--mysql_port=33306 \
--mysql_username=root \
--mysql_password=admin \
--mysql_db=iOSPerformance

其中，--runid为必须参数，可以从显示测试数据的Grafana页面的左上角找到，通常为手机名称+月日+时分。其余Mysql参数均为可选参数，默认值与上方MySQL可选参数相同。