一、简介
SoloX是一个可以实时收集Android/iOS性能数据的web工具。 快速定位分析性能问题,提升应用的性能和品质。 无需ROOT/越狱,即插即用。
主要特点:
无需ROOT/越狱: Android设备无需Root,iOS设备无需越狱。有效解决Android和iOS性能的测试和分析挑战。
数据完整性:我们提供CPU、GPU、内存、电池、网络、FPS、卡顿等数据,您可以轻松获取。
精美报告:精美详细的报告分析,无论您身在何处或何时,都可以在何处存储、可视化、编辑、管理和下载使用 SoloX 收集的所有测试用例。
实用的监控设置:监控过程中支持设置报警值、采集时长、在其他PC机上访问移动设备。
PK模型:支持两台移动设备同时对比测试。
🌱2 设备:在两部不同的手机上测试同一个应用程序。
🌱2-apps:在具有相同配置的两部手机上测试两个不同的应用程序。
数据收集:支持Python和API收集性能数据,帮助用户轻松集成到自动化测试流程中。
github地址:https://github.com/smart-test-ti/SoloX?tab=readme-ov-file
二、环境要求
安装Python 3.10 + Download
安装adb并配置环境变量(SoloX的adb不一定适合你的电脑)Download
💡 Python 3.6 ~ 3.9,请下载低于2.5.4的solox版本。
💡如果Windows用户需要测试ios,请安装并启动Itunes。Documentation
三、安装部署
默认安装:
pip install -U solox (指定版本:pip install solox=={version})
镜像安装:
pip install -i https://mirrors.ustc.edu.cn/pypi/web/simple -U solox
启动服务:
python -m solox
启动服务自定义IP地址和端口:python -m solox --host={ip} --port={port}
浏览器建议:谷歌
终端:
窗口:PowerShell
macOS:iTerm2 (https://iterm2.com/)
四、使用方法
4.1 通过浏览器直接使用
(1)单设备收集
使用python -m solox启动服务后,将自动使用本机默认浏览器打开solox页面。
接入手机设备后,可以在左上方选择设备、应用包名、进程名,并点开始即可开始收集性能数据。本示例以快看漫画为例。
开始收集数据:
停止数据收集,将自动跳转到报告页面,可以查看分析报告、导出、编辑、删除报告。
查看分析报告,可以另存为png文件。
(2)2-devices: 使用两台不同的设备测试同一个app(需切换到PK Model)
(3)2-apps: 使用两台配置相同的设备测试两个不同的app。操作方法类似,不再赘述。
(4)iOS操作方法同上
4.2 使用Python收集
from solox.public.apm import APM
# version : >= 2.8.5,由于本地Python是3.9的,不想重新装一个3.10,所以用的低版本SoloX
# from solox.public.apm import AppPerformanceMonitor
from solox.public.common import Devices
d = Devices()
processList = d.getPid(deviceId='172.16.135.133:5555', pkgName='com.kuaikan.comic') # for android
print(processList)
apm = APM(pkgName='com.kuaikan.comic', platform='Android', deviceId='172.16.135.133:5555', surfaceview=True)
# apm = APM(pkgName='com.bilibili.app.in', platform='iOS') only supports one device
# surfaceview: False = gfxinfo (手机开发者 - GPU渲染模式 - adb shell dumpsys gfxinfo)
# noLog : False (为false时才会存储测试数据到log文件中)
# ************* 收集单个性能指标 ************* #
cpu = apm.collectCpu() # %
memory = apm.collectMemory() # MB
flow = apm.collectFlow() # KB
fps = apm.collectFps() # HZ
battery = apm.collectBattery() # level:% temperature:°C current:mA voltage:mV power:w
# gpu = apm.collectGpu() # % only supports ios
# ************* 收集全部的性能指标 ************* #
# if __name__ == '__main__':
#
# apm = APM(pkgName='com.kuaikan.comic', platform='Android', deviceId='172.16.135.133:5555', surfaceview=True) # duration : 秒 (持续执行时间) record: 是否录屏(只支持安卓)
# # apm = APM(pkgName='com.bilibili.app.in.ios', platform='iOS', deviceId='xxxx',noLog=False, duration=20)
#
# apm.collectAll() # 会生成HTML报告
输出结果:
4.3 使用API收集
在后台启动服务:
# solox version >= 2.1.5
macOS/Linux: nohup python3 -m solox &
Windows: start /min python3 -m solox &
向api请求apm数据:
Android: http://{ip}:{port}/apm/collect?platform=Android&deviceid=ca6bd5a5&pkgname=com.bilibili.app.in&target=cpu
iOS: http://{ip}:{port}/apm/collect?platform=iOS&pkgname=com.bilibili.app.in&target=cpu
target in ['cpu','memory','memory_detail','network','fps','battery','gpu']