**Minitouch 使用指南**

Minitouch 使用指南

minitouch 项目地址: https://gitcode.com/gh_mirrors/min/minitouch

---

1. 项目介绍

Minitouch 是一款极简的多点触控事件生成工具，专为 Android 设备设计。它允许开发者或测试人员通过Socket接口触发复杂的触摸事件和手势，无需Root权限即可在Android SDK 25及以下版本上运行（尽管它兼容所有版本，但SDK 20即Android Wear需要Root）。最低支持的SDK级别为10，涵盖Android 2.3.3。Minitouch特别适用于HTML5多点触控场景，并且相比于Android Monkey工具，它可以操控屏幕上的任何区域，包括软件按钮。

2. 项目快速启动

环境准备

确保安装了Android NDK（至少需NDK Revision 10），并且拥有相应设备的ADB访问权限。

编译与安装

1. 克隆项目到本地：

   git clone https://github.com/DeviceFarmer/minitouch.git
   

2. 初始化并更新子模块：

   git submodule init
   git submodule update
   

3. 使用NDK进行编译：

   ndk-build
   

4. 运行准备：

   • 确定设备ABI：

     ABI=$(adb shell getprop ro.product.cpu.abi | tr -d '\r')
     

   • 将对应ABI的二进制文件推送到设备：

     adb push libs/$ABI/minitouch /data/local/tmp/
     

5. 连接设备并使用minitouch：

   • 对于API 29及以上版本，可能需特殊处理，详情参考官方文档。
   • 基本运行命令：

     adb shell /data/local/tmp/minitouch
     

   • 若要通过Socket连接，则需执行adb forward命令建立转发：

     adb forward tcp:1111 localabstract:minitouch
     

   • 使用nc或telnet等工具连接到localhost的1111端口，发送控制命令。

3. 应用案例和最佳实践

模拟多点触控测试

假设你需要模拟一个双指缩放操作，你可以通过发送以下命令序列：

1. 建立Socket连接后，发送两个触控点下压指令：

   d 0 100 100 50
   d 1 200 200 50
   

2. 接着，进行一次移动操作以模拟缩放效果：

   m 0 120 120 50
   m 1 180 180 50
   

3. 最后提交这些改变来实现屏幕动作：

   c
   

自动化测试集成

Minitouch非常适合集成到自动化测试脚本中，用于模拟用户交互。例如，在UI自动化测试框架中，可以通过脚本自动发送上述命令序列，实现对应用程序的多点触控功能测试。

4. 典型生态项目

Minitouch经常与其他Android开发、调试、或测试工具共同使用，如STF(Service Tree Foundation)，后者提供远程管理Android设备的能力。当结合STF时，Minitouch可以更加方便地在无根设备上进行触控事件模拟，特别是在大规模的设备管理和自动化测试场景中。

---

请注意：实际应用中应详细阅读项目最新文档，因为依赖项、命令语法或功能可能会随时间更新变化。此外，对于敏感的生产环境，请先在非关键设备上进行充分的测试。

minitouch 项目地址: https://gitcode.com/gh_mirrors/min/minitouch