EasyClick 安卓CLI全栈专家能力手册
简介
深耕 EasyClick 安卓自动化多年，精通 ec-android-cli 命令行全流程、EC 脚本开发、UI 布局开发、OCR/图像识别、项目调试打包、代码排错优化全链路。
本文把我全套实战能力系统整理成手册，可直接当作EC 开发速查文档，新手入门、老手备查都能用，建议收藏备用。
一、ec-android-cli 工具全套操作
1. 项目生命周期管理
preview：项目实时预览到安卓设备run：推送并运行 EC 项目脚本stop：停止设备正在运行的脚本build：编译构建生成 IEC 安装包
2. 调试与辅助命令
capture-screen：设备屏幕一键截图capture-node：抓取当前页面全部 UI 控件节点ocr-screen：全屏屏幕文字 OCR 识别ocr-local-image：识别本地图片文字内容test-image：图像匹配精度测试、找图逻辑调试monitor：实时日志监控，快速排查报错与异常
二、EasyClick 核心脚本开发能力
1. 无障碍模式 常用API
节点查找
js
text("推荐").getOneNodeInfo(timeout)
desc("点赞").getOneNodeInfo(timeout)
id("xxx").getOneNodeInfo(timeout)
clz("android.widget.TextView").getOneNodeInfo(timeout)屏幕手势操作
js
click(x, y)
swipeToPoint(x1, y1, x2, y2, duration)
swipeFromDownToUpInScreen(distance, duration)
swipeFromUpToDownInScreen(distance, duration)节点控件操作
js
node.click()
node.longClick()设备与系统信息
js
getRunningPkg()
dumpXml()
device.getScreenWidth()
device.getScreenHeight()2. 代理模式 agentEvent
适配高版本安卓、特殊设备兼容场景：
js
agentEvent.click(x, y)
agentEvent.swipeToPoint(x1, y1, x2, y2, duration)
agentEvent.longClick(x, y)3. 工具模块 utils
js
utils.openApp(packageName)
utils.openAppByName(appName)4. 通用基础函数
js
// 服务环境
startEnv()
isServiceOk()
// 延时随机
sleep(ms)
random(min, max)
// 日志提示
logd(msg)
loge(msg)
toast(msg)三、EC UI 界面开发
1. XML 布局能力
- 主流布局：
LinearLayout/FrameLayout/RelativeLayout - 常用控件：TextView、EditText、Button、ImageView
- 样式配置：宽高、颜色、边距、圆角、背景、点击态
2. JS 交互逻辑
js
// 加载布局
ui.layout("标题", "main.xml")
ui.setUIvar()
// 获取控件
ui.findViewByTag("tagName")
// 绑定点击事件
ui.setEvent(view, "click", callback)
// 本地配置持久化
ui.getConfig(key)
ui.saveConfig(key, value)四、OCR 文字识别开发
js
// 全屏识别
ocr.screen()
// 区域局部识别
ocr.screen(x, y, width, height)
// 本地图片识别
ocr.localImage(path)五、图像识别 & 找图找色
js
// 模板找图
image.findImage(src, target, threshold)
// 定点找色
image.findColor(src, color, threshold)
// 屏幕截图
image.captureScreen()六、项目全栈服务能力
脚本定制开发
- 各类安卓自动化业务脚本编写
- 自定义 UI 控制面板开发
- 模块化拆分、功能封装实现
代码分析与优化
- 逐行代码逻辑讲解、注释解析
- 闪退、卡死、节点找不到等问题排查
- 代码精简、逻辑重构、兼容性性能优化
项目管理维护
- 项目整体结构拆解分析
- 模块之间依赖关系梳理
- 全局代码关键字检索、定位
打包发布
- 项目编译构建
- IEC 安装包生成
- 代码混淆、加固、发布配置
七、文件与项目运维
- 本地项目文件读取、查看源码
- 在线编辑、修改脚本与布局文件
- 全局代码搜索、批量定位
- 项目目录结构分析、资源整理