Android UIAutomator Server 使用教程

项目介绍

Android UIAutomator Server 是一个用于 Android UI 自动化测试的开源项目。它通过在 Android 设备上运行一个轻量级的 JSON-RPC 服务器，使得用户可以在 PC 端编写脚本来执行 UI 测试，而无需编写和编译 Java 代码。该项目简化了 UI 测试的流程，使得测试人员可以更高效地进行自动化测试。

项目快速启动

环境搭建

1. 克隆项目仓库：

   git clone https://github.com/openatx/android-uiautomator-server.git
   cd android-uiautomator-server
   

2. 编译项目：

   ./gradlew build
   ./gradlew packageDebugAndroidTest
   

3. 安装 APK 到设备：

   adb install app/build/outputs/apk/debug/app-debug.apk
   adb install app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk
   

4. 启动 JSON-RPC 服务器：

   adb forward tcp:9008 tcp:9008
   adb shell am instrument -w -r -e debug false -e class com.github.uiautomator.stub.Stub com.github.uiautomator.test/androidx.test.runner.AndroidJUnitRunner
   

示例代码

以下是一个简单的示例，展示如何使用 curl 命令与 JSON-RPC 服务器进行交互：

curl -X POST -d '["jsonrpc": "2.0", "id": "1f0f2655716023254ed2b57ba4198815", "method": "deviceInfo", "params": []]' 'http://127.0.0.1:9008/jsonrpc/0'

应用案例和最佳实践

百度搜索自动化

通过编写脚本自动打开百度应用，输入搜索关键词并执行搜索操作。

微信相关

自动化测试微信的登录、消息发送等功能。

确定类按钮

自动化点击各种确定类按钮，如弹窗中的“确定”按钮。

广告类弹框

自动化处理应用中的广告弹框，如点击“关闭”按钮。

Vivo自动安装app

自动化在 Vivo 设备上安装应用。

Vivo账号自动登录

自动化在 Vivo 设备上进行账号登录操作。

奇虎360自动登录账号

自动化在奇虎360应用中进行账号登录。

典型生态项目

weditor

一个用于 UI 自动化测试的 Web 界面工具，可以实时查看和编辑 UI 元素。

adb

Android Debug Bridge，用于与 Android 设备进行通信的命令行工具。

android-uiautomator-server

本项目本身，用于在 Android 设备上运行 JSON-RPC 服务器，实现 UI 自动化测试。

uiautomator

Google 提供的用于 Android UI 自动化测试的原生工具。

通过以上模块的介绍和示例，您可以快速上手并深入了解 Android UIAutomator Server 的使用和应用场景。