Files
NESLite/docs/reports/m7-magicos.md
T

40 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# M7 MagicOS 10 系统适配记录
日期:2026-09-12
构建目标:`org.neslite.app.debug`,`0.7.4-debug`,versionCode 7004,arm64-v8a
## 已实现
- AndroidX 统一返回处理覆盖游戏库、运行、暂停菜单、设置、手柄设置和存档管理。会话命令有单一待确认
状态;重复返回以及加载、暂停、恢复、退出交错不会排入冲突命令,暂停菜单只在原生暂停确认后显示。
- Activity 使用可调整大小的横屏配置和 `shortEdges` 挖孔策略;内容区合并系统栏、显示挖孔和强制手势
边缘的最大安全距离。安全距离只改变可用视口,不改变 4:3 或整数缩放算法。
- 后台、锁屏、音频焦点丢失统一清输入、放弃焦点并请求暂停保存;回到前台先重建 Surface/音频,保持
Paused 由用户继续。音频路由变化在暂停确认后执行,退出优先,不创建额外核心线程。
- 进程重建只接回仍存在的原生会话;失效会话返回游戏库且不自动重载 ROM。异常记录使用 ROM 哈希与
最新有效自动恢复点签名,同一组合连续两次异常即停止当前会话并阻止循环,保留明确手动重试入口。
- 诊断格式升级到 v2:列出版本、设备、控制器与限额输入事件、可用显示模式、各模式两秒运行样本、
帧与音频指标、存档边界、原生错误和系统生命周期。系统日志最多 3 个文件、每个 256 KiB;仅记录
ROM 哈希,不包含 ROM 字节或路径,存档包边界也明确标记 `packageIncludesRom=false`。
## 自动验证
- `tools/check.ps1 -Scope Stage` 通过:arm64-v8a 调试 APK 构建成功,Windows 原生烟雾/故障测试
1/1 通过,JVM 37 项通过、0 失败。
- M7 JVM 覆盖返回映射、设置页父级、安全区合并、重复/交错会话命令、两秒刷新率采样窗口、异常计数
的 ROM/状态隔离,以及超限日志轮换。
- `:app:lintDebug` 通过:0 错误、50 个非阻断警告。警告以既有动态界面文本国际化和依赖版本提示为主;
固定横屏在 Android 16 的兼容提醒需在后续大屏范围中重新评估。
- 调试 APK 为 16,117,653 字节,SHA-256
`9E50A3CD31616570692AAA47C83C5A1224023C0A7F9AD407A632D0083E8A01F4`。
## 待真机验收
用户当前不连接手机,因此未执行 L2:MagicOS 10 系统返回手势、实际挖孔/系统栏/手势边缘、设备全部
刷新率模式、后台/锁屏/来电或通知焦点、Surface/Activity/音频路由重建、受控连续异常和真机诊断
导出仍待验证。G7 要求的 L3 与 H-LIFE(后台和锁屏各 20 轮)也未执行;前序 G1~G6 仍未通过。
因此代码和自动验证已完成 M7 范围,但 `todo.md` 的 M7-01a~M7-04b 与 G7 保持未勾选,不能宣称
MagicOS 10 真机门槛通过。若真机发现时钟/音频、热路径或存档证据失效,只补跑对应 H-AV、H-HOT 或
H-SAVE 专项。