在不插 USB 的情况下对设备远程操作/启动测试任务一直是一个非常有用的功能，因为公司里的测试设备总是分散的，而且一堆 USB 线连测试设备总是非常麻烦。ATX 项目组提供的 uiautomator2 借助了一系列的工具，使得能够用 Python 编写自动化脚本，同时可以脚本可以通过 WiFi 直接操控同 WiFi 下的设备。另一方面 Maxim 提供了一个非常稳定而且高效的 UI 全自动话压力/稳定性/遍历测试。两者如果能结合，效果可观。作为同时两个项目的贡献者，分享调和两者的成果以及方案。

背景介绍

uiautomator2 有如下组件：

• PC 端运行的 Python 框架库 uiautomator2，写自动化脚本用的，通过 HTTP（同网段 WiFi）请求让设备端实际执行自动化操作
• 设备端 atx-agent，一个用 Go 开发的 ARM 程序，运行在设备上，进程是 adb shell 权限，守护其他所有设备端的相关服务进程
• 设备端 android-uiautomator-server，fork 自 xiaocong，运行在设备上，通过am instrument启动的一个安卓进程，拥有 adb shell 权限，长连系统的 AccessibilityService，并负责自动化操作（基于 selector 的点击、按钮、输入等）；因为是 adb shell 权限，所以才得以可以操作其他 APP（待测 APP）
• 设备端 minicap（可选），来自 openstf，通过 websocket 协议提供设备实时的屏幕图像
• 设备端 minitouch（可选），来自 openstf，通过 websocket 可以实时向 Android 注入屏幕触屏事件（支持复杂路径，多点触摸等）

设备端大管家是 atx-agent，必须有 adb shell 运行权限，保活其他三个，同时是设备端 HTTP 服务器入口，负责路由 HTTP 请求给另外三个部件

Maxim 有两个组件framework.jar和monkey.jar，都是设备端的，其中framework.jar是一个定制的 AccessibilityService，而monkey.jar大改自 Google 原生 monkey，实现遍历逻辑等。一般通过 adb shell 命令行启动，必须有 adb shell（同 android-uiautomator-server，这样才能操作其他 APP），可以脱机运行（类似 nohup），即启动后可以关掉命令行进程不会被杀直到运行完成。

结合方案设计

矛盾点： uiautomator2 和 Maxim 工作时都需要连接系统的 AccessibilityService，而 AccessibilityService 只能单连接；所以启动了 uiautomator2 才有免 USB 操作的能力，但是占用了 AccessibilityService，如果通过 uiautomator2 启动 Maxim 会挂。

经过研究，android-uiautomator-server 只是 uiautomator2 中与 selector，click 等相关的服务；atx-agent 提供执行设备端 shell 命令的功能（fork，执行，因为 fork 自 atx-agent 所以有 adb shell 权限），所以可以首先启动所有 uiautomator2 组件待 WiFi 无线操作可用后，暂时关闭 android-uiautomator-server，然后通过 atx-agent 启动 Maxim，执行完成后再通过 atx-agent 重新拉活 android-uiautomator-server 恢复 uiautomator2 的功能，相关片段整理如下：

import uiautomator2 as u2

d = u2.connect('192.168.0.149') # 连接设备
print(d.info)
# 启动前关闭atx-agent守护的uiautomator-server进程
d.service('uiautomator').stop()
# Maxim正常运行
task = d.shell("CLASSPATH=/sdcard/monkey.jar:/sdcard/framework.jar exec app_process /system/bin tv.panda.test.monkey.Monkey -p com.hotbitmapgg.ohmybilibili --running-minutes 2 --throttle 1500 --uiautomatormix --output-directory /sdcard/max-output", stream=True) # stream模式，保证不会timeout导致杀掉，底层上是一个requests库提供的streaming 模式的response
try:
    for line in task.iter_lines():
        print(line)
finally:
    task.close()
print('Done')
# 重新让atx-agent拉活uiautomator-server进程，或者执行下一条需要uiautomator-server的命令也会自行拉活
d.service('uiautomator').start()
d.press('home')

• 注意：有时候 Maxim 会跑非常久，并不能保证这个 streaming response 一直有，所以在实际使用中可以考虑让 Maxim 跑着，不要求总是获取 log 输出，然后脚本本身等待或者隔段时间去判断 Maxim 进程是否结束了

贡献者招募

• 开源，不是喊一声大神，大神给你免费开放用自己开发的框架，然后要从安装开始教你，Fix 你特殊设备的 Bug，完成你提的这个那个需求，还给你写文档，完了你就去交 KPI 了；这不是开源，这是抢劫
• Maxim 作者聊到过，iOS 端开源了 1 年多，没有人贡献过
• Appium 作者来华私聊到，从流量上看到大量中国人在用 Appium，但是却没有看到过 PR，这是为什么
• 我们 AppetizerIO 作为一个使用开源项目的商业产品，取之于社区，还之于社区：用开源工具充实我们的同时，为开源项目 1. 写文档 2. 做 GUI 配给，集成，项目调和 3. 回答问题处理 issue 4. Bugfix, 新 feature
• 独乐了不如众乐乐，开源是精神，不是形式，不是收费就不是开源
  • 大神这个能不能加上 -> 大神我加了个这个，PR review一下
  • 大神没找到文档啊 -> 大神我把xxx这里写了一下，PR了合并一下吧
  • 大神我这个手机上跑不了 -> 大神，我适配了xxx，PR合并一下吧
  • 大神我是小白，这个怎么用啊 -> 大神我是小白看了文档试用了一下，这个是我在TesterHome分享的踩坑贴，有些可以并到README
  • 大神这个是不是一直免费啊 -> 大神我能做什么
• 最后，感谢我们的贡献者，期待更多真的开源人加入 @codeskyblue @zhangzhao_lenovo