ADB命令实现Android远程文本输入与自动化测试-代码聚汇网

ADB命令实现Android远程文本输入与自动化测试

Gnocchiiii

1. 自动化测试中的远程文本输入方案解析

在移动端自动化测试和远程控制场景中，准确获取屏幕文本信息并实现精准输入是一个常见需求。特别是在远程真机调试、自动化测试脚本编写等场景下，当图形界面不可见或无法直接操作时，通过ADB命令直接与设备UI元素交互就成为了关键技术手段。

这个方案的核心价值在于：

绕过图形界面限制，直接操作UI元素
实现精准的文本输入和控件交互
适用于黑屏、远程桌面等特殊场景
为自动化测试提供可靠的底层操作支持

2. 完整技术实现流程详解

2.1 环境准备与设备连接

在开始操作前，需要确保：

已安装Android SDK并配置好ADB环境
目标设备已开启USB调试模式
设备通过USB或网络连接到开发机
已获取设备shell权限（adb shell可正常执行）

验证连接状态：

bash复制adb devices

应能看到目标设备序列号，状态为"device"。

2.2 UI结构获取与解析

2.2.1 导出UI层次结构

核心命令：

bash复制adb shell uiautomator dump /sdcard/screen.xml

这个命令会将当前屏幕的UI层次结构导出为XML文件，存储在设备的/sdcard/目录下。其工作原理是：

调用Android系统的UI Automator服务
遍历当前Activity的视图层次结构
生成包含所有UI元素信息的XML文件

注意：执行此命令需要设备屏幕处于唤醒状态，且可能需要等待1-2秒完成dump操作

2.2.2 拉取XML文件到本地

使用pull命令将生成的XML文件传输到开发机：

bash复制adb pull /sdcard/screen.xml ./screen.xml

2.2.3 解析XML文件结构

典型的UI元素节点结构如下：

xml复制<node index="0" 
      text="WiFi名称" 
      resource-id="com.android.settings:id/ssid" 
      class="android.widget.TextView" 
      bounds="[102,492][258,630]"/>

关键属性说明：

属性名称	说明	示例
text	控件显示的文本内容	"WiFi密码"
resource-id	控件的唯一标识符	com.android.settings:id/password
class	控件类型	android.widget.EditText
bounds	控件在屏幕上的坐标范围	[102,492][258,630]

2.3 文本输入实现方案

2.3.1 直接文本输入

对于单个输入框场景，最简单的方式是：

bash复制adb shell input text "your_text_here"

技术细节：

文本会自动输入到当前获得焦点的输入框
仅支持ASCII字符和部分特殊符号
不支持空格（空格会被视为命令分隔符）
最大长度受系统输入法限制

2.3.2 精准定位输入

对于多个输入框或需要精确控制的场景，操作流程：

通过bounds坐标定位目标控件：

bash复制adb shell input tap x y

其中x和y是控件中心点坐标，可通过bounds值计算：

code复制x = (left + right) / 2
y = (top + bottom) / 2

输入文本内容：

bash复制adb shell input text "your_text"

重复上述步骤操作其他输入框

2.3.3 特殊字符处理

对于包含空格的文本，推荐解决方案：

使用KEYCODE_SPACE模拟空格：

bash复制adb shell input text "first"
adb shell input keyevent KEYCODE_SPACE
adb shell input text "second"

或者使用引号包裹（部分设备支持）：

bash复制adb shell input text '"text with spaces"'

2.4 提交操作实现

2.4.1 回车键提交

对于支持回车确认的表单：

bash复制adb shell input keyevent KEYCODE_ENTER

2.4.2 按钮点击提交

更通用的方式是通过坐标点击提交按钮：

在XML中找到提交按钮的bounds
计算中心点坐标
执行点击：

bash复制adb shell input tap x y

3. 实战案例：远程配置WiFi连接

3.1 场景分析

在远程真机调试时，连接WiFi是一个典型需求。但远程界面常会黑屏，导致无法通过图形界面输入密码。使用ADB命令可以完美解决这个问题。

3.2 操作步骤

进入WiFi设置界面（可通过Activity启动）：

bash复制adb shell am start -a android.settings.WIFI_SETTINGS

获取当前UI结构：

bash复制adb shell uiautomator dump /sdcard/wifi.xml
adb pull /sdcard/wifi.xml

解析XML找到目标WiFi的SSID节点，记录bounds
点击目标WiFi：

bash复制adb shell input tap x y

找到密码输入框的bounds
点击输入框并输入密码：

bash复制adb shell input tap x y
adb shell input text "your_password"

找到连接按钮并点击

3.3 完整脚本示例

bash复制#!/bin/bash

# 进入WiFi设置
adb shell am start -a android.settings.WIFI_SETTINGS
sleep 2

# 获取UI结构
adb shell uiautomator dump /sdcard/wifi.xml
adb pull /sdcard/wifi.xml > /dev/null

# 解析并点击目标WiFi (假设坐标已通过分析确定)
adb shell input tap 300 500
sleep 1

# 输入密码
adb shell input tap 200 600
adb shell input text "mypassword123"

# 点击连接按钮
adb shell input tap 400 700

4. 高级技巧与问题排查

4.1 性能优化建议

合并命令减少adb调用：

bash复制adb shell "input tap x y; input text 'text'; input tap x y"

使用adb exec-out获取实时输出：

bash复制adb exec-out uiautomator dump /dev/stdout > screen.xml

预加载常用坐标，避免重复解析

4.2 常见问题解决方案

问题现象	可能原因	解决方案
uiautomator dump失败	屏幕未唤醒/无权限	唤醒屏幕并重试，检查adb权限
input text不生效	输入法限制/无焦点	切换为ADB键盘，先执行tap聚焦
坐标点击不准确	屏幕分辨率变化	使用wm size获取实际分辨率
特殊字符输入异常	命令解析问题	使用KEYCODE_*事件替代

4.3 安全注意事项

密码等敏感信息建议通过变量传入，避免在脚本中明文存储
生产环境使用时，应考虑添加异常处理和日志记录
长时间操作应加入延迟，避免系统响应不及时

5. 扩展应用场景

5.1 自动化测试集成

可将此方案集成到测试框架中：

Appium底层实现
Python + pytest自动化测试
持续集成流水线

5.2 批量设备管理

通过adb同时控制多台设备：

bash复制for device in $(adb devices | grep -v List | cut -f1); do
    adb -s $device shell input text "command"
done

5.3 无障碍服务辅助

结合Android无障碍服务，可以实现更复杂的UI自动化操作。