简介

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 中有完整的致谢列表。

如需与作者交流，可以关注相关公众号并通过私信方式联系，作者看到后会进行回复。

下载地址