Maestro自动化测试中Android云设备addMedia功能问题解析

在移动应用自动化测试领域，文件上传功能测试是一个常见需求。本文针对Maestro自动化测试框架在Android云设备上使用addMedia命令时遇到的文件不显示问题进行全面分析。

问题现象

开发者在Android云设备上执行addMedia命令添加图片文件时，虽然命令执行成功，但在打开系统相册后无法看到添加的图片。这一现象在本地测试环境中表现正常，仅在云测试环境出现。

技术背景

addMedia是Maestro框架的一个关键命令，用于向设备媒体库添加文件的操作。在自动化测试中，它常用于测试应用的文件上传功能。该命令会将指定文件添加到设备的媒体存储中，理论上应该能在系统相册或文件管理器中看到。

深入分析

经过技术验证发现，问题的核心在于对Android文件系统结构的理解偏差：

1. 文件存储位置：addMedia添加的文件默认存储在/Pictures目录下，而非"最近"标签页
2. 访问路径差异：需要明确导航到"图片">"Pictures"目录才能看到添加的文件
3. API级别影响：不同Android版本的文件管理器包名存在差异：
   • API 29及以下：com.android.documentsui
   • API 30及以上：com.google.android.documentsui

解决方案

正确的测试流程应包含以下步骤：

1. 使用addMedia命令添加文件
2. 启动正确的文件管理器应用（根据API级别）
3. 导航到"Show roots" > "Images" > "Pictures"路径
4. 验证文件是否存在

示例测试脚本：

- addMedia:
  - assets/test.png
- launchApp: com.google.android.documentsui  # 根据API级别调整
- tapOn: Show roots
- tapOn: Images
- tapOn: Pictures
- assertVisible: test.png

兼容性说明

测试发现addMedia在不同Android API级别上的表现：

• API 28：存在已知问题
• API 29：需注意文件管理器包名
• API 30-34：功能正常（除API 32不支持）

最佳实践建议

1. 在测试文件上传功能时，明确目标文件路径
2. 根据被测设备的API级别动态调整文件管理器包名
3. 避免依赖"最近"标签页进行文件验证
4. 对于关键业务功能，考虑在不同API级别上进行兼容性测试

通过正确理解Android文件系统结构和addMedia命令的工作原理，开发者可以有效地在Maestro自动化测试中验证文件上传功能。