diff --git a/README.md b/README.md index 0a1b0a0..17fcdfe 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # NESLite NESLite 是一个面向 Android 的轻量 NES/FC 模拟器前端。它使用固定版本的 -FCEUmm libretro 内核。当前仓库已准备 0.9.8 候选基线的冻结样本、输入延迟指标、升级架构、原生对齐审计 +FCEUmm libretro 内核。当前仓库已准备 0.9.9 候选基线的冻结样本、输入延迟指标、升级架构、原生对齐审计 和候选交付脚本;荣耀 Magic8 与 X5 Lite 已由截图确认枚举,但手机未开放 ADB,且发布签名和可观察 玩法的合法 ROM 样本尚未提供,因此 M2~M8 的完整实机验收及 G8 仍待补齐。 diff --git a/app/build.gradle.kts b/app/build.gradle.kts index 210b2e0..34453bb 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 = 9008 - versionName = "0.9.8" + versionCode = 9009 + versionName = "0.9.9" 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 dbb8d2c..b2c7af2 100644 --- a/app/src/main/java/org/neslite/app/MainActivity.kt +++ b/app/src/main/java/org/neslite/app/MainActivity.kt @@ -753,21 +753,6 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { ), ) - addView( - LinearLayout(context).apply { - orientation = LinearLayout.HORIZONTAL - background = roundedBackground(Color.argb(120, 34, 39, 49), dp(10).toFloat()) - setPadding(dp(3), dp(3), dp(3), dp(3)) - libraryRailButton = railButton("≡", "游戏列表", ::openLibraryPage) - addView(libraryRailButton) - addView(railButton("+", "导入游戏", ::openImportPage)) - addView(railButton("⚙", "设置", ::showSettings)) - }, - FrameLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, dp(44), Gravity.START or Gravity.TOP).apply { - leftMargin = dp(8) - topMargin = dp(8) - }, - ) } addView( mainScreen, @@ -776,6 +761,21 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener { ViewGroup.LayoutParams.MATCH_PARENT, ), ) + addView( + LinearLayout(context).apply { + orientation = LinearLayout.HORIZONTAL + background = roundedBackground(Color.argb(120, 34, 39, 49), dp(10).toFloat()) + setPadding(dp(3), dp(3), dp(3), dp(3)) + libraryRailButton = railButton("≡", "游戏列表", ::openLibraryPage) + addView(libraryRailButton) + addView(railButton("+", "导入游戏", ::openImportPage)) + addView(railButton("⚙", "设置", ::showSettings)) + }, + FrameLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, dp(44), Gravity.START or Gravity.TOP).apply { + leftMargin = dp(6) + topMargin = dp(8) + }, + ) overlayScreen = FrameLayout(context).apply { visibility = View.GONE diff --git a/app/src/main/java/org/neslite/app/VirtualGamepadLayout.kt b/app/src/main/java/org/neslite/app/VirtualGamepadLayout.kt index efa4c42..5b2b02f 100644 --- a/app/src/main/java/org/neslite/app/VirtualGamepadLayout.kt +++ b/app/src/main/java/org/neslite/app/VirtualGamepadLayout.kt @@ -30,15 +30,17 @@ internal fun computeVirtualGamepadGeometry( val h = height.coerceAtLeast(1f) val gameWidth = min(w, h * 4f / 3f) val sideWidth = ((w - gameWidth) / 2f).coerceAtLeast(1f) - val radius = min(min(h * 0.095f, sideWidth * 0.16f), maxRadius) - val menuRadius = radius * 0.60f - val utilityRadius = radius * 0.58f + val baseRadius = min(min(h * 0.095f, sideWidth * 0.16f), maxRadius) + val radius = baseRadius * 1.50f + val menuRadius = baseRadius * 0.60f * 1.30f + val utilityRadius = baseRadius * 0.58f * 1.30f val dpadX = sideWidth * 0.50f val dpadY = h * 0.61f - val dpadGap = radius * 1.42f + val dpadGap = radius val faceX = w - sideWidth * 0.50f val faceY = h * 0.54f - val faceGap = radius * 1.85f + val faceGapX = radius * 1.06f + val faceGapY = radius * 1.70f val gameEdgeGap = radius * 0.25f return VirtualGamepadGeometry( gameLeft = sideWidth, @@ -48,10 +50,10 @@ internal fun computeVirtualGamepadGeometry( left = VirtualControl(dpadX - dpadGap, dpadY, radius), right = VirtualControl(dpadX + dpadGap, dpadY, radius), select = VirtualControl(sideWidth - menuRadius - gameEdgeGap, h * 0.89f, menuRadius), - faceY = VirtualControl(faceX, faceY - faceGap, radius), - faceB = VirtualControl(faceX + faceGap, faceY, radius), - faceA = VirtualControl(faceX, faceY + faceGap, radius), - faceX = VirtualControl(faceX - faceGap, faceY, radius), + faceY = VirtualControl(faceX, faceY - faceGapY, radius), + faceB = VirtualControl(faceX + faceGapX, faceY, radius), + faceA = VirtualControl(faceX, faceY + faceGapY, radius), + faceX = VirtualControl(faceX - faceGapX, faceY, radius), start = VirtualControl(w - sideWidth + menuRadius + gameEdgeGap, h * 0.89f, menuRadius), pause = VirtualControl(w - sideWidth * 0.72f, h * 0.13f, utilityRadius), reset = VirtualControl(w - sideWidth * 0.28f, h * 0.13f, utilityRadius), diff --git a/app/src/test/java/org/neslite/app/BuildIdentityTest.kt b/app/src/test/java/org/neslite/app/BuildIdentityTest.kt index 6d9d3d6..689e639 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.8-debug", BuildConfig.VERSION_NAME) - assertEquals(9008, BuildConfig.VERSION_CODE) + assertEquals("0.9.9-debug", BuildConfig.VERSION_NAME) + assertEquals(9009, BuildConfig.VERSION_CODE) } } diff --git a/app/src/test/java/org/neslite/app/VirtualGamepadLayoutTest.kt b/app/src/test/java/org/neslite/app/VirtualGamepadLayoutTest.kt index b71e2a7..09f6171 100644 --- a/app/src/test/java/org/neslite/app/VirtualGamepadLayoutTest.kt +++ b/app/src/test/java/org/neslite/app/VirtualGamepadLayoutTest.kt @@ -1,10 +1,28 @@ package org.neslite.app +import org.junit.Assert.assertEquals import org.junit.Assert.assertTrue import org.junit.Test import kotlin.math.hypot class VirtualGamepadLayoutTest { + @Test + fun primaryAndUtilityControlsUseRequestedScaleFactors() { + val width = 2760f + val height = 1256f + val gameWidth = minOf(width, height * 4f / 3f) + val sideWidth = (width - gameWidth) / 2f + val previousPrimaryRadius = minOf(height * 0.095f, sideWidth * 0.16f, 126f) + val geometry = computeVirtualGamepadGeometry(width, height, maxRadius = 126f) + + assertEquals(previousPrimaryRadius * 1.50f, geometry.up.radius, 0.01f) + assertEquals(previousPrimaryRadius * 1.50f, geometry.faceA.radius, 0.01f) + assertEquals(previousPrimaryRadius * 0.60f * 1.30f, geometry.select.radius, 0.01f) + assertEquals(previousPrimaryRadius * 0.60f * 1.30f, geometry.start.radius, 0.01f) + assertEquals(previousPrimaryRadius * 0.58f * 1.30f, geometry.pause.radius, 0.01f) + assertEquals(previousPrimaryRadius * 0.58f * 1.30f, geometry.reset.radius, 0.01f) + } + @Test fun magic8ControlsStayOutsideTheFourByThreeViewport() { val geometry = computeVirtualGamepadGeometry(width = 2760f, height = 1256f, maxRadius = 126f) @@ -27,7 +45,15 @@ class VirtualGamepadLayoutTest { assertTrue(geometry.start.radius < geometry.faceA.radius) assertTrue(distance(geometry.select, geometry.right) > geometry.select.radius + geometry.right.radius) assertTrue(distance(geometry.start, geometry.faceA) > geometry.start.radius + geometry.faceA.radius) - assertTrue(distance(geometry.faceY, geometry.faceB) > geometry.faceY.radius + geometry.faceB.radius) + val faceControls = listOf(geometry.faceY, geometry.faceB, geometry.faceA, geometry.faceX) + faceControls.indices.forEach { first -> + (first + 1 until faceControls.size).forEach { second -> + assertTrue( + distance(faceControls[first], faceControls[second]) > + faceControls[first].radius + faceControls[second].radius, + ) + } + } } @Test diff --git a/docs/architecture.md b/docs/architecture.md index dd3bfec..697694f 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,4 +1,4 @@ -# NESLite 架构(0.9.8 候选基线) +# NESLite 架构(0.9.9 候选基线) ## 边界与线程 @@ -101,8 +101,9 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及 按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则 一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。 -0.9.8 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全 -区域绘制虚拟手柄;左上角横排图标入口打开游戏列表、导入和设置的全屏独立页面。X/Y 复用 M4 的 A/B 软件 +0.9.9 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全 +区域绘制虚拟手柄;左上角横排图标入口独立于游戏安全内边距,打开游戏列表、导入和设置的全屏页面。 +方向键与 ABXY 的半径为原布局的 1.5 倍,Select、Start、暂停和重置为原布局的 1.3 倍;X/Y 复用 M4 的 A/B 软件 连发动作;重置要求持续按住 650 ms。游戏页沉浸式隐藏系统栏,管理页恢复系统栏;页面打开前先等待 运行会话进入暂停态,页面关闭后不自动恢复,避免文件选择或设置过程中游戏在后台继续。 diff --git a/docs/build.md b/docs/build.md index 3bb08be..c36fcf2 100644 --- a/docs/build.md +++ b/docs/build.md @@ -1,6 +1,6 @@ # NESLite 可复现构建说明 -本说明对应 0.9.8 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、 +本说明对应 0.9.9 候选基线。命令使用系统默认 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.8/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非 +`.build/rc-0.9.9/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非 arm64-v8a 库。 默认 APK 刻意保持未签名;发布私钥和口令不得传入仓库或写入脚本。获得受保护的发布密钥后,在隔离 diff --git a/docs/controller-x5lite.md b/docs/controller-x5lite.md index b3f4aa3..8d5de4e 100644 --- a/docs/controller-x5lite.md +++ b/docs/controller-x5lite.md @@ -5,7 +5,7 @@ ABXY、视图/菜单键及左右肩键。随后在荣耀 Magic8 页面取得了 Android 设备身份和静态轴范围; 实际 KeyEvent、动态轴采样、手柄模式及拔出重连仍待诊断 JSON 回填。 -在 0.9.8-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动 +在 0.9.9-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动 设置全部按键”,按页面顺序操作 X5 Lite;也可点击任一动作单独修改或清除。轴方向捕获后先松回中位, 冲突时确认是否替换,最后点击“保存”。配置按下表设备指纹保存,不依赖临时 deviceId。 diff --git a/docs/identity.md b/docs/identity.md index f2b566e..b68af06 100644 --- a/docs/identity.md +++ b/docs/identity.md @@ -6,7 +6,7 @@ | --- | --- | | 显示名称 | `NESLite` | | 正式 application ID/namespace | `org.neslite.app` | -| 当前候选版本 | `0.9.8`,`versionCode = 9008` | +| 当前候选版本 | `0.9.9`,`versionCode = 9009` | | 调试 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 d2ed0b0..f1f49d5 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -1,6 +1,6 @@ # 已知问题与候选版限制 -本清单对应 0.9.8 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有 +本清单对应 0.9.9 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有 明确接受或修复结论。 | 编号 | 优先级 | 状态 | 问题与处理条件 | diff --git a/docs/reports/m8-release-candidate.md b/docs/reports/m8-release-candidate.md index 58f6696..78da488 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.8 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能 -> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.8 候选记录。 +> 此文件保留 0.9.4 的历史候选证据。0.9.9 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能 +> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.9 候选记录。 日期:2026-09-12 diff --git a/docs/usage.md b/docs/usage.md index 430337c..88071e8 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -1,7 +1,7 @@ # NESLite 日常使用 -1. 应用会自动进入沉浸式横屏,中央 4:3 游戏区使用完整屏幕高度,只在左右避开挖孔和返回手势区域。左侧是十字方向键,右侧是 - A/B/X/Y;较小的 Select/Start 分别位于游戏画面底部两侧。X/Y 分别是 A/B 连发。左上角横排的 +1. 应用会自动进入沉浸式横屏,中央 4:3 游戏区使用完整屏幕高度,只在左右避开挖孔和返回手势区域。左侧是加大的十字方向键,右侧是 + 加大的 A/B/X/Y;Select/Start 分别位于游戏画面底部两侧。X/Y 分别是 A/B 连发。左上角横排的 “列表”“导入”“设置”图标会打开独立页面,并临时恢复系统栏及完整四边安全区。 2. 点左上角“导入”图标,选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立, 相同内容不会重复。可按名称/哈希搜索、收藏或从列表隐藏。隐藏不删除 ROM 和存档,重新导入相同 diff --git a/tools/package-rc.ps1 b/tools/package-rc.ps1 index 2a60a8c..fc81ee1 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.8' -$versionCode = 9008 +$versionName = '0.9.9' +$versionCode = 9009 $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.' }