uiautomator2项目中的WindowManagerEventInjector兼容性问题解析

背景介绍

在Android自动化测试领域，uiautomator2是一个广泛使用的开源测试框架。近期有开发者反馈，在使用uiautomator2进行设备初始化时遇到了"WindowManagerEventInjector is not supported"的错误，特别是在Android 12及更高版本的设备上。

问题现象

开发者在使用uiautomator2时，执行手动初始化操作（包括卸载原有UI相关环境后重新安装）时，系统抛出以下异常：

java.lang.UnsupportedOperationException: WindowManagerEventInjector is not supported
    at com.github.uiautomator.compat.InputManagerWrapper$WindowManagerEventInjector.<init>(InputManagerWrapper.java:100)
    at com.github.uiautomator.compat.InputManagerWrapper.<init>(InputManagerWrapper.java:22)
    at com.github.uiautomator.MinitouchAgent.<init>(MinitouchAgent.java:236)

该问题主要出现在TCL 50 XE 5G等设备上，特别是在Android 12及以上版本的操作系统中。

技术分析

根本原因

这个问题的根源在于Android系统API的变更。从Android 12开始，Google移除了WindowManagerEventInjector相关的API支持，这是Android安全策略收紧的一部分。而uiautomator2早期版本中的MinitouchAgent组件仍然依赖这个已被废弃的API。

影响范围

该问题主要影响：

1. 运行Android 12及以上版本的设备
2. 使用较旧版本uiautomator2框架的项目
3. 需要手动初始化uiautomator2环境的场景

解决方案

uiautomator2项目团队已经意识到这个问题，并在最新版本中移除了对WindowManagerEventInjector的依赖。具体改进包括：

1. 完全移除了MinitouchAgent组件的调用
2. 采用了新的输入事件注入机制
3. 优化了与新版Android系统的兼容性

最佳实践建议

对于遇到此问题的开发者，建议采取以下措施：

1. 升级到最新版本的uiautomator2框架
2. 避免在Android 12+设备上使用旧版初始化脚本
3. 如果必须使用旧版本，可以考虑以下替代方案：
   • 使用ADB命令直接注入输入事件
   • 切换到其他兼容的输入事件注入方式

总结

随着Android系统的不断更新，一些旧的API会被逐步淘汰。uiautomator2作为开源项目，也在积极适应这些变化。开发者在使用这类框架时，应当关注版本更新和系统兼容性说明，及时升级到最新稳定版本，以避免类似兼容性问题。

对于自动化测试项目，建议建立版本管理机制，定期检查依赖库的更新情况，确保测试框架与目标设备系统的兼容性。