diff --git a/README.md b/README.md index beaa666..0a1b0a0 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # NESLite NESLite 是一个面向 Android 的轻量 NES/FC 模拟器前端。它使用固定版本的 -FCEUmm libretro 内核。当前仓库已准备 0.9.7 候选基线的冻结样本、输入延迟指标、升级架构、原生对齐审计 +FCEUmm libretro 内核。当前仓库已准备 0.9.8 候选基线的冻结样本、输入延迟指标、升级架构、原生对齐审计 和候选交付脚本;荣耀 Magic8 与 X5 Lite 已由截图确认枚举,但手机未开放 ADB,且发布签名和可观察 玩法的合法 ROM 样本尚未提供,因此 M2~M8 的完整实机验收及 G8 仍待补齐。 diff --git a/app/build.gradle.kts b/app/build.gradle.kts index a84274e..210b2e0 100644 --- a/app/build.gradle.kts +++ b/app/build.gradle.kts @@ -21,8 +21,8 @@ android { applicationId = "org.neslite.app" minSdk = 28 targetSdk = 36 - versionCode = 9007 - versionName = "0.9.7" + versionCode = 9008 + versionName = "0.9.8" testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" ndk { diff --git a/app/src/main/java/org/neslite/app/MainActivity.kt b/app/src/main/java/org/neslite/app/MainActivity.kt index 0bdd1b1..dbb8d2c 100644 --- a/app/src/main/java/org/neslite/app/MainActivity.kt +++ b/app/src/main/java/org/neslite/app/MainActivity.kt @@ -85,7 +85,7 @@ import org.neslite.app.system.RotatingDiagnosticLog import org.neslite.app.system.SafeInsets import org.neslite.app.system.SystemUiPolicy import org.neslite.app.system.UiLayer -import org.neslite.app.system.mergeSafeInsets +import org.neslite.app.system.resolveLayoutSafeInsets import org.neslite.app.system.finishRefreshRateProbe import org.neslite.app.system.sessionCommandAllowed import org.neslite.app.system.sessionTransitionSettled @@ -369,13 +369,27 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { val value = windowInsets.getInsets(type) return SafeInsets(value.left, value.top, value.right, value.bottom) } - val merged = mergeSafeInsets( - safe(WindowInsetsCompat.Type.systemBars()), - safe(WindowInsetsCompat.Type.displayCutout()), - safe(WindowInsetsCompat.Type.mandatorySystemGestures()), + fun safeIgnoringVisibility(type: Int): SafeInsets { + val value = windowInsets.getInsetsIgnoringVisibility(type) + return SafeInsets(value.left, value.top, value.right, value.bottom) + } + val layoutInsets = resolveLayoutSafeInsets( + systemBars = safeIgnoringVisibility(WindowInsetsCompat.Type.systemBars()), + displayCutout = safe(WindowInsetsCompat.Type.displayCutout()), + systemGestures = safe(WindowInsetsCompat.Type.systemGestures()), + ) + view.setPadding(0, 0, 0, 0) + layoutInsets.gameplay.run { + mainScreen.setPadding(left, top, right, bottom) + } + layoutInsets.overlay.run { + overlayScreen.setPadding(left, top, right, bottom) + } + recordSystemEvent( + "safe_insets_game_${layoutInsets.gameplay.left}_0_${layoutInsets.gameplay.right}_0" + + "_overlay_${layoutInsets.overlay.left}_${layoutInsets.overlay.top}_" + + "${layoutInsets.overlay.right}_${layoutInsets.overlay.bottom}", ) - view.setPadding(merged.left, merged.top, merged.right, merged.bottom) - recordSystemEvent("safe_insets_${merged.left}_${merged.top}_${merged.right}_${merged.bottom}") windowInsets } ViewCompat.requestApplyInsets(rootShell) @@ -387,6 +401,8 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { androidx.core.view.WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE if (visible) controller.show(WindowInsetsCompat.Type.systemBars()) else controller.hide(WindowInsetsCompat.Type.systemBars()) + ViewCompat.requestApplyInsets(rootShell) + rootShell.post { ViewCompat.requestApplyInsets(rootShell) } } private fun showEmulatorStatus(message: CharSequence) { @@ -739,15 +755,15 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { addView( LinearLayout(context).apply { - orientation = LinearLayout.VERTICAL + orientation = LinearLayout.HORIZONTAL background = roundedBackground(Color.argb(120, 34, 39, 49), dp(10).toFloat()) - setPadding(dp(4), dp(4), dp(4), dp(4)) - libraryRailButton = railButton("≡\n列表", ::openLibraryPage) + setPadding(dp(3), dp(3), dp(3), dp(3)) + libraryRailButton = railButton("≡", "游戏列表", ::openLibraryPage) addView(libraryRailButton) - addView(railButton("+\n导入", ::openImportPage)) - addView(railButton("⚙\n设置", ::showSettings)) + addView(railButton("+", "导入游戏", ::openImportPage)) + addView(railButton("⚙", "设置", ::showSettings)) }, - FrameLayout.LayoutParams(dp(58), ViewGroup.LayoutParams.WRAP_CONTENT, Gravity.START or Gravity.TOP).apply { + FrameLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, dp(44), Gravity.START or Gravity.TOP).apply { leftMargin = dp(8) topMargin = dp(8) }, @@ -2403,10 +2419,12 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { setTextIsSelectable(true) } - private fun railButton(label: String, action: () -> Unit) = Button(this).apply { - text = label + private fun railButton(icon: String, label: String, action: () -> Unit) = Button(this).apply { + text = icon + contentDescription = label + ViewCompat.setTooltipText(this, label) isAllCaps = false - textSize = 11f + textSize = 19f setTextColor(Color.WHITE) minHeight = 0 minimumHeight = 0 @@ -2420,9 +2438,9 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { radius = dp(8).toFloat(), ) layoutParams = LinearLayout.LayoutParams( - ViewGroup.LayoutParams.MATCH_PARENT, - dp(42), - ).apply { setMargins(0, dp(2), 0, dp(2)) } + dp(38), + dp(38), + ).apply { setMargins(dp(2), 0, dp(2), 0) } setOnClickListener { action() } } diff --git a/app/src/main/java/org/neslite/app/system/SystemUiPolicy.kt b/app/src/main/java/org/neslite/app/system/SystemUiPolicy.kt index 5a70a00..b16d06a 100644 --- a/app/src/main/java/org/neslite/app/system/SystemUiPolicy.kt +++ b/app/src/main/java/org/neslite/app/system/SystemUiPolicy.kt @@ -43,6 +43,11 @@ object SystemUiPolicy { data class SafeInsets(val left: Int, val top: Int, val right: Int, val bottom: Int) +data class LayoutSafeInsets( + val gameplay: SafeInsets, + val overlay: SafeInsets, +) + fun mergeSafeInsets(vararg insets: SafeInsets): SafeInsets = SafeInsets( left = insets.maxOfOrNull(SafeInsets::left) ?: 0, top = insets.maxOfOrNull(SafeInsets::top) ?: 0, @@ -50,6 +55,23 @@ fun mergeSafeInsets(vararg insets: SafeInsets): SafeInsets = SafeInsets( bottom = insets.maxOfOrNull(SafeInsets::bottom) ?: 0, ) +fun resolveLayoutSafeInsets( + systemBars: SafeInsets, + displayCutout: SafeInsets, + systemGestures: SafeInsets, +): LayoutSafeInsets { + val gameplayEdges = mergeSafeInsets(displayCutout, systemGestures) + return LayoutSafeInsets( + gameplay = SafeInsets( + left = gameplayEdges.left, + top = 0, + right = gameplayEdges.right, + bottom = 0, + ), + overlay = mergeSafeInsets(systemBars, displayCutout, systemGestures), + ) +} + fun sessionCommandAllowed(pending: String?, command: String, state: String): Boolean { val transition = command in setOf("load", "run", "pause", "stop") if (pending == "audio_rebuild" && command == "stop") return state in setOf("Paused", "Pausing") diff --git a/app/src/test/java/org/neslite/app/BuildIdentityTest.kt b/app/src/test/java/org/neslite/app/BuildIdentityTest.kt index 4df298a..6d9d3d6 100644 --- a/app/src/test/java/org/neslite/app/BuildIdentityTest.kt +++ b/app/src/test/java/org/neslite/app/BuildIdentityTest.kt @@ -7,7 +7,7 @@ class BuildIdentityTest { @Test fun debugBuildUsesTheDocumentedIdentity() { assertEquals("org.neslite.app.debug", BuildConfig.APPLICATION_ID) - assertEquals("0.9.7-debug", BuildConfig.VERSION_NAME) - assertEquals(9007, BuildConfig.VERSION_CODE) + assertEquals("0.9.8-debug", BuildConfig.VERSION_NAME) + assertEquals(9008, BuildConfig.VERSION_CODE) } } diff --git a/app/src/test/java/org/neslite/app/system/SystemUiPolicyTest.kt b/app/src/test/java/org/neslite/app/system/SystemUiPolicyTest.kt index 3cf7ccc..71187c4 100644 --- a/app/src/test/java/org/neslite/app/system/SystemUiPolicyTest.kt +++ b/app/src/test/java/org/neslite/app/system/SystemUiPolicyTest.kt @@ -32,6 +32,18 @@ class SystemUiPolicyTest { ) } + @Test + fun gameplayUsesOnlyHorizontalCutoutAndBackGestureInsets() { + val resolved = resolveLayoutSafeInsets( + systemBars = SafeInsets(0, 72, 0, 96), + displayCutout = SafeInsets(54, 28, 12, 0), + systemGestures = SafeInsets(24, 0, 30, 48), + ) + + assertEquals(SafeInsets(54, 0, 30, 0), resolved.gameplay) + assertEquals(SafeInsets(54, 72, 30, 96), resolved.overlay) + } + @Test fun refreshSamplesRotateAtCapacity() { val buffer = RefreshRateSampleBuffer(2) diff --git a/docs/architecture.md b/docs/architecture.md index c84df52..dd3bfec 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,4 +1,4 @@ -# NESLite 架构(0.9.7 候选基线) +# NESLite 架构(0.9.8 候选基线) ## 边界与线程 @@ -101,8 +101,8 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及 按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则 一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。 -0.9.7 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全 -区域绘制虚拟手柄;左侧固定入口打开游戏列表、导入和设置的全屏独立页面。X/Y 复用 M4 的 A/B 软件 +0.9.8 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全 +区域绘制虚拟手柄;左上角横排图标入口打开游戏列表、导入和设置的全屏独立页面。X/Y 复用 M4 的 A/B 软件 连发动作;重置要求持续按住 650 ms。游戏页沉浸式隐藏系统栏,管理页恢复系统栏;页面打开前先等待 运行会话进入暂停态,页面关闭后不自动恢复,避免文件选择或设置过程中游戏在后台继续。 @@ -114,8 +114,9 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及 AndroidX 返回分发先把当前页面和会话状态归一成单一决策:设置/存档页回上级,暂停菜单返回会在 原生层确认后继续,运行中返回会先完成暂停与自动保存;Loading、Pausing、Stopping 或仍有待确认 -命令时忽略重复动作。应用内容区合并系统栏、挖孔和强制手势区域的最大边距,横屏画面、菜单与虚拟键 -共享同一个可触达安全区域,渲染比例仍由 M2/M6 的视口算法决定。 +命令时忽略重复动作。游戏页只在左右合并显示挖孔和系统返回手势边距,顶部与底部不为已隐藏的系统栏 +留白;管理页独立合并系统栏、挖孔和系统手势的四边安全区。系统栏状态变化后会再次请求 Insets 并重算 +两套边距,渲染比例仍由 M2/M6 的视口算法决定。 后台、锁屏和焦点丢失统一清除所有输入、请求暂停保存、放弃音频焦点;回到前台只重建 Surface 与 音频资源,保持 Paused 等待用户继续。路由变化若与暂停或退出交错,会延迟到暂停确认后重建,退出 diff --git a/docs/build.md b/docs/build.md index efa123a..3bb08be 100644 --- a/docs/build.md +++ b/docs/build.md @@ -1,6 +1,6 @@ # NESLite 可复现构建说明 -本说明对应 0.9.7 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、 +本说明对应 0.9.8 候选基线。命令使用系统默认 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.7/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非 +`.build/rc-0.9.8/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非 arm64-v8a 库。 默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离 diff --git a/docs/controller-x5lite.md b/docs/controller-x5lite.md index db379aa..b3f4aa3 100644 --- a/docs/controller-x5lite.md +++ b/docs/controller-x5lite.md @@ -5,7 +5,7 @@ ABXY、视图/菜单键及左右肩键。随后在荣耀 Magic8 页面取得了 Android 设备身份和静态轴范围; 实际 KeyEvent、动态轴采样、手柄模式及拔出重连仍待诊断 JSON 回填。 -在 0.9.7-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动 +在 0.9.8-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动 设置全部按键”,按页面顺序操作 X5 Lite;也可点击任一动作单独修改或清除。轴方向捕获后先松回中位, 冲突时确认是否替换,最后点击“保存”。配置按下表设备指纹保存,不依赖临时 deviceId。 diff --git a/docs/identity.md b/docs/identity.md index e6b743e..f2b566e 100644 --- a/docs/identity.md +++ b/docs/identity.md @@ -6,7 +6,7 @@ | --- | --- | | 显示名称 | `NESLite` | | 正式 application ID/namespace | `org.neslite.app` | -| 当前候选版本 | `0.9.7`,`versionCode = 9007` | +| 当前候选版本 | `0.9.8`,`versionCode = 9008` | | 调试 application ID | `org.neslite.app.debug` | | 发布 ABI | `arm64-v8a` | | min/target SDK | 28/36 | diff --git a/docs/known-issues.md b/docs/known-issues.md index 87f14a8..d2ed0b0 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -1,6 +1,6 @@ # 已知问题与候选版限制 -本清单对应 0.9.7 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有 +本清单对应 0.9.8 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有 明确接受或修复结论。 | 编号 | 优先级 | 状态 | 问题与处理条件 | diff --git a/docs/reports/m8-release-candidate.md b/docs/reports/m8-release-candidate.md index e45a245..58f6696 100644 --- a/docs/reports/m8-release-candidate.md +++ b/docs/reports/m8-release-candidate.md @@ -1,7 +1,7 @@ # M8 0.9.4 发布候选记录 -> 此文件保留 0.9.4 的历史候选证据。0.9.7 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能 -> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.7 候选记录。 +> 此文件保留 0.9.4 的历史候选证据。0.9.8 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能 +> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.8 候选记录。 日期:2026-09-12 diff --git a/docs/usage.md b/docs/usage.md index cac2422..430337c 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -1,14 +1,14 @@ # NESLite 日常使用 -1. 应用会自动进入沉浸式横屏,中央 4:3 游戏区优先占满安全高度。左侧是十字方向键,右侧是 - A/B/X/Y;较小的 Select/Start 分别位于游戏画面底部两侧。X/Y 分别是 A/B 连发。左上角的 - “列表”“导入”“设置”会打开独立页面,并临时恢复系统栏。 -2. 点左侧“导入”,选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立, +1. 应用会自动进入沉浸式横屏,中央 4:3 游戏区使用完整屏幕高度,只在左右避开挖孔和返回手势区域。左侧是十字方向键,右侧是 + A/B/X/Y;较小的 Select/Start 分别位于游戏画面底部两侧。X/Y 分别是 A/B 连发。左上角横排的 + “列表”“导入”“设置”图标会打开独立页面,并临时恢复系统栏及完整四边安全区。 +2. 点左上角“导入”图标,选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立, 相同内容不会重复。可按名称/哈希搜索、收藏或从列表隐藏。隐藏不删除 ROM 和存档,重新导入相同 内容会恢复关联。 -3. 点左侧“列表”,再点游戏条目;加载完成后会自动开始。连接外接手柄后仍可按设置选择是否显示 +3. 点左上角“列表”图标,再点游戏条目;加载完成后会自动开始。连接外接手柄后仍可按设置选择是否显示 屏幕按键。多点触控支持方向与动作同时按住,滑出、取消、失焦或暂停都会释放输入。 -4. 点左侧“设置”可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进。进入 +4. 点左上角“设置”图标可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进。进入 “手动设置手柄按键、摇杆与功能键”后,可启动逐项向导,也可单独点击动作修改或清除;按下物理键 或推动轴完成捕获,检查无误后点“保存”。冲突会要求确认,设置按设备特征在重启和重连后恢复。 5. 游戏中点右侧“暂停”或按手柄右摇杆进入暂停菜单;“重置”需要持续按住约 650 ms,滑出会取消。 diff --git a/tools/package-rc.ps1 b/tools/package-rc.ps1 index 66ff092..2a60a8c 100644 --- a/tools/package-rc.ps1 +++ b/tools/package-rc.ps1 @@ -14,8 +14,8 @@ $env:JAVA_HOME = if ($env:JAVA_HOME -and (Test-Path (Join-Path $env:JAVA_HOME 'b } $env:ANDROID_HOME = $sdkRoot $env:ANDROID_SDK_ROOT = $sdkRoot -$versionName = '0.9.7' -$versionCode = 9007 +$versionName = '0.9.8' +$versionCode = 9008 $gitStatus = @(& git -C $root status --porcelain) if ($LASTEXITCODE -ne 0) { throw 'Cannot inspect the Git worktree.' } if ($gitStatus.Count -ne 0) { throw 'RC packaging requires a clean committed worktree.' }