alipay/SoloPi

这是什么？

核心功能

• 01在 Android 真机上录制并回放界面操作。
• 02回放时对界面节点和图片进行断言。
• 03实时或录制式采集 CPU、内存、FPS、电量、温度和网络数据。
• 04测量应用冷启动与暖启动耗时。
• 05通过一台主机设备控制多台从机设备。
• 06支持带页面状态校验的类型化 Agent 动作，并由独立判定器给出测试结论。

适用场景

• 在多台 Android 真机上对应用核心流程做回归测试。
• 用一台主机集中控制多台设备，进行兼容性测试。
• 在限制 CPU、内存或网络的条件下测量应用启动与性能表现。
• 让 AI Agent 在 CI 流程中执行设备测试，并保留可审计的证据。

快速上手

1. 1

   从源码运行本地 CLI 列出动作（无需设备）

   ./solopi-skill/scripts/solopi-ai --pretty actions
2. 2

   在虚拟环境中安装 CLI

   python -m pip install -e ./solopi-skill/scripts/harness
3. 3

   构建 solopi-app 测试及调试 APK

   ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug

使用前须知

• !开源的设备端实现仅支持 Android。
• !运行需要一台已授权 USB 或无线 ADB 调试的 Android 真机。
• !构建文档基于较旧的工具链，如 Android Studio 4.0、Gradle 6.1.1 和 NDK 16。
• !一机多控功能尚未开源。

收录于专题

标签

常见问题

SoloPi 是什么？

面向 Android 真机的开源移动端自动化测试工具，支持录制回放、断言、性能采集，并提供 Agent 测试 Harness。 SoloPi 是一款面向移动应用测试的开源自动化工具。它可以在 Android 真机上录制点击、输入、滚动和断言等操作，并在同一台或其他设备上回放，无需在手机上以外的环境单独完成录制。工具还能采集 CPU、内存、FPS、电量、温度和网络流量等性能指标，并测量应用的冷启动与暖启动耗时。

SoloPi 可以免费使用吗？用的什么许可证？

SoloPi 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

SoloPi 还在维护吗？

活跃维护中。SoloPi 最近一次提交是在 2026年11月5日。

SoloPi 适合用来做什么？

在多台 Android 真机上对应用核心流程做回归测试。 用一台主机集中控制多台设备，进行兼容性测试。 在限制 CPU、内存或网络的条件下测量应用启动与性能表现。 让 AI Agent 在 CI 流程中执行设备测试，并保留可审计的证据。

SoloPi 怎么安装和运行？

从源码运行本地 CLI 列出动作（无需设备）: ./solopi-skill/scripts/solopi-ai --pretty actions 在虚拟环境中安装 CLI: python -m pip install -e ./solopi-skill/scripts/harness 构建 solopi-app 测试及调试 APK: ./solopi-app/gradlew -p solopi-app :app:testDebugUnitTest :agentmodel:testDebugUnitTest :portal:assembleDebug

在哪里获取 SoloPi？

源代码和安装说明在 GitHub 上：https://github.com/alipay/SoloPi