fix: stabilize landscape controls and compact game library

This commit is contained in:
2026-09-13 21:02:12 +08:00
parent baeb1130eb
commit 70847c8b97
17 changed files with 146 additions and 47 deletions
+7 -2
View File
@@ -1,4 +1,4 @@
# NESLite 架构(0.9.11 候选基线)
# NESLite 架构(0.9.12 候选基线)
## 边界与线程
@@ -101,7 +101,7 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则
一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。
0.9.11 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
0.9.12 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
区域绘制虚拟手柄;左上角横排图标入口独立于游戏安全内边距,打开游戏列表、导入和设置的全屏页面。
方向键与 ABXY 的半径为原布局的 1.5 倍,Select、Start、暂停和重置为原布局的 1.3 倍。Magic8 横屏
安全区允许时,方向键、Select、4:3 画面、Start、暂停和重置整体左移一个 A 键直径,右侧扩展空间用于
@@ -115,6 +115,11 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
`InputRouter` 中约束物理摇杆。多触点状态以动作集合保存,因此 A 与 B 可以同时按住。方向键大小、
水平与垂直偏移存入 AppSettings DataStore。
横屏翻转时挖孔和返回手势保护值会交换左右两侧。游戏画面与虚拟按键统一采用两侧保护值的最大值,
保证两种横屏方向中的坐标和大小一致;管理页面不使用左右防误触边距,只保留已显示顶部和底部系统栏
所需空间。游戏库按可用横向宽度显示两列或三列完整、可换行的游戏名,长按条目才显示详情、收藏和
移除操作。
手柄设置支持逐项向导和单项修改/清除。捕获目标动作后,物理 KeyEvent 或超过按下阈值的轴方向成为
该动作的唯一绑定;冲突必须由用户确认替换。轴捕获后必须先回到释放阈值内才进入下一项,防止同一
持续轴值误绑多个动作。草稿与正在使用的档案分离,仅保存成功后替换运行档案并按设备指纹持久化。
+2 -2
View File
@@ -1,6 +1,6 @@
# NESLite 可复现构建说明
本说明对应 0.9.11 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
本说明对应 0.9.12 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
FCEUmm 或 Oboe 文件。
## 前置条件
@@ -50,7 +50,7 @@ pwsh -NoProfile -ExecutionPolicy Bypass -File .\tools\package-rc.ps1
脚本重跑 Stage 和 release lint,生成 `org.neslite.app` 的未签名 release APK、完整原生符号、应用及
三个固定第三方依赖的源码包、许可证/说明、静态原生审计、候选清单和 SHA-256。输出位于
`.build/rc-0.9.11/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
`.build/rc-0.9.12/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
arm64-v8a 库。
默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离
+1 -1
View File
@@ -5,7 +5,7 @@
ABXY、视图/菜单键及左右肩键。随后在荣耀 Magic8 页面取得了 Android 设备身份和静态轴范围;
实际 KeyEvent、动态轴采样、手柄模式及拔出重连仍待诊断 JSON 回填。
在 0.9.11-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动
在 0.9.12-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动
设置全部按键”,按页面顺序操作 X5 Lite;也可点击任一动作单独修改或清除。轴方向捕获后先松回中位,
冲突时确认是否替换,最后点击“保存”。配置按下表设备指纹保存,不依赖临时 deviceId。
+1 -1
View File
@@ -6,7 +6,7 @@
| --- | --- |
| 显示名称 | `NESLite` |
| 正式 application ID/namespace | `org.neslite.app` |
| 当前候选版本 | `0.9.11`,`versionCode = 9011` |
| 当前候选版本 | `0.9.12`,`versionCode = 9012` |
| 调试 application ID | `org.neslite.app.debug` |
| 发布 ABI | `arm64-v8a` |
| min/target SDK | 28/36 |
+1 -1
View File
@@ -1,6 +1,6 @@
# 已知问题与候选版限制
本清单对应 0.9.11 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
本清单对应 0.9.12 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
明确接受或修复结论。
| 编号 | 优先级 | 状态 | 问题与处理条件 |
+2 -2
View File
@@ -1,7 +1,7 @@
# M8 0.9.4 发布候选记录
> 此文件保留 0.9.4 的历史候选证据。0.9.11 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能
> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.11 候选记录。
> 此文件保留 0.9.4 的历史候选证据。0.9.12 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能
> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.12 候选记录。
日期:2026-09-12
+3 -2
View File
@@ -3,11 +3,12 @@
1. 应用会自动进入沉浸式横屏,中央 4:3 游戏区使用完整屏幕高度,只在左右避开挖孔和返回手势区域。左侧是加大的十字方向键,右侧是
加大的 A/B/X/Y;Select/Start 分别位于游戏画面底部两侧。布局会利用左侧空余安全区将方向键、
Select、游戏画面、Start、暂停和重置整体左移,并用扩大的右侧空间拉开 ABXY。X/Y 分别是 A/B 连发。左上角横排的
“列表”“导入”“设置”图标会打开独立页面,并临时恢复系统栏及完整四边安全区。
“列表”“导入”“设置”图标会打开独立页面,并临时恢复系统栏;管理页面不再保留左右防误触边距。
2. 点左上角“导入”图标,选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立,
相同内容不会重复。可按名称/哈希搜索、收藏或从列表隐藏。隐藏不删除 ROM 和存档,重新导入相同
内容会恢复关联。
3. 点左上角“列表”图标,再点游戏条目;加载完成后会自动开始。连接外接手柄后仍可按设置选择是否显示
3. 点左上角“列表”图标,在两列或三列网格中点游戏名;加载完成后会自动开始。游戏名可完整换行显示,
长按游戏名可查看详情、收藏或从列表移除。连接外接手柄后仍可按设置选择是否显示
屏幕按键。多点触控支持方向与动作同时按住,滑出、取消、失焦或暂停都会释放输入。
4. 点左上角“设置”图标可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进。进入
“手动设置手柄按键、摇杆与功能键”后,可启动逐项向导,也可单独点击动作修改或清除;按下物理键