feat: redesign settings and import NES folders

This commit is contained in:
2026-09-13 21:53:21 +08:00
parent 05a209eb97
commit e3842c21dc
14 changed files with 261 additions and 24 deletions
+1 -1
View File
@@ -1,7 +1,7 @@
# NESLite
NESLite 是一个面向 Android 的轻量 NES/FC 模拟器前端。它使用固定版本的
FCEUmm libretro 内核。当前仓库已准备 0.9.14 候选基线的冻结样本、输入延迟指标、升级架构、原生对齐审计
FCEUmm libretro 内核。当前仓库已准备 0.9.15 候选基线的冻结样本、输入延迟指标、升级架构、原生对齐审计
和候选交付脚本;荣耀 Magic8 与 X5 Lite 已由截图确认枚举,但手机未开放 ADB,且发布签名和可观察
玩法的合法 ROM 样本尚未提供,因此 M2~M8 的完整实机验收及 G8 仍待补齐。
+2 -2
View File
@@ -21,8 +21,8 @@ android {
applicationId = "org.neslite.app"
minSdk = 28
targetSdk = 36
versionCode = 9014
versionName = "0.9.14"
versionCode = 9015
versionName = "0.9.15"
testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
ndk {
@@ -56,6 +56,7 @@ import org.neslite.app.diagnostics.DiagnosticEventJson
import org.neslite.app.diagnostics.InputDiagnostics
import org.neslite.app.library.GameDatabase
import org.neslite.app.library.GameEntity
import org.neslite.app.library.FolderRomImporter
import org.neslite.app.library.LibraryRecovery
import org.neslite.app.library.RomImporter
import org.neslite.app.library.libraryGridColumns
@@ -213,6 +214,10 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
if (uri != null) importRom(uri)
}
private val openRomFolder = registerForActivityResult(ActivityResultContracts.OpenDocumentTree()) { uri ->
if (uri != null) importRomFolder(uri)
}
private val createSavePackage = registerForActivityResult(
ActivityResultContracts.CreateDocument("application/vnd.neslite.save"),
) { uri ->
@@ -463,6 +468,7 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
target.visibility = View.VISIBLE
overlayTitle.text = title
currentOverlayPage = page
overlayScreen.setBackgroundColor(if (page == OverlayPage.SETTINGS) Color.rgb(244, 246, 250) else Color.WHITE)
setSystemBarsVisible(true)
overlayScreen.visibility = View.VISIBLE
contentScroll.post { contentScroll.scrollTo(0, 0) }
@@ -797,8 +803,18 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
orientation = LinearLayout.HORIZONTAL
gravity = Gravity.CENTER_VERTICAL
setPadding(dp(12), dp(8), dp(12), dp(8))
setBackgroundColor(Color.WHITE)
addView(Button(context).apply {
text = "返回"
text = "← 返回"
isAllCaps = false
textSize = 14f
minHeight = dp(40)
minimumHeight = dp(40)
elevation = 0f
setTextColor(Color.rgb(53, 62, 80))
background = pressableRoundedBackground(
Color.rgb(239, 242, 248), Color.rgb(218, 225, 240), dp(10).toFloat(),
)
setOnClickListener { handleUnifiedBack() }
})
overlayTitle = TextView(context).apply {
@@ -841,13 +857,26 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
importPanel = LinearLayout(context).apply {
orientation = LinearLayout.VERTICAL
visibility = View.GONE
addView(body("选择你合法持有的 .nes 文件。应用会复制文件并按 SHA-256 建立游戏条目。"))
addView(Button(context).apply {
text = "选择 NES ROM 文件"
setOnClickListener { openRom.launch(arrayOf("application/octet-stream", "*/*")) }
addView(section("添加你合法持有的 NES 游戏"))
addView(body("游戏会复制到应用内,并按内容自动去重;原文件不会被修改。"))
addView(LinearLayout(context).apply {
orientation = LinearLayout.HORIZONTAL
addView(Button(context).apply {
text = "导入文件"
setOnClickListener { openRom.launch(arrayOf("application/octet-stream", "*/*")) }
}, LinearLayout.LayoutParams(0, dp(56), 1f).apply { rightMargin = dp(8) })
addView(Button(context).apply {
text = "导入文件夹"
setOnClickListener { openRomFolder.launch(null) }
}, LinearLayout.LayoutParams(0, dp(56), 1f))
})
addView(body("文件夹模式会包含子文件夹中的 .nes 文件;不支持的文件将跳过。"))
importStatus = body("尚未选择文件")
addView(importStatus)
addView(Button(context).apply {
text = "查看游戏列表"
setOnClickListener { openLibraryPage() }
})
}
addView(importPanel)
@@ -1187,9 +1216,82 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
text = "关闭设置"
setOnClickListener { closeSettingsPage() }
})
arrangeSettingsCards()
focusFirstButton(settingsPanel)
}
/** Keep the existing settings actions, but present them as compact landscape groups. */
private fun arrangeSettingsCards() {
val controls = (0 until settingsPanel.childCount).map(settingsPanel::getChildAt)
settingsPanel.removeAllViews()
settingsPanel.addView(TextView(this).apply {
text = "按你的习惯调整画面、触控与手柄"
textSize = 14f
setTextColor(Color.rgb(95, 104, 119))
setPadding(dp(4), 0, 0, dp(12))
})
val columns = LinearLayout(this).apply { orientation = LinearLayout.HORIZONTAL }
settingsPanel.addView(columns)
fun addCard(title: String, subtitle: String, indices: List<Int>) {
val card = LinearLayout(this).apply {
orientation = LinearLayout.VERTICAL
setPadding(dp(14), dp(14), dp(14), dp(14))
background = GradientDrawable().apply {
setColor(Color.WHITE)
cornerRadius = dp(16).toFloat()
setStroke(dp(1), Color.rgb(224, 229, 237))
}
addView(TextView(context).apply {
text = title
textSize = 18f
setTextColor(Color.rgb(34, 43, 59))
})
addView(TextView(context).apply {
text = subtitle
textSize = 12f
setTextColor(Color.rgb(104, 115, 132))
setPadding(0, dp(2), 0, dp(10))
})
}
indices.forEach { index ->
val view = controls[index]
when (view) {
is Button -> {
view.isAllCaps = false
view.textSize = 13f
view.gravity = Gravity.CENTER_VERTICAL or Gravity.START
view.setTextColor(if (index == 18) Color.WHITE else Color.rgb(45, 54, 70))
view.setPadding(dp(12), dp(4), dp(10), dp(4))
view.minHeight = dp(42)
view.minimumHeight = dp(42)
view.elevation = 0f
view.background = pressableRoundedBackground(
if (index == 18) Color.rgb(88, 70, 171) else Color.rgb(243, 246, 251),
if (index == 18) Color.rgb(110, 91, 193) else Color.rgb(222, 229, 244),
dp(9).toFloat(),
)
}
is TextView -> {
view.textSize = 12f
view.setTextColor(Color.rgb(104, 115, 132))
view.setPadding(dp(2), dp(6), 0, dp(2))
}
is SeekBar -> view.setPadding(0, 0, 0, 0)
}
card.addView(view, LinearLayout.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT,
if (view is Button) dp(42) else ViewGroup.LayoutParams.WRAP_CONTENT,
).apply { bottomMargin = if (view is Button) dp(7) else 0 })
}
columns.addView(card, LinearLayout.LayoutParams(0, ViewGroup.LayoutParams.WRAP_CONTENT, 1f).apply {
setMargins(dp(4), 0, dp(4), dp(10))
})
}
addCard("画面与声音", "游戏显示、音量与静音", listOf(1, 2, 3, 4, 5))
addCard("方向与触控", "十字键手感和摆放位置", listOf(10, 11, 12, 13, 14, 15, 16, 17))
addCard("手柄与辅助", "连发、快进和设备配置", listOf(6, 7, 8, 18, 19))
}
private fun loadAppSettings() {
controllerScope.launch {
val loaded = appSettingsStore.load()
@@ -1235,7 +1337,7 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
AlertDialog.Builder(this)
.setTitle("欢迎使用 NESLite")
.setMessage(
"1. 点“导入 NES ROM”选择你合法持有的游戏文件。\n\n" +
"1. 点“导入”选择你合法持有的 NES 文件,或选择文件夹批量导入。\n\n" +
"2. 可连接手柄并在设置中测试/调整映射;没有手柄也能使用屏幕虚拟键。\n\n" +
"3. 从游戏列表选择游戏后会自动开始。屏幕“暂停”或右摇杆按下可打开菜单。\n\n" +
"4. 暂停菜单可保存、读档、导入导出(包内不含 ROM)和退出。",
@@ -1882,6 +1984,35 @@ class MainActivity : ComponentActivity(), InputManager.InputDeviceListener {
}
}
private fun importRomFolder(uri: Uri) {
importStatus.text = "正在扫描文件夹…"
showEmulatorStatus("正在导入文件夹…")
libraryExecutor.execute {
runCatching {
FolderRomImporter(contentResolver, RomImporter(contentResolver, filesDir, database.games()))
.import(uri) { count ->
if (count == 1 || count % 10 == 0) runOnUiThread {
if (currentOverlayPage == OverlayPage.IMPORT) importStatus.text = "已处理 $count 个 NES 文件…"
}
}
}.onSuccess { result ->
runOnUiThread {
val summary = "文件夹导入完成:新增 ${result.imported},重复 ${result.duplicates},失败 ${result.failed}"
importStatus.text = summary + result.firstErrors.joinToString("", prefix = if (result.firstErrors.isEmpty()) "" else "\n") { "$it\n" }
showEmulatorStatus(summary)
refreshLibrary()
}
}.onFailure { error ->
runOnUiThread {
val message = "文件夹导入中断:${error.message ?: error.javaClass.simpleName};已导入的游戏仍保留"
importStatus.text = message
showEmulatorStatus(message)
refreshLibrary()
}
}
}
}
private fun recoverLibrary() {
libraryExecutor.execute {
val report = LibraryRecovery(filesDir, database.games()).reconcile()
@@ -0,0 +1,88 @@
package org.neslite.app.library
import android.content.ContentResolver
import android.net.Uri
import android.provider.DocumentsContract
/** Copies NES files from a user-selected SAF tree; the tree permission is only used during this import. */
class FolderRomImporter(
private val resolver: ContentResolver,
private val romImporter: RomImporter,
) {
private data class Entry(val id: String, val name: String, val mime: String?)
data class Summary(
val imported: Int,
val duplicates: Int,
val failed: Int,
val firstErrors: List<String>,
) {
val processed: Int get() = imported + duplicates + failed
}
fun import(treeUri: Uri, onProgress: (Int) -> Unit = {}): Summary {
val rootId = DocumentsContract.getTreeDocumentId(treeUri)
val pending = ArrayDeque<Pair<String, Int>>()
val visited = HashSet<String>()
pending.add(rootId to 0)
var imported = 0
var duplicates = 0
var failed = 0
val errors = ArrayList<String>()
var entries = 0
while (pending.isNotEmpty()) {
val (parentId, depth) = pending.removeFirst()
if (!visited.add(parentId)) continue
require(depth <= MAX_DEPTH && visited.size <= MAX_ENTRIES) { "文件夹层级或项目数量过多" }
val children = DocumentsContract.buildChildDocumentsUriUsingTree(treeUri, parentId)
val files = try {
resolver.query(
children,
arrayOf(DocumentsContract.Document.COLUMN_DOCUMENT_ID,
DocumentsContract.Document.COLUMN_DISPLAY_NAME,
DocumentsContract.Document.COLUMN_MIME_TYPE),
null, null, null,
).use { cursor ->
requireNotNull(cursor) { "无法读取文件夹内容" }
val result = ArrayList<Entry>()
while (cursor.moveToNext()) {
entries++
require(entries <= MAX_ENTRIES) { "文件夹项目超过 $MAX_ENTRIES 个,请分批导入" }
val id = cursor.getString(0) ?: continue
val name = cursor.getString(1) ?: "未命名文件"
val mime = cursor.getString(2)
result.add(Entry(id, name, mime))
}
result
}
} catch (error: Exception) {
if (entries >= MAX_ENTRIES) throw error
failed++
if (errors.size < 3) errors.add("文件夹 $parentId:${error.message ?: error.javaClass.simpleName}")
continue
}
for ((id, name, mime) in files) {
if (mime == DocumentsContract.Document.MIME_TYPE_DIR) {
pending.add(id to depth + 1)
} else if (isNesFilename(name)) {
val document = DocumentsContract.buildDocumentUriUsingTree(treeUri, id)
runCatching { romImporter.import(document) }
.onSuccess { if (it.duplicate) duplicates++ else imported++ }
.onFailure {
failed++
if (errors.size < 3) errors.add("$name:${it.message ?: it.javaClass.simpleName}")
}
onProgress(imported + duplicates + failed)
}
}
}
return Summary(imported, duplicates, failed, errors)
}
companion object {
const val MAX_DEPTH = 32
const val MAX_ENTRIES = 10000
fun isNesFilename(name: String): Boolean = name.endsWith(".nes", ignoreCase = true)
}
}
@@ -7,7 +7,7 @@ class BuildIdentityTest {
@Test
fun debugBuildUsesTheDocumentedIdentity() {
assertEquals("org.neslite.app.debug", BuildConfig.APPLICATION_ID)
assertEquals("0.9.14-debug", BuildConfig.VERSION_NAME)
assertEquals(9014, BuildConfig.VERSION_CODE)
assertEquals("0.9.15-debug", BuildConfig.VERSION_NAME)
assertEquals(9015, BuildConfig.VERSION_CODE)
}
}
@@ -0,0 +1,15 @@
package org.neslite.app.library
import org.junit.Assert.assertFalse
import org.junit.Assert.assertTrue
import org.junit.Test
class FolderRomImporterTest {
@Test
fun onlyNesFilesAreCandidatesRegardlessOfCase() {
assertTrue(FolderRomImporter.isNesFilename("超级玛丽.nes"))
assertTrue(FolderRomImporter.isNesFilename("NINJA.NES"))
assertFalse(FolderRomImporter.isNesFilename("readme.txt"))
assertFalse(FolderRomImporter.isNesFilename("backup.nes.zip"))
}
}
+4 -2
View File
@@ -1,4 +1,4 @@
# NESLite 架构(0.9.14 候选基线)
# NESLite 架构(0.9.15 候选基线)
## 边界与线程
@@ -101,7 +101,7 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
按 pointerId 维护触摸来源并送入与物理手柄相同的 `InputRouter`,因此多来源去重、相反方向和释放规则
一致;取消、滑出、失焦与暂停清空所有虚拟来源。首次使用状态也存于设置 DataStore,不接触用户存档。
0.9.14 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
0.9.15 将游戏入口收敛为单一横屏主画面:中央 `AspectRatioFrameLayout` 只按 4:3 测量,左右剩余安全
区域绘制虚拟手柄;左上角横排图标入口独立于游戏安全内边距,打开游戏列表、导入和设置的全屏页面。
方向键与 ABXY 的半径为原布局的 1.5 倍,Select、Start、暂停和重置为原布局的 1.3 倍。Magic8 横屏
安全区允许时,方向键、Select、4:3 画面、Start、暂停和重置整体左移一个 A 键直径,右侧扩展空间用于
@@ -121,6 +121,8 @@ DataStore 保存,渲染线程只读取整数缩放和过滤快照,音频及
侧栏可用宽度变化导致第二方向过分放大或 ABXY 菱形相对间距改变。左上角列表、导入、设置入口不参与右移。
管理页面不使用左右防误触边距,只保留已显示顶部和底部系统栏所需空间。游戏库按可用横向宽度显示
两列或三列完整、可换行的游戏名,长按条目才显示详情、收藏和移除操作。
设置页按画面与声音、方向与触控、手柄与辅助分成横屏卡片。ROM 导入页同时提供单文件选择与 SAF
文件夹选择;文件夹导入递归扫描子文件夹的 `.nes` 文件,沿用流式校验与 SHA-256 去重,不保留目录权限。
手柄设置支持逐项向导和单项修改/清除。捕获目标动作后,物理 KeyEvent 或超过按下阈值的轴方向成为
该动作的唯一绑定;冲突必须由用户确认替换。轴捕获后必须先回到释放阈值内才进入下一项,防止同一
+2 -2
View File
@@ -1,6 +1,6 @@
# NESLite 可复现构建说明
本说明对应 0.9.14 候选基线。命令使用系统默认 PowerShell 7.6.6(`pwsh`)从仓库根目录执行;不需要手工复制 `.so`、
本说明对应 0.9.15 候选基线。命令使用系统默认 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.14/`。静态审计逐个检查 APK 内 `.so` 的 ELF LOAD 段和 APK 16 KB 对齐,并拒绝非
`.build/rc-0.9.15/`。静态审计逐个检查 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.14-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动
在 0.9.15-debug 中可从“设置 → 手动设置手柄按键、摇杆与功能键”进入编辑页。可选择“开始逐项手动
设置全部按键”,按页面顺序操作 X5 Lite;也可点击任一动作单独修改或清除。轴方向捕获后先松回中位,
冲突时确认是否替换,最后点击“保存”。配置按下表设备指纹保存,不依赖临时 deviceId。
+1 -1
View File
@@ -6,7 +6,7 @@
| --- | --- |
| 显示名称 | `NESLite` |
| 正式 application ID/namespace | `org.neslite.app` |
| 当前候选版本 | `0.9.14`,`versionCode = 9014` |
| 当前候选版本 | `0.9.15`,`versionCode = 9015` |
| 调试 application ID | `org.neslite.app.debug` |
| 发布 ABI | `arm64-v8a` |
| min/target SDK | 28/36 |
+1 -1
View File
@@ -1,6 +1,6 @@
# 已知问题与候选版限制
本清单对应 0.9.14 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
本清单对应 0.9.15 候选源码。优先级含义:阻断表示 G8 不可通过;高表示发布前必须处理;中/低需有
明确接受或修复结论。
| 编号 | 优先级 | 状态 | 问题与处理条件 |
+2 -2
View File
@@ -1,7 +1,7 @@
# M8 0.9.4 发布候选记录
> 此文件保留 0.9.4 的历史候选证据。0.9.14 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能
> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.14 候选记录。
> 此文件保留 0.9.4 的历史候选证据。0.9.15 改动了主界面、触屏与手柄输入路径和页面/会话交接,不能
> 直接继承本记录作为最终 G8 结论;完成 Magic8 实机复核后需生成新的 0.9.15 候选记录。
日期:2026-09-12
+3 -2
View File
@@ -5,13 +5,14 @@
加大的 A/B/X/Y;Select/Start 分别位于游戏画面底部两侧。布局会利用左侧空余安全区将方向键、
Select、游戏画面、Start、暂停和重置整体左移,并用扩大的右侧空间拉开 ABXY。X/Y 分别是 A/B 连发。左上角横排的
“列表”“导入”“设置”图标会打开独立页面,并临时恢复系统栏;管理页面不再保留左右防误触边距。
2. 点左上角“导入”图标,选择你合法持有的 `.nes` 文件。应用按完整 SHA-256 建库;同名不同内容独立,
2. 点左上角“导入”图标,可选单个 `.nes` 文件,也可选文件夹(包含子文件夹中的所有 `.nes` 游戏)。
导入页会汇总新增、重复和失败数量;其他格式会跳过,原文件不会被修改。应用按完整 SHA-256 建库;同名不同内容独立,
相同内容不会重复。可按名称/哈希搜索、收藏或从列表隐藏。隐藏不删除 ROM 和存档,重新导入相同
内容会恢复关联。
3. 点左上角“列表”图标,在两列或三列网格中点游戏名;加载完成后会自动开始。游戏名可完整换行显示,
长按游戏名可查看详情、收藏或从列表移除。连接外接手柄后仍可按设置选择是否显示
屏幕按键。多点触控支持方向与动作同时按住,滑出、取消、失焦或暂停都会释放输入。
4. 点左上角“设置”图标可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进。进入
4. 点左上角“设置”图标,在画面与声音、方向与触控、手柄与辅助三个卡片中调整选项,可切换 4:3/整数缩放、最近邻/线性过滤、音量、静音、软件连发和 RB 快进。进入
“手动设置手柄按键、摇杆与功能键”后,可启动逐项向导,也可单独点击动作修改或清除;按下物理键
或推动轴完成捕获,检查无误后点“保存”。冲突会要求确认,设置按设备特征在重启和重连后恢复。
“屏幕方向键与手柄摇杆”可切换四方向/八方向,并循环选择标准、大、特大方向键;两个位置滑块可
+2 -2
View File
@@ -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.14'
$versionCode = 9014
$versionName = '0.9.15'
$versionCode = 9015
$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.' }