MaaFramework项目中的夜神模拟器分辨率读取异常问题分析

问题现象

在使用MaaFramework框架连接夜神模拟器时，系统最初能够正确识别模拟器的原始分辨率（1600×900），但在实际运行过程中却错误地读取为900×900的分辨率。这种分辨率识别异常可能导致后续图像识别和操作坐标计算出现偏差。

技术背景

MaaFramework是一个自动化测试框架，其核心功能之一是通过ADB连接安卓模拟器并获取设备信息。分辨率识别是框架的基础功能，主要依赖以下技术点：

1. 通过ADB命令获取设备显示参数
2. 解析设备方向状态（横屏/竖屏）
3. 根据方向状态调整分辨率数值

问题根源分析

从日志中可以观察到两个关键现象：

1. 初始分辨率检测阶段正确返回了1600×900
2. 方向检测返回了0（表示竖屏状态）
3. 最终分辨率却错误地显示为900×900

经过深入分析，这实际上是C++代码中的一个逻辑处理缺陷。当框架检测到设备处于竖屏状态时，应该交换宽度和高度值（例如将1600×900转为900×1600），但代码中错误地将两个维度都设置为了相同值。

解决方案

该问题已在提交f098c67中修复，主要修正了以下内容：

1. 完善了竖屏状态下的分辨率处理逻辑
2. 确保在方向变化时正确交换宽高值
3. 增加了分辨率数据的有效性验证

技术启示

这个案例提醒开发者在处理设备方向变化时需要注意：

1. 安卓设备的显示方向会影响实际可见区域
2. 竖屏状态下应该交换宽高值而非简单赋值
3. 关键参数的获取和转换需要增加日志记录以便调试
4. 边界条件测试的重要性（如正方形分辨率的情况）

最佳实践建议

对于类似框架的开发，建议：

1. 实现完善的设备信息采集模块
2. 增加分辨率变化的单元测试用例
3. 在关键参数转换处添加详细的日志输出
4. 考虑不同模拟器厂商的特殊实现差异
5. 建立设备参数的缓存和更新机制

该问题的解决提升了框架在各类安卓模拟器上的兼容性，特别是对夜神等主流模拟器的支持更加完善。