如何快速掌握 SoloPi：Android 自动化测试终极指南

SoloPi 是一款无线化、非侵入式的 Android 自动化测试工具，专为测试开发人员设计，能够显著提升移动应用测试效率。它提供了录制回放、性能测试和一机多控三大核心功能，帮助开发者轻松应对兼容性测试、性能监控和重复性操作验证等挑战。无论你是移动应用开发者还是测试工程师，SoloPi 都能为你节省宝贵时间，让自动化测试变得更加简单高效。

项目核心亮点

为什么选择 SoloPi？以下是它能解决的关键痛点场景：

1. 录制回放功能：传统手动测试需要反复执行相同操作，耗时耗力且容易出错。SoloPi 的录制回放功能可以自动记录用户操作步骤，生成可重复执行的测试脚本。无论是游戏关卡测试还是应用功能验证，只需录制一次，就能在不同设备上无限次回放，大幅提升回归测试效率。

2. 性能测试监控：应用性能问题往往在特定场景下才会暴露，难以复现和定位。SoloPi 实时监控 CPU、内存、网络速度等关键指标，支持性能数据录制和图表分析。更重要的是，它能模拟恶劣网络环境和性能限制场景，帮助开发者提前发现潜在的性能瓶颈。

3. 一机多控兼容性测试：面对市面上数千种 Android 设备，兼容性测试工作量巨大。SoloPi 的一机多控功能允许通过一台主机设备同时控制多台从机设备，实现批量自动化测试。只需操作一次，所有设备同步执行，极大提升多设备兼容性测试效率。

4. 无线化非侵入式设计：无需 root 权限，无需修改系统设置，SoloPi 通过无线 ADB 连接实现自动化测试，保持设备原始状态的同时提供完整的测试能力。这种设计既保证了测试的准确性，又避免了设备变砖风险。

5. 开源可扩展架构：SoloPi 采用模块化设计，核心功能代码位于 src/shared/ 目录，业务逻辑在 src/app/ 中实现，便于二次开发和功能扩展。开发者可以根据自己的需求定制测试流程和功能模块。

快速上手指南

一键安装步骤

1. 环境准备：首先确保你的开发环境满足以下要求：

   • Android Studio 4.0 或更高版本
   • Gradle 6.1.1
   • CMake 3.6/3.10
   • NDK 16
   • Target API 29，Minimum API 18

   注意：构建前请关闭 Android Studio 的 Instant Run 功能，否则生成的安装包可能无法正常使用。

2. 克隆项目源码：打开终端，执行以下命令获取最新代码：

   git clone https://gitcode.com/gh_mirrors/so/SoloPi
   cd SoloPi
   

3. 配置 Android SDK 路径：下载 Android SDK Platform Tools，解压后添加环境变量：

   # Linux/macOS
   export ANDROID_SDK=/path/to/android-sdk
   
   # Windows
   set ANDROID_SDK=C:\path\to\android-sdk
   

最快配置方法

1. 开启设备开发者模式：

   • 进入手机设置 > 关于手机 > 软件信息
   • 连续点击"编译编号"7次，直到提示"您已进入开发者模式"
   • 返回设置，找到"开发者选项"，开启"USB调试"功能

   

2. 连接设备并开启无线调试：

   • 使用 USB 线连接设备到电脑
   • 在设备上允许 USB 调试请求
   • 执行命令开启无线 ADB：

   # 单设备
   adb tcpip 5555
   
   # 多设备（需要指定序列号）
   adb -s 设备序列号 tcpip 5555
   

3. 构建并安装应用：

   • 使用 Android Studio 打开项目
   • 选择 Build > Make Project 编译项目
   • 连接设备，点击 Run 按钮安装应用到手机

快速实战指南

1. 录制第一个测试用例：

   • 打开 SoloPi 应用，点击"录制回放"功能
   • 选择目标应用开始录制
   • 执行测试操作（点击、滑动、输入等）
   • 操作完成后停止录制，系统自动保存测试脚本

2. 执行性能测试：

   • 进入"性能测试"功能模块
   • 开启悬浮窗监控实时性能数据
   • 开始录制性能指标
   • 执行测试操作，结束后查看性能图表分析

   

3. 配置一机多控：

   • 确保所有设备已连接并开启无线调试
   • 在主机设备上进入"一机多控"功能
   • 扫描并连接从机设备
   • 执行操作，所有设备将同步响应

4. 查看测试结果：

   • 录制回放结果保存在 src/shared/src/main/java/com/alipay/hulu/shared/io/ 中的数据库
   • 性能数据可通过图表查看，支持导出分析
   • 测试日志实时显示，便于问题排查

进阶使用技巧与扩展

1. 自定义测试脚本转换

SoloPi 支持将录制的 JSON 格式测试脚本转换为其他自动化框架格式。访问 src/app/src/main/java/com/alipay/hulu/replay/ 查看回放引擎实现，你可以基于此开发自定义转换器，将 SoloPi 脚本转换为 Appium、Macaca 等框架可用的格式。

2. 性能测试高级配置

深入 src/shared/src/main/java/com/alipay/hulu/shared/display/ 目录，你可以找到性能监控的核心实现。这里提供了 CPU 使用率、内存占用、FPS、网络速度等监控项的完整实现。通过修改 DisplayProvider.java 和相关的工具类，可以添加自定义的性能监控指标，满足特定业务场景的需求。

3. 扩展自动化操作类型

在 src/shared/src/main/java/com/alipay/hulu/shared/node/action/ 目录中，PerformActionEnum.java 定义了所有支持的自动化操作类型。你可以通过扩展 OperationMethod.java 和 PerformActionMethodMaps.java 来添加新的操作类型，如特定的手势识别、OCR 文字识别等高级功能。

4. 多设备测试优化

一机多控功能的核心实现在 src/app/src/main/java/com/alipay/hulu/service/CaseRecordManager.java 和 CaseReplayManager.java 中。通过优化设备通信机制和同步策略，可以提升多设备测试的稳定性和执行速度。特别关注第 219 行的一机多控模式处理逻辑。

5. 无障碍服务深度集成

SoloPi 的无障碍服务实现位于 src/shared/src/main/java/com/alipay/hulu/shared/event/accessibility/。通过深入理解 AccessibilityEventTracker.java 和 AccessibilityServiceImpl.java 的工作原理，你可以扩展更多基于无障碍服务的自动化能力，如更精准的控件识别和操作。

总结与资源

SoloPi 作为一款功能全面的 Android 自动化测试工具，通过录制回放、性能测试和一机多控三大核心功能，为移动应用测试提供了完整的解决方案。其无线化、非侵入式的设计理念，使得测试过程更加便捷和安全。

关键资源路径：

• 核心业务逻辑：src/app/src/main/java/com/alipay/hulu/
• 自动化测试引擎：src/shared/src/main/java/com/alipay/hulu/shared/node/
• 性能监控模块：src/shared/src/main/java/com/alipay/hulu/shared/display/
• 事件处理系统：src/shared/src/main/java/com/alipay/hulu/shared/event/
• 数据存储管理：src/shared/src/main/java/com/alipay/hulu/shared/io/

官方文档：项目根目录下的 README.md 和 README_eng.md 提供了详细的使用说明和配置指南。

社区支持：遇到问题时，可以查看项目中的常见问题解答部分，或参与开源社区讨论获取帮助。

通过掌握 SoloPi 的各项功能，你可以显著提升 Android 应用的测试效率和质量保证能力，让自动化测试成为开发流程中的得力助手。