feat: add M1 device diagnostics
This commit is contained in:
@@ -40,6 +40,17 @@ pwsh -NoProfile -File .\tools\check.ps1 -Scope Build
|
||||
`Stage` 是 M0 的阶段入口,不是未来 G1~G9 的替代。实机、ROM、存档、插拔和耐久验收必须在
|
||||
相应里程碑按 [acceptance.md](acceptance.md) 执行和记录。
|
||||
|
||||
## M1 诊断版安装
|
||||
|
||||
连接并授权一台目标手机后执行:
|
||||
|
||||
```powershell
|
||||
pwsh -NoProfile -File .\tools\check-m1-device.ps1
|
||||
```
|
||||
|
||||
脚本安装并启动 `0.1.3-debug` 诊断版;手柄操作和导出步骤见
|
||||
[controller-x5lite.md](controller-x5lite.md)。连接多台设备时传入 `-Serial <adb序列号>`。
|
||||
|
||||
## 清理
|
||||
|
||||
只清理本工程生成物时删除 `build/`、`app/build/` 和 `.build/`;不要删除 SDK、NDK、
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
# X5 Lite 实测键位与模式
|
||||
|
||||
本文档只登记真实设备结果,不根据按钮字母或网络资料推断 Android 键码。当前尚未连接目标手机和
|
||||
X5 Lite,因此表格保持“待实测”;完成下述流程并导出诊断 JSON 后回填。
|
||||
|
||||
## 固定测试条件
|
||||
|
||||
- 手柄模式:原生安卓模式,实际切换方法待随设备说明和实测确认。
|
||||
- 硬件连发:测试前关闭;实际指示状态待实测记录。
|
||||
- 厂商保留组合:待实测;不得占用“视图+菜单长按”。
|
||||
- 应用版本:`0.1.3-debug`。
|
||||
- 事件上限:最近 512 条;页面显示最近 30 条。
|
||||
|
||||
## 连贯验收步骤
|
||||
|
||||
1. 连接目标手机,启用 USB 调试,运行 `pwsh -NoProfile -File tools/check-m1-device.ps1`。
|
||||
2. 连接 X5 Lite,确认页面出现名称、descriptor、VID/PID、sources 和轴范围。
|
||||
3. 分别操作十字键、左右摇杆、扳机和所有正面/肩键,观察按下、重复、松开与轴值。
|
||||
4. 同时按住一个方向和 A/B,确认组合状态同时存在;全部松开后确认状态为“无”。
|
||||
5. 按住方向及 A/B 时拔出手柄,确认出现 `device_removed` 且状态清空。
|
||||
6. 重新连接,确认分配新的会话编号并可继续记录。
|
||||
7. 点击“导出诊断 JSON”,保存文件并在本报告登记文件名和 SHA-256。
|
||||
|
||||
## 设备身份
|
||||
|
||||
| 项目 | 实测值 |
|
||||
| --- | --- |
|
||||
| 手机型号/系统 | 待实测 |
|
||||
| API/ABI/页大小 | 待实测 |
|
||||
| 屏幕/当前及可用刷新率 | 待实测 |
|
||||
| 手柄名称/descriptor | 待实测 |
|
||||
| VID/PID/sources | 待实测 |
|
||||
| 安卓模式切换方法 | 待实测 |
|
||||
| 硬件连发关闭方式/状态 | 待实测 |
|
||||
| 厂商保留组合 | 待实测 |
|
||||
| 诊断 JSON/SHA-256 | 待实测 |
|
||||
|
||||
## 键位与轴
|
||||
|
||||
| 物理控件 | Android KeyEvent/MotionEvent | sources/范围 | 重复上报 | 备注 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| 十字键上/下/左/右 | 待实测 | 待实测 | 待实测 | 记录按键与 HAT 是否同时上报 |
|
||||
| A/B/X/Y | 待实测 | 待实测 | 待实测 | 不按字母推断 NES 映射 |
|
||||
| LB/RB/LT/RT | 待实测 | 待实测 | 待实测 | 记录扳机按键/轴双重上报 |
|
||||
| 左摇杆/按下 | 待实测 | 待实测 | 待实测 | 记录 X/Y、flat 与范围 |
|
||||
| 右摇杆/按下 | 待实测 | 待实测 | 待实测 | 记录 Z/RZ、flat 与范围 |
|
||||
| 视图/菜单 | 待实测 | 待实测 | 待实测 | 保留厂商组合说明 |
|
||||
@@ -10,6 +10,7 @@ Gradle 版本锁见 [gradle/libs.versions.toml](../gradle/libs.versions.toml)。
|
||||
| Kotlin Gradle plugin | 2.3.0 | Gradle Plugin Portal | Apache-2.0;发布材料列出坐标 | M0 使用 |
|
||||
| AndroidX Core/Activity | 1.17.0/1.12.0 | Google Maven | Apache-2.0;保留 notices | M0 使用 |
|
||||
| JUnit | 4.13.2 | Maven Central | EPL-1.0;测试依赖,不打入生产 APK | M0 使用 |
|
||||
| JSON-java | 20240303 | Maven Central | Public Domain;仅用于 JVM 测试,不打入生产 APK | M1 使用 |
|
||||
| AndroidX test/Espresso | 1.3.0/3.7.0 | Google Maven | Apache-2.0;测试依赖,不打入生产 APK | M0 使用 |
|
||||
| Room | 2.7.2 | Google Maven | Apache-2.0;后续 APK notices | M2 预锁定 |
|
||||
| DataStore | 1.1.7 | Google Maven | Apache-2.0;后续 APK notices | M4/M6 预锁定 |
|
||||
|
||||
+1
-1
@@ -6,7 +6,7 @@
|
||||
| --- | --- |
|
||||
| 显示名称 | `NESLite` |
|
||||
| 正式 application ID/namespace | `org.neslite.app` |
|
||||
| 当前开发版本 | `0.0.1-dev`,`versionCode = 1` |
|
||||
| 当前开发版本 | `0.1.3`,`versionCode = 1003` |
|
||||
| 调试 application ID | `org.neslite.app.debug` |
|
||||
| 发布 ABI | `arm64-v8a` |
|
||||
| min/target SDK | 28/36 |
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
# M1 设备与 X5 Lite 诊断报告
|
||||
|
||||
- 日期:2026-09-12
|
||||
- 应用版本:`0.1.3-debug`(versionCode 1003)
|
||||
- 源码提交:待本阶段实现提交
|
||||
- 基线提交:`f043131`
|
||||
- 验收目标:G1 诊断门槛
|
||||
- 当前结论:实现和自动验证已完成,等待真实目标手机与 X5 Lite 实测
|
||||
|
||||
## 自动验证
|
||||
|
||||
| 检查 | 结果 | 证据 |
|
||||
| --- | --- | --- |
|
||||
| APK 编译与 arm64 JNI | 通过 | `app-debug.apk`;`lib/arm64-v8a/libneslite_jni.so` |
|
||||
| 构建身份 | 通过 | `org.neslite.app.debug`、`0.1.3-debug`、versionCode 1003 |
|
||||
| Android Lint | 通过 | 0 errors;10 项提示均为已锁定版本有更新或仅发布 arm64 的已知范围提示 |
|
||||
| 输入组合、松开和失焦清理 | 通过 | `InputDiagnosticsTest` |
|
||||
| 拔出清理与重连新会话 | 通过 | `InputDiagnosticsTest` |
|
||||
| 512 条有界记录 | 通过 | 容量边界测试使用 3 条窗口验证只保留最新事件 |
|
||||
| JSON 顺序和值往返 | 通过 | key/axis/key-up 代表序列解码后完全一致 |
|
||||
| 原生 smoke | 通过 | CTest `neslite_native_smoke_test` |
|
||||
|
||||
最终 APK 为 7,386,298 bytes,SHA-256 为
|
||||
`39DE483F3255020A83C93A48B10FEB5EA4645F80DA6FF032D5EE01DA5641048B`。本地单元测试共 5 项,
|
||||
failures/errors/skipped 均为 0。
|
||||
|
||||
## 实机验收
|
||||
|
||||
ADB 检查时没有已授权设备,因此以下项目不得记为通过:
|
||||
|
||||
| 路径 | 状态 | 待取得证据 |
|
||||
| --- | --- | --- |
|
||||
| 安装、启动和 JNI 自检 | 未验证 | 目标手机页面或诊断 JSON |
|
||||
| 手机 API/ABI/页大小/屏幕/刷新率 | 未验证 | 诊断 JSON 与设备系统信息核对 |
|
||||
| X5 Lite 枚举和插拔更新 | 未验证 | 连接、移除、重连记录 |
|
||||
| 方向+A/B、松开归零 | 未验证 | 实际 KeyEvent/MotionEvent 序列 |
|
||||
| HAT/摇杆/扳机及重复上报 | 未验证 | 轴范围和实际采样 |
|
||||
| 失焦、按住拔出和重连 | 未验证 | `focus_lost`、`device_removed` 与新 sessionId |
|
||||
| 系统选择器导出 | 未验证 | 可读 JSON 文件及 SHA-256 |
|
||||
|
||||
实机步骤和待回填表位于 `docs/controller-x5lite.md`。G1 通过后,根据真实键位复杂度重新确认 M2
|
||||
工作量;在没有实测数据前暂不改变计划中的 7~9 人日估算。
|
||||
Reference in New Issue
Block a user