RobotHelper 完整上手指南免 Root 也能跑通的安卓自动化【免费下载链接】RobotHelper安卓游戏自动化脚本框架|Automated script for Android games项目地址: https://gitcode.com/gh_mirrors/ro/RobotHelperRobotHelper 是一个安卓自动化脚本框架主要解决游戏挂机、App 爬虫、UI 自动化这类需求它把点击、找图、文字识别这些最常用的动作做成了现成的接口并且自带 OpenCV 和 Tesseract OCR不需要额外搭服务端。和按键精灵这类商业软件比它更轻量、可以二次开发和 Auto.js 这类方案比它对游戏场景的支持更直接。1. 把项目跑起来的最短路径环境上只需要两样东西JDK 和 Android SDK。有这两个项目就能编译。把代码拉到本地git clone https://gitcode.com/gh_mirrors/ro/RobotHelper打开 Android 工程编译后装到手机上。如果你是新手权限模式直接选无障碍不需要 Root兼容性也最好系统设置里打开无障碍服务就能用。跑通的第一件事很简单——在脚本里点一下屏幕Robot.tap(500, 800);坐标换成你屏幕上目标按钮的位置即可。点下去之后说明点击链路已经通了后面所有功能都建立在这一步之上。2. 怎么在屏幕上精确定位一个图标游戏里大量操作的前提是找到那个按钮在哪。框架用的是多点颜色匹配你提供几个关键像素的颜色值它在整张截图里找这组颜色同时出现的位置返回坐标。核心就两行Point point Image.findPointByMulColor(ScreenCaptureUtil.getScreenCap(), 434FD7,65|0|414DDB,90|55|46CDFF,5|86|5FA119); Robot.tap(point);第一段代码在屏幕上找 Chrome 图标的颜色特征第二段直接点击找到的坐标。规则里那几个颜色,偏移的写法有固定格式不想手算的话仓库里附了一个 Python 小工具 python/imgRulesCreator.py连上 adb 后可以帮你生成规则串。3. 怎么读取界面上的文字想判断任务完成了没有、读取页面上的提示语就用内置的 Tesseract OCRString s TessactOcr.img2string(ScreenCaptureUtil.getScreenCap(0, 0, 200, 30), chi_sim, , ); MLog.info(文字识别结果 s);这段代码只识别屏幕左上角 (0,0) 到 (200,30) 的矩形区域不截全屏速度快很多。语言参数chi_sim是简体中文默认语言包只有 chi_sim 和 eng 两个需要其他语言可以自己往 assets 里放对应的语言包。识别区域越小越准这是第一条经验第二条是保证截图清晰模糊区域的识别率会明显掉。4. 怎么模拟滑动、长按和输入基础的 tap、长按、拖动、双指缩放都在 Robot 类里V2.5 之后还加了文本输入可以直接往输入框里填字。走 Root 路线的设备还可以用 sendevent/ 目录下的工具——那是用 Go 重写的安卓 sendevent常驻进程、不用每次调用都重新开文件适合批量、低频地模拟底层点击和滑动事件。另外提醒一句V2.4 之后截图会自动识别屏幕方向横屏游戏不用再做坐标转换如果你要兼容旧脚本可以用ScreenCaptureUtil.setHorizontalScreen()强制横屏模式。5. 三种权限模式怎么选三种模式在代码里切换Robot.setExecType(...)区别在设备要求模式设备要求适合场景注意无障碍无 Root普通手机默认选择兼容性最好需在系统设置里开启无障碍服务Root需已 Root底层事件模拟点击只在 OnePlus 7 Pro 上验证过换机可能有兼容问题Xposed需 Xposed 框架v30 及以上拦截和模拟输入事件面向进阶用户拿不准就用无障碍。真遇到它做不到的事再升级 Root 或 Xposed。性能上有两个小习惯能省不少时间一是别在一个循环里反复截全屏能缓存的图就缓存二是给点击之后留合理的等待让界面先响应再找下一个元素。6. 常见问题问不 Root 到底能不能用能。无障碍模式就是为无 Root 设备准备的点击和输入都能覆盖日常需求。问OCR 识别不准怎么调缩小识别区域、调大文字占比是最直接的办法语言不对就换或补语言包。问支持哪些安卓版本Android 5.0 及以上基本都能跑覆盖绝大多数在用设备。7. 项目现状与后续路线目前框架是单进程运行。作者排了四条后续计划把业务进程和工作进程拆开、支持脚本暂停和停止、支持跨机器部署方便群控、脚本热更新。也就是说现在能用但离生产级还有一段路重度使用建议关注 UPDATE.md 的版本记录。框架本身够用剩下的都是业务问题。用无障碍模式先把第一段点击脚本跑起来剩下的功能你会用到时再翻对应章节就行。【免费下载链接】RobotHelper安卓游戏自动化脚本框架|Automated script for Android games项目地址: https://gitcode.com/gh_mirrors/ro/RobotHelper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考