YADB - ADB 功能增强工具
March 11, 2026 · View on GitHub
YADB 是一个基于原生 ADB (Android Debug Bridge) 进行扩展的实用工具,弥补了 ADB 在输入法、截屏、界面抓取等方面的不足,提供更加高效、精准的操作能力。
功能简介
中文输入
解决 adb shell input text 无法输入中文的问题,支持任意文本输入。
adb push yadb /data/local/tmp
adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -keyboard 你好,世界
读取剪贴板
直接读取设备当前剪贴板内容。
adb push yadb /data/local/tmp
adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -readClipboard
写入剪贴板
将指定文本写入设备剪贴板。
adb push yadb /data/local/tmp
adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -writeClipboard 文本
强制截屏
无需考虑应用禁截屏限制,直接获取当前屏幕截图。
adb push yadb /data/local/tmp
adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -screenshot
高效布局抓取
替代 uiautomator dump,可获取某些特殊页面的完整界面布局。
adb push yadb /data/local/tmp
adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -layout
屏幕长按操作
实现自动化测试中需要的长按功能。
adb push yadb /data/local/tmp
adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -touch 500 500 2000
长按拖拽
可用于需要先长按选中元素,然后再拖拽到新位置的场景。
# 参数: 起点X 起点Y 终点X 终点Y 长按时长(ms) 拖拽时长(ms)
adb push yadb /data/local/tmp & adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -longPressDrag 500 500 500 1000 2000 1000
无惯性滑动
替代原生 input swipe,采用减速插值,消除列表滑动的惯性,实现指哪停哪。
# 参数: 起点X 起点Y 终点X 终点Y 耗时(ms)
adb push yadb /data/local/tmp & adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -swipe 100 1000 100 500 1000
双指缩放 (Pinch)
模拟双指捏合(缩小)或张开(放大)操作。
# 参数: 中心点X 中心点Y 起始间距(px) 结束间距(px) 耗时(ms)
# 缩小 (Pinch In): 间距由 800px 缩小至 200px
adb push yadb /data/local/tmp & adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -pinch 540 960 800 200 500
# 放大 (Pinch Out): 间距由 200px 扩大至 800px
adb push yadb /data/local/tmp & adb shell app_process -Djava.class.path=/data/local/tmp/yadb /data/local/tmp com.ysbing.yadb.Main -pinch 540 960 200 800 500
许可证
许可证
本项目遵循 LGPLv3 许可证。