SoloX 手机性能分析 Python工具

SoloX 手机性能分析 Python工具

项目详情请见压缩包内的 HTML 文件。

 简介

SoloX 是一款基于 Web 的 Android / iOS 性能数据采集与分析工具,

   可以在设备 无需 ROOT / 越狱 的前提下实时收集各类关键性能指标,
   帮助快速定位性能瓶颈,提升应用整体体验。

工具采用即插即用的方式,通过桌面环境、命令行或接口调用即可完成数据采集,
   适合个人调试、团队性能分析以及集成在自动化平台中使用。

 环境要求

  • Python 3.10 运行环境

  • 已安装 adb 并配置好环境变量(SoloX 自带的 adb 不一定适配所有电脑,建议自行安装)

  • Windows 用户如需测试 iOS,需要先安装 iTunes(当前不支持 iOS 17)

安装方式(概览)

  • 通过 pip 安装最新版本的 solox 包,或指定版本号进行安装

  • 在网络环境不佳的情况下,可以选择使用镜像源安装(可能不是最新版本)

启动与访问

  • 默认情况下可通过命令行直接以模块方式启动 SoloX 服务

  • 支持自定义监听地址和端口,方便在局域网内访问不同机器上的服务

 使用 Python 收集性能数据

项目提供了 Python API,可通过设备管理类获取设备与进程信息,
   然后使用性能监控类按需收集 CPU、内存、网络、FPS、电池、GPU、磁盘、温度等指标,
   既可以单独拉取某项数据,也可以一次性收集全部指标并生成报告。

同时支持在独立脚本中主动停止服务、控制采集时长和是否录制等参数,
   方便嵌入到现有测试脚本或工具中。

 使用 API 收集性能数据

SoloX 支持以后台服务形式运行,通过 HTTP 接口收集 Android 和 iOS 设备的性能数据。
   可以在终端中以后台方式启动服务,再通过构造请求参数调用对应接口获取 CPU、内存、网络等指标,
   非常适合集成到 CI/CD 流程或其他后端服务中。

功能亮点

  • 无需 ROOT / 越狱:Android 设备无需 ROOT,iOS 设备无需越狱即可完成性能采集。

  • 指标完备:
         支持 FPS、Jank、CPU、GPU、内存、耗电、网络、磁盘等多项指标,便于全面分析性能状况。

  • 可视化看板:
         通过 Web 报告看板查看、存储和管理不同版本 SoloX 收集的测试数据,支持可视化展示与下载。

  • 灵活监控配置:
         支持设置告警阈值、采集时长,以及访问其他电脑上连接的移动设备。

  • 对比模式:
         支持两台设备或两个应用的对比测试,例如:

    • 2-devices:两台不同设备测试同一个 App

    • 2-apps:两台配置相同的设备测试两个不同 App

  • API 集成:
         支持使用 Python 或 HTTP API 收集性能数据,便于嵌入自动化测试、持续集成流水线中。

推荐环境

浏览器:Chrome 等现代浏览器。

终端:
   Windows 推荐 PowerShell;macOS 推荐使用 iTerm2 之类的增强终端工具。

致谢与联系

项目在实现过程中参考和使用了多个开源工具与组件,例如 iOS 设备调试工具、远程投屏与控制工具等,
   在详情 HTML 中有完整的致谢列表。

如需与作者交流,可以关注相关公众号并通过私信方式联系,作者看到后会进行回复。<br/>微信图片_20251114235855_76_551.png