Obtainium Emulation Pack 常见问题完整解答：版本冲突、包更新、TRACK ONLY 与爬虫失效

Obtainium Emulation Pack 是一个 Obtainium 导入文件包，它把主流的 Android 模拟器（Dolphin、PPSSPP、Winlator、MelonDS 等）和配套工具一次性导入 Obtainium，实现自动跟踪与更新。本文完整解答新手最关心的 4 类问题：同一应用多版本冲突、如何更新应用包、TRACK ONLY 资源怎么用、HTML 爬虫失效怎么排查，帮助你在遇到问题时快速定位原因。

一、先认识项目：一个文件搞定整个模拟器工具链

这个项目本质上是一份"应用清单"，核心数据都在 src/applications.json 中，每个应用包含包名（id）、来源地址（url）、分类（categories）和 Obtainium 高级设置（additionalSettings）。

构建后会生成两份可直接导入的 JSON：

• 标准版：obtainium-emulation-pack-latest.json（普通 Android 设备）
• 双屏版：obtainium-emulation-pack-dual-screen-latest.json（LG V60/Velvet 等双屏设备）

📌 建议：不确定用哪个就导入标准版；双屏设备选双屏版，避免包名冲突（见下文）。

二、版本冲突：为什么 stable、beta、nightly 不能共存

冲突的根本原因

Android 系统只允许一个包名（package ID）对应一个应用。Obtainium 也是按包名识别应用的，所以同一应用的 stable、beta、nightly、canary 版本不能同时安装。例如：

你必须在 RetroArch（stable）和 RetroArch（nightly）之间二选一，不能同时拥有两者。

项目是如何规避冲突的

• 稳定版优先：清单里已默认省略 nightly/beta/canary 版本，只保留稳定版，对新手最友好。
• 需要尝鲜就手动添加：README 表格中保留了部分 beta/nightly 的 "Add to Obtainium!" 链接，点击即可手动导入，但导入前请移除同包名的稳定版。
• 标准版与双屏版互斥：像 Cemu、MelonDS 都存在"官方版"和"双屏改版"，两者包名相同（如info.cemu.cemu），因此被拆到不同的 JSON 文件中，通过includeInStandard/includeInDualScreen字段控制，保证同一份导入文件里不会出现重复包名。

💡 一句话总结：同一包名只能保留一个，换版本先卸载旧的。

三、如何更新 Obtainium Emulation Pack 应用包

最快更新方法（与安装完全相同）

1. 打开本项目 Releases 页面，下载最新的obtainium-emulation-pack-vX.X.X.json（标准版或双屏版二选一）。
2. 打开 Obtainium，进入Import/Export（导入/导出）页面。
3. 选择Obtainium Import，选中刚下载的 JSON 文件。
4. 导入完成，原有资源会被更新，你手动添加的其他资源不会被删除。

⚠️ 注意：更新只是"刷新清单"，之后在 Obtainium 里点检查更新即可拿到各模拟器的新版 APK。

更新时看不到某个应用？

检查两点：该应用是否被标记为"仅表格展示"（如 beta 应用通过excludeFromExport: true排除在导出 JSON 外，但仍出现在 README.md 的表格中）；或者它属于另一个版本（标准版/双屏版）的专属应用。

四、TRACK ONLY 是什么？为什么有的应用只显示不下载

它解决什么问题

TRACK ONLY 字面意思是"只跟踪、不拉取"。清单中的 NetherSX2、Obtainium Emulation Pack 自身等条目被设为 TRACK ONLY，原因是这些项目无法（或不允许）提供直接可下载的 APK——比如 NetherSX2 出于法律原因不直接提供 APK。但你仍然希望知道它更新了，于是 Obtainium 只负责监测版本变化并推送通知，下载需要手动完成。

TRACK ONLY 资源的正确使用步骤

收到更新通知后：

1. 点击 Obtainium 中该应用提供的资源链接；
2. 按指引手动下载文件；
3. 回到 Obtainium → 点击该应用 → 点击Mark Updated（标记已更新），避免重复提醒。

五、爬虫失效：为什么有的应用突然"抓不到"更新

爬虫为什么可能坏

清单中的应用分两类来源：

• GitHub/Codeberg 等代码仓库来源：走结构化 API，最稳定，几乎不会坏。
• HTML 网页来源（如 Dolphin、PPSSPP、DuckStation、ScummVM、RetroArch）：靠正则表达式爬虫从下载页面"抓取"APK 链接和版本号。

官方 FAQ 说得很直接：爬虫是可能坏的。一旦上游项目改了下載页面的布局、命名规则或版本号格式（破坏了原有约定），正则匹配就会失配，导致检测不到新版本或版本号解析异常。

失效后的排查与应对

1. 先确认是"整包都失效"还是"个别应用失效"：整包失效多为网络问题；个别应用失效基本是上游页面改版。
2. 手动访问该应用的下载页，对比 Obtainium 里记录的 URL 是否变化。
3. 若确认是页面改版，可到 Releases 关注项目是否已更新正则规则（构建脚本位于 scripts/ 目录，例如 scripts/generate-obtainium-urls.py、scripts/validate-json.py），等待新版本包发布后重新导入即可。
4. 临时方案：对该应用手动下载新版 APK。

📌 经验法则：GitHub 来源的应用比 HTML 爬虫来源的应用更可靠，重要设备建议优先保留 GitHub 来源的模拟器。

六、问题速查表

更多细节可参考项目内文档：pages/faq.md（官方 FAQ）、pages/development.md（开发指南）、pages/table.md（应用清单表格）、RELEASE.md（版本发布说明）。

总结

• 版本冲突：根源是包名唯一性，stable 与 beta/nightly 只能二选一，标准版与双屏版包名互斥。
• 更新包：重新导入最新 JSON 即可，不会删掉你手动添加的其他资源。
• TRACK ONLY：只提醒不下载，手动获取后记得点 Mark Updated。
• 爬虫失效：HTML 来源应用依赖正则爬取，上游改版就会坏，属于可预期风险，等待新包或手动下载即可。