EasyClick 入门指南(二):全平台开发环境部署——Android / iOS / 鸿蒙 Next
专栏:《EasyClick 自动化测试从入门到实战》
本期目标:把 电脑端 IDEA 工程底座 与 三个平台的运行环境 分别跑通,让脚本真正落到一个能执行的设备上。
0. 先理清 EC 的架构(不然步骤容易懵)
EC 的自动化不是"一个 App 搞定一切",它是 三层协作模型:
IDEA(写代码 / 编译 / 收发指令)
↕ 中控 / 激活链路(调度与日志)
↕ 设备端运行时(真正在手机/系统上执行点击/截图/节点)
落到不同平台形态不一样:
| 平台 | 设备端是什么 | 调度中枢 |
|---|---|---|
| Android | EC 运行 APK(无障碍 / 代理模式/蓝牙HID/OTG HID) | IDEA 直连 |
| iOS(免越狱) | 主程序 IPA(易点云测)+ 代理 IPA(Runner/agent) | ioscenter 中控 |
| 鸿蒙 Next | 鸿蒙 USB 版靠 hmcenter 中控 做桥接与服务启动 | hmcenter 中控 |
所以部署的本质就是:先把 IDEA 底座装好,再按平台把"设备端 + 中控链路"接上。
1. 电脑端底座:安装 IDEA + 安装 EC 开发插件(一次搞定,三平台共用)
1.1 安装 IntelliJ IDEA
- 去 JetBrains 官网下载 IntelliJ IDEA(社区版就够用,免费)
- 安装路径建议放 非系统盘,后续 SDK / 缓存 / 项目会越来越大
1.2 下载 EC 平台插件(.zip,别解压)
到官方资源区网盘里找:
- 安卓插件 / iOS 插件 / 鸿蒙Next插件 —— 你用什么平台就下什么(不用全下)
关键原则:下载下来是 .zip 压缩包,保持原样,不要手动解压。
1.3 从磁盘安装插件
- 打开 IDEA →
File → Settings → Plugins - 右上角 ⚙ 齿轮 → Install Plugin from Disk…
- 选中那个 EC 插件 .zip → 确认 → Restart IDEA
重启后能看到 EasyClick 相关菜单/工具窗口,说明底座生效。
1.4 建立工作空间(避坑点)
-
新建一个 纯英文路径、无空格、无中文 的空文件夹
例:
D:/ECWorkspace/(而不是桌面/我的自动化项目) -
IDEA 里
Open这个文件夹作为工作区 -
右键 →
New → Module→ 选对应平台的 EC 脚本项目模板(安卓 / iOS / 鸿蒙)
2. Android 部署:免 Root 的"最短闭环"
适合:你想最快跑通一条脚本,而且不想碰 Root / 刷机。
2.1 手机端准备
-
安装 EC 运行 APK(EC.apk)
- idea的EasyClick安卓版菜单 -> USB连接
- 会自动安装易点云测在手机上,如果自动安装失败会弹窗二维码扫码安装
- 遇到"未知来源"拦截,按系统提示给权限
-
打开 开发者选项
-
设置 → 关于手机 → 版本号→ 连续点 7 下 -
回到
设置 → 系统 / 更多设置 → 开发者选项 -
打开:
- USB 调试
- (建议)USB 调试(安全设置)
-
-
USB 连电脑
- 手机弹 "允许 USB 调试" → 勾"始终允许" → 允许
- USB 用途选 文件传输(MTP) (别停在"仅充电")
2.2 激活(让 EC 能"动"手机)
方式 A:APP 内"激活自己"(最省事,免 Root 标配)
- 进 EC APP → 系统设置 → 激活自己
- 系统跳到 无障碍服务列表 → 找到 EasyClick / EC → 开启
- 回到 EC 主页,状态显示已激活 / 运行中即可
这一步本质就是给 EC 开通 AccessibilityService 权限。
方式 B:IDEA 侧激活(适合你要走"代理模式/更强控制")
IDEA 菜单里一般有:
EasyClick 开发工具 → 激活保活设备 → 激活模式1 / 激活模式2/无障碍保活
- 确保 USB 调试已授权
- 看底部 EasyClick 运行日志 有没有回连成功
2.3 验收(最重要的一步)
写个最小探针:
function main() {
logd("=== EC ANDROID HELLO ===");
logd("w=" + device.getScreenWidth() + " h=" + device.getScreenHeight());
}
main();
能看到日志输出 → Android 环境算活了。
常见卡点速查
| 现象 | 优先检查 |
|---|---|
| IDEA 看不到设备 | 换数据线 / 换 USB 口 / 确认 MTP 模式 / adb devices显示 unauthorized就清授权重连 |
| 无障碍开了但像没开 | 系统电池优化把 EC 杀了 → 把 EC 加 不优化、开后台弹出/自启动白名单 |
| 模拟器连不上 | 开开发者选项+USB调试;必要时 adb connect 127.0.0.1:端口 |
3. iOS 部署:免越狱
EC 的 iOS 走的是 主程序 IPA + 代理 IPA + 中控(ioscenter) 模型,核心难点不在"点哪里",而在 签名 与 授权链路。
整体流程(按官方推荐顺序):
装中控 → 签名安装主程序 → 签名安装代理 → 中控连设备 → 开启自动化 → 设备授权
3.1 先装中控:ioscenter
-
官方网盘路径大致是:
EC开发包 → IOS资源 → USB版本 → vX.X.X → 中控 -
Windows 下拿到
ioscenter_windows-x64-x.x.x.zip -
解压到:纯英文路径、无空格、无括号(否则桥接/配置容易诡异报错)
-
运行
ioscenter.exe
第一次打开通常是:
- 授权中心 / 个人中心 → 注册账号 → 手机号验证 → 登录
- 如果桥接起不来:检查是否被杀毒软件隔离、路径是否有特殊符号
建议同时装个 爱思助手(官方也提到用它做驱动/连接辅助)。
3.2 iPhone 侧:签名安装两个 IPA
由于苹果限制,三方 ipa 必须签名才能装进手机:
A. 主程序(易点云测)
- 网盘里拿:
脱机主程序-easyclick-tj-main-x.x.x.ipa(或 USB 版对应的主程序) - 用 巨魔 / 轻松签 / 开发者证书 / 企业签 签完 → 爱思助手安装到手机
- 装好后桌面会出现 易点云测 图标
进 APP 后要做两件事:
-
保活设置
- 右上角
设置 → 保活设置 → 保存 - 出现悬浮窗 → 把它拖到左右边缘贴边隐藏
- 右上角
-
系统授权
- 位置:选 始终允许
- 后台 App 刷新:开
- 无线数据:WLAN 与蜂窝
- Siri 与搜索:按提示允
B. 代理 IPA(EasyClick-Runner / agent)
-
网盘里拿:
脱机版/USB版 代理程序 -
代理 IPA 比较挑签名方式(官方提示:很多"一键签名工具"不一定能签成功)
- 可行路径之一是:Mac 有开发者账号 → 用代理源码 Xcode 编译运行到手机
-
装好后点开 Runner 图标,系统应出现
Automation Running白色字样出现了 = 代理活着;没出现 → 可能需要刷开发者镜像/重新激活代理
脱机版还多一步:需要按官方流程做 设备授权/初始化,把授权信息写进手机,才能跑脚本(这是收费/授权机制的一部分,按官方说明走就好)。
3.3 中控连 iPhone → 开启自动化
开启自动化之前先对设备进行设备授权,需要付费单台5/元/月 官方购买
中控界面:
- 设备列表应该能识别到你的 iPhone
- 选中设备 → 右键 → 开启自动化
- 等
服务状态从红色 否 → 蓝色 是
失败时长按右边:测试自动化 看返回信息比盲猜高效得多。
3.4 IDEA → 链接中控
IDEA 插件侧:
EasyClick iOS → 设备链接 → 链接中控(默认本机地址一般不用改)- 底部日志窗口能看到连接状态和设备心跳,就算桥接通了
iOS 最小探针(逻辑验证)
function main() {
logd("=== EC iOS HELLO ===");
// iOS 的 click/input 是否能动,取决于自动化是否成功开启
}
main();
4. 鸿蒙 Next 部署:USB 版中控路线
鸿蒙 Next 这边 EC 的"中枢"叫 hmcenter(中控程序) ,而不是把 APK 直接丢手机里装完就完事。
4.1 下载/启动中控
- 官方网盘:
鸿蒙Next资源文件夹 → USB版本 → 最新版 - Windows 解压到 英文目录 → 双击
hmcenter.exe - 中控需要登录账号(注册/登录走网页验证)
4.2 手机开开发者 + USB 调试
鸿蒙 Next:
设置 → 关于手机 → 软件版本:连续点击 7 次 → 开发者模式开启设置 → 系统 → 开发者选项 → USB调试:勾选- USB 连电脑 → 弹 "是否允许 USB 调试" → 选始终允许
中控里一旦识别到设备,就会出现在设备列表里。
4.3 开启自动化(脚本能跑的前提)
开启自动化之前先对设备进行设备授权,需要付费单台5/元/月 官方购买
- 设备连上后 → 中控的 设备监控 会出现设备条目
- 选设备 → 开启自动化 → 等服务状态变成
是
4.4 IDEA 插件连中控
条件:
- 鸿蒙 Next 开发插件已安装(网盘里下,走 IDEA 从磁盘安装)
- 中控已跑起来且设备在线
然后:
- IDEA 菜单:
EasyClick 鸿蒙Next → 设备链接 → USB版本链接中控 - 默认地址一般不用改 → 确认
- 看底部 EasyClick 鸿蒙Next运行日志 的链接状态
5. 三平台验收清单(建议你对着打钩)
Android
- IDEA 能看到设备 / 日志窗口有输出
- EC APP 无障碍已激活(或代理模式已开启)
-
logd能打出来
iOS
- ioscenter 中控登录正常、设备列表认出 iPhone
- 主程序(易点云测)已装、保活/定位权限到位
- 代理 IPA 正常运行、
Automation Running出现 - 中控里 服务状态 = 是(自动化开启成功)
- 设备已授权(脱机/商用场景按官方授权流程走完)
鸿蒙 Next
- hmcenter 中控启动、登录
- 手机开发者+USB调试开好、中控认出设备
- 开启自动化、服务状态 = 是
- IDEA 插件链接中控成功、日志有心跳
6. 下一步(第三期预告)
环境活了之后,真正有意思的部分才开始: 新建第一个脚本项目 跑helloWord