2. 测试环境与硬件资源要求

2.1 适用场景

• 首次启动 MediaCodec 硬件权限回归测试套件前，需要确认并准备全部硬件与软件资源。
• 测试环境发生变更（如设备更换、系统升级、权限策略调整）后，需要重新对照本章清单进行环境验证。
• 跨厂商/跨芯片平台的兼容性回归测试，需要针对每个目标平台维护独立的设备型号清单与权限配置表。
• 第三方实验室或外部合作团队进行测试环境部署时，以此章节为唯一准入标准。

2.2 前置条件

1. 测试计划已通过评审，明确了回归测试覆盖的芯片平台与机型号范围。
2. 测试经理已协调设备管理员完成测试设备出库或远程设备池分配。
3. 被测设备已恢复出厂设置或至少未经过深度权限篡改（root 状态需单独标识）。
4. 测试工程师具备对应设备型号的 ADB/USB 驱动及刷机工具（仅用于系统版本验证，非刷机操作）。
5. 已获取本章节附件所需的所有官方系统镜像版本号与 OTA 升级记录。

2.3 操作步骤

1. 收集设备型号清单：根据测试计划中的芯片平台（Qualcomm、MediaTek、Exynos、Tensor、麒麟等），从设备库中筛选出代表型号，填入《设备型号清单表》。每款芯片至少选择 2 台不同 SoC 代际的设备。
2. 确认系统版本：使用 ADB 命令查询每台设备的系统版本，确保回归测试所需的 API 层级（API 29+）及厂商扩展版本与清单一致。

   adb shell getprop ro.build.version.sdk
   adb shell getprop ro.build.version.release
   adb shell getprop ro.build.fingerprint

   将输出结果与本章“系统版本要求表”逐项核对。
3. 配置硬件权限：针对每台设备，按照《硬件权限配置表》执行权限授予或关闭操作。部分权限需要通过 Setting provider 或权限管理器手动变更。

   # 示例：授予应用相机硬件权限（根据实际包名调整）
   adb shell pm grant com.example.mediacodec.test android.permission.CAMERA
   # 示例：关闭硬件加速渲染（回归测试需验证纯软件路径时）
   adb shell settings put global force_gpu_rendering 0

   权限变更风险：某些硬件权限（如 android.permission.MEDIA_CONTENT_CONTROL）需要系统签名或特权权限，若无法直接通过 ADB 设置，需使用具有 system 签名的 test-keys 镜像或 root 授权。该操作应在隔离环境中进行，避免影响生产设备。
4. 验证配置生效：通过 adb shell dumpsys media.camera、adb shell dumpsys media.player 等命令确认权限状态已正确读取。记录每个权限项的实际状态。
5. 填写环境准备记录表：将步骤1-4的核对结果填入《记录材料》中的检查表，并由测试工程师与设备管理员双人签字确认。

2.4 输入输出物

2.5 责任边界

• 测试工程师：负责执行步骤1-5，填写所有输出物，确保设备型号、系统版本、权限配置与本章要求完全一致。
• 设备管理员：提供设备库台账，物理或远程交付设备，并对设备硬件健康度（无摄像头/编解码器损坏）负责。
• 系统管理员（可选）：在需要使用 root 权限或特权镜像时，负责制作并安装授权镜像，并记录修改操作。
• 测试经理：审核「环境准备记录」，对列表中设备/系统/权限与测试计划的匹配性承担最终审批责任。

2.6 记录材料（检查表模板）

以下检查表须在环境搭建完毕后逐项填写，并附签名与日期。

测试工程师签字：__________    日期：__________    设备管理员签字：__________    日期：__________

2.7 异常处理

2.8 验收标准

• 所有设备型号均通过《设备型号清单》与测试计划芯片平台完全对应，无缺漏、无错误替换。
• 每台设备的系统版本（API 等级 + fingerprint）均与《系统版本要求表》一致，偏差公差为 0。
• 每台设备的硬件权限配置值与《硬件权限配置表》完全匹配，且可通过 ADB dump 命令验证。
• 已填写的《环境准备记录检查表》经测试工程师与设备管理员双人签名，归档至本次回归测试目录。
• 异常处理环节涉及的替换、降级、受限标记均有对应的审批记录及书面说明。