/iOS-perf

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

Primary LanguagePython

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快速搭建一套环境。

效果展示

gif

准备工作

服务端搭建依赖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可选参数相同。