abox-mgr/docs/testing/release-lan-hardware-validation.md

正式版局域网硬件验收

目的与边界

本协议验证签名 Release APK 在已授权 ABox 局域网中的完整产品路径。本地体验和测试 Fake 不能替代真实硬件验收。

报告不得包含密码、Token、原始厂商响应、红外码值、完整网关地址或完整硬件标识。设备和 profile 使用脱敏别名。

执行前检查

• 记录 App 版本、versionCode、Git 提交和 APK 签名摘要；
• 确认测试网络、账号、网关和实体设备均已授权；
• 确认 Android 通知权限和系统省电策略；
• 准备实际名称分别为 智能插座、温湿度传感器 和 红外控制器 的设备，或在 App 中改成网关当前名称；
• 清楚标记哪些步骤是界面验证、网关响应验证和实体设备响应验证。

验收流程

1. 安装、启动与登录

1. 覆盖安装或全新安装 Release APK，确认启动不闪退。
2. 使用无效凭据登录，确认停留在登录页并显示本地化错误。
3. 使用授权凭据登录，确认进入设备中心。
4. 重启 App，验证记住用户名和自动登录的已选行为。
5. 使 Token 失效后执行操作，确认会话清理并返回登录流程。

2. 默认内容与数据隔离

1. 首次登录 ABox 后确认三类默认设备存在，名称逐字为 智能插座、温湿度传感器、红外控制器。
2. 确认红外控制器包含两个自定义遥控器，不自动添加预置码库遥控器。
3. 重命名设备并重启，确认 App 保留用户名称，不执行自动迁移或覆盖。
4. 切换到本地体验，确认 ABox 设备、遥控器、情景、活动和会话数据不出现。

3. 设备控制

1. 在设备中心和插座详情各执行一次开关操作。
2. 确认命令后回读真实状态；插座断电时不得仅因点击而显示已切换。
3. 连续点击电源按钮，确认页面不抖动且不会并发重复发送。
4. 读取温度和湿度，验证完整数据、单字段缺失、无数据和离线状态。
5. 确认设备离线在设备中心和详情页均有明确视觉状态。

4. 红外控制器

1. 按 infrared-hardware-validation.md 完成一个预置遥控器下载和发送流程。
2. 完成一个自定义按钮的添加、学习、发送和重新学习流程。
3. 验证学习失败与未学习状态不同。
4. 验证遥控器排序、编辑、删除和硬件槽位管理。

5. 手动指令

1. 创建包含插座、红外、延迟和通知动作的手动指令。
2. 按配置顺序执行，确认失败策略和动作结果汇总符合设置。
3. 验证同一指令执行期间不会被重复启动。

6. 自动指令

1. 创建一个温度阈值触发的自动指令，并添加插座状态条件。
2. 使用手动执行入口验证动作本身可用。
3. 让传感器状态从不匹配进入匹配，确认执行一次。
4. 在持续匹配期间等待后续轮询，确认不会重复执行。
5. 先恢复到不匹配，再重新进入匹配，确认可以再次执行。
6. 验证时间、湿度和插座状态触发器至少各一次。
7. 验证温度、湿度、插座状态和跨午夜时间范围条件。
8. 拒绝通知权限后执行通知动作，确认显示明确失败而不是成功。

7. 活动记录

1. 确认设备命令、状态确认、传感器刷新、红外学习/发送、手动指令和自动指令均写入活动记录。
2. 确认来源区分用户、自动化和系统，结果区分成功、失败、取消和等待确认。
3. 在存在大量记录时验证分页加载和重新进入页面，不得闪退。
4. 确认记录不包含凭据、原始响应或红外码值。

8. 外观、导航与本地化

1. 验证浅色、深色、动态颜色、手动强调色、色彩风格、色彩规范和界面缩放。
2. 在英文和简体中文下检查设备、红外、情景、自动化、活动、主题和关于页面。
3. 验证二级页面不显示主页顶栏和底栏。
4. 验证系统返回和左上角返回不会进入空白页面或重复回退。
5. 验证 About 页面显示 1.0.0 (1)、包名和 Flagship 团队信息，点击入口不闪退。

结果记录

每个步骤记录：日期、版本与提交、脱敏 profile、脱敏设备名、操作类别、成功/失败/取消/不可用分类、粗粒度耗时、物理响应摘要和缺陷编号。真实硬件终态与 App 显示不一致必须判定为失败。

已知风险

• ABSDK 使用厂商 JAR 中的明文 HTTP，只能在隔离且获授权的局域网中验收；
• Android 后台限制和省电策略可能影响自动化轮询时效，应记录测试设备设置；
• 网关依赖设备名称匹配，App 名称与网关名称不一致会导致设备操作失败。