EasyClick 入门指南(二):全平台开发环境部署——Android / iOS / 鸿蒙 Next

4 阅读8分钟

EasyClick 入门指南(二):全平台开发环境部署——Android / iOS / 鸿蒙 Next

专栏:《EasyClick 自动化测试从入门到实战》

本期目标:把 电脑端 IDEA 工程底座​ 与 三个平台的运行环境​ 分别跑通,让脚本真正落到一个能执行的设备上。


0. 先理清 EC 的架构(不然步骤容易懵)

EC 的自动化不是"一个 App 搞定一切",它是 三层协作模型

IDEA(写代码 / 编译 / 收发指令)
  ↕  中控 / 激活链路(调度与日志)
    ↕  设备端运行时(真正在手机/系统上执行点击/截图/节点)

落到不同平台形态不一样:

平台设备端是什么调度中枢
AndroidEC 运行 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 从磁盘安装插件

  1. 打开 IDEA → File → Settings → Plugins
  2. 右上角 ⚙ 齿轮 → Install Plugin from Disk…
  3. 选中那个 EC 插件 .zip​ → 确认 → Restart IDEA

重启后能看到 EasyClick 相关菜单/工具窗口,说明底座生效。

1.4 建立工作空间(避坑点)

  • 新建一个 纯英文路径、无空格、无中文​ 的空文件夹

    例:D:/ECWorkspace/(而不是 桌面/我的自动化项目

  • IDEA 里 Open这个文件夹作为工作区

  • 右键 → New → Module→ 选对应平台的 EC 脚本项目模板(安卓 / iOS / 鸿蒙)


2. Android 部署:免 Root 的"最短闭环"

适合:你想最快跑通一条脚本,而且不想碰 Root / 刷机。

2.1 手机端准备

  1. 安装 EC 运行 APK(EC.apk)

    • idea的EasyClick安卓版菜单 -> USB连接
    • 会自动安装易点云测在手机上,如果自动安装失败会弹窗二维码扫码安装
    • 遇到"未知来源"拦截,按系统提示给权限
  2. 打开 开发者选项

    • 设置 → 关于手机 → 版本号→ 连续点 7 下

    • 回到 设置 → 系统 / 更多设置 → 开发者选项

    • 打开:

      • USB 调试
      • (建议)USB 调试(安全设置)
  3. 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 后要做两件事:

  1. 保活设置

    • 右上角 设置 → 保活设置 → 保存
    • 出现悬浮窗 → 把它拖到左右边缘贴边隐藏
  2. 系统授权

    • 位置:选 始终允许
    • 后台 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:

  1. 设置 → 关于手机 → 软件版本:连续点击 7 次 → 开发者模式开启
  2. 设置 → 系统 → 开发者选项 → USB调试:勾选
  3. USB 连电脑 → 弹 "是否允许 USB 调试" ​ → 选始终允许

中控里一旦识别到设备,就会出现在设备列表里。

4.3 开启自动化(脚本能跑的前提)

开启自动化之前先对设备进行设备授权,需要付费单台5/元/月 官方购买

  • 设备连上后 → 中控的 设备监控​ 会出现设备条目
  • 选设备 → 开启自动化​ → 等服务状态变成

4.4 IDEA 插件连中控

条件:

  1. 鸿蒙 Next 开发插件已安装(网盘里下,走 IDEA 从磁盘安装)
  2. 中控已跑起来且设备在线

然后:

  • IDEA 菜单:EasyClick 鸿蒙Next → 设备链接 → USB版本链接中控
  • 默认地址一般不用改 → 确认
  • 看底部 EasyClick 鸿蒙Next运行日志​ 的链接状态

5. 三平台验收清单(建议你对着打钩)

Android

  • IDEA 能看到设备 / 日志窗口有输出
  • EC APP 无障碍已激活(或代理模式已开启)
  • logd能打出来

iOS

  • ioscenter 中控登录正常、设备列表认出 iPhone
  • 主程序(易点云测)已装、保活/定位权限到位
  • 代理 IPA 正常运行、Automation Running出现
  • 中控里 服务状态 = 是(自动化开启成功)
  • 设备已授权(脱机/商用场景按官方授权流程走完)

鸿蒙 Next

  • hmcenter 中控启动、登录
  • 手机开发者+USB调试开好、中控认出设备
  • 开启自动化、服务状态 = 是
  • IDEA 插件链接中控成功、日志有心跳

6. 下一步(第三期预告)

环境活了之后,真正有意思的部分才开始: 新建第一个脚本项目 跑helloWord