Eglantine(Eden)第三方工具与附加组件配置实战:镜像仓库、Obtainium、ES-DE 与 GameMode
Eglantine(Eden)第三方工具与附加组件配置实战:镜像仓库、Obtainium、ES-DE 与 GameMode
Eden 模拟器(当前仓库 Eglantine 即其开源镜像)本身并不覆盖所有使用场景:它需要外部文件(如特定打包产物)才能在某些操作系统上正常工作,也有第三方仓库提供 nightly 或专用构建。本文以官方用户手册 docs/user/ThirdParty.md 为主体,完整覆盖镜像仓库、Obtainium 自动更新、ES-DE 前端集成与 GameMode 性能模式的配置方法,并结合仓库源码解释每个配置项背后的实现依据,帮助你在 Android 掌机、桌面 Linux 等不同环境下把第三方工具真正用起来。
需要提醒的是(原文档同样强调):虽然文档中提到的资源相对"安全",但仍建议对下载的所有文件进行完整性校验,确认其未被篡改后再使用。
镜像仓库(Mirrors)
源仓库与可用镜像
主源仓库始终位于 git.eden-emu.dev/eden-emu/eden。官方文档列出的镜像有:
github.com/eden-emulator/mirrorgit.crueter.xyz/mirror/edencodeberg.org/eden-emu/edencollective.taymaerz.de/eden/eden
互联网上还存在其他镜像,但官方无法保证其可靠性与可用性。如果你有 Forgejo 实例,也可以自行搭建镜像:从源仓库自动 mirror,或者直接镜像一个已有镜像以减轻官方带宽压力——原文明确表示这两种方式都可以接受。
为什么镜像如此重要
镜像不只是"下载更快"的问题:后文 Obtainium 的自动更新完全依赖某个镜像站点的 release 数据解析。选择一个你所在网络环境下稳定可达、且后端类型已知的镜像(例如基于 Forgejo/Gitea 的站点),是后续配置能否生效的前提。
配置 Obtainium:Android 端自动追踪新版本
Obtainium 是一个基于 Git 仓库 release 页面自动安装与更新 Android 应用的工具,原文档称其为"very nice handy app"。配置步骤如下:
- 复制源仓库(或你偏好的镜像)URL,例如
git.eden-emu.dev/eden-emu/eden/; - 打开 Obtainium,点击
Add App; - 将该 URL 粘贴到
App Source URL字段; - 在
Override Source下拉菜单中选择Forgejo (Codeberg); - 点击
Add。此时 Obtainium 应能解析 release 并找到 APK 文件。
原文档特别注明:即使站点并非 Codeberg,只要它使用相同的 Forgejo/Gitea 后端,就需要选择 Forgejo (Codeberg) 作为来源类型——这个设置告诉 Obtainium 按哪种后端格式去读取 release 数据。这是配置中最容易出错的一步。
从源码结构看,release 里可被 Obtainium 识别的正是 Android 构建产物:src/android/app/build.gradle.kts 中 applicationId = "dev.eden.eden_emulator",而 nightly 构建会追加后缀 .nightly(build.gradle.kts#L139)。也就是说标准版与 nightly 版是不同包名的两个应用,可以共存安装,Obtainium 分别追踪各自的 release 也不会互相覆盖。
配置 ES-DE:让前端正确拉起 Eden
ES-DE 是 Android 掌机(如 Odin2)上常见的前端框架,它通过 es_systems.xml 中的 <command> 与 es_find_rules.xml 中的 <emulator> 规则来决定"点某个游戏时启动哪个 APK、以什么 intent 启动"。原文档给出两种配置方法,两者都适用,按需选择。
方法一:使用现成配置包
- 从社区仓库
GlazedBelmont/es-de-android-custom-systems下载 ZIP; - 解压后将
es_systems.xml与es_find_rules.xml提取到\Odin2\Internal shared storage\ES-DE\custom_systems目录; - 在 ES-DE 中按
Start -> Other Settings -> Alternative Emulators,将其设置为Eden (Standalone)。
方法二:手动写入配置
- 进入
\Odin2\Internal shared storage\ES-DE\custom_systems; - 在
es_find_rules.xml中加入以下内容:
<!-- Standard aka. normal release -->
<emulator name="EDEN">
<rule type="androidpackage">
<entry>dev.eden.eden_emulator/org.yuzu.yuzu_emu.activities.EmulationActivity</entry>
</rule>
</emulator>
<!-- Optimized -->
<emulator name="EDEN">
<rule type="androidpackage">
<entry>com.miHoYo.Yuanshen/org.yuzu.yuzu_emu.activities.EmulationActivity</entry>
</rule>
</emulator>
- 在
es_systems.xml中,紧跟其他 switch 系统条目之后加入这一行命令:
<command label="Eden (Standalone)">%EMULATOR_EDEN% %ACTION%=android.nfc.action.TECH_DISCOVERED %DATA%=%ROMPROVIDER%</command>
源码佐证:为什么是这两个包名与这个 Activity
规则条目 androidpackage 的写法是 <applicationId>/<Activity 全限定名>,与仓库中的 Android 工程完全对应:
- 标准版包名
dev.eden.eden_emulator定义于 build.gradle.kts#L67; - "Optimized" 包名
com.miHoYo.Yuanshen对应genshinSpoofproduct flavor(应用名显示为 "Eden Optimized",开启GENSHIN_SPOOF=ON编译参数,minSdk 35),见 build.gradle.kts#L201-L217。原文档 XML 中<!-- Optimized -->的注释即指这一构建; - 从源码结构看,仓库还有一个
legacyflavor,包名为dev.legacy.eden_emulator(build.gradle.kts#L224),原文档未将其列入规则——如果你安装的是 Legacy 构建,需要自行按相同格式补充条目。
再看 <command> 行中的两个占位符。%ACTION%=android.nfc.action.TECH_DISCOVERED 与 %DATA%=%ROMPROVIDER% 组合起来,本质上是向 Eden 发送一个携带 ROM content URI 的 intent。AndroidManifest.xml#L81-L103 中 org.yuzu.yuzu_emu.activities.EmulationActivity(android:exported="true")声明了匹配的 intent-filter:
android.nfc.action.TECH_DISCOVERED(L89),并携带nfc_tech_filtermeta-data(L102)——虽然名字源于 NFC,但它同时也是外部前端投递 ROM 的入口 action;android.intent.action.VIEW+contentscheme +application/octet-stream(L93-L97)——承接%ROMPROVIDER%生成的content://URI;- 自定义 action
dev.eden.eden_emulator.LAUNCH_WITH_CUSTOM_CONFIG(L99)。
因此方法二的 <command> 并不是随意拼出来的:TECH_DISCOVERED action + ROM provider URI 恰好命中 EmulationActivity 已导出的 intent-filter,ES-DE 只需把这两个参数填进去即可拉起模拟。
配置 GameMode(Linux 性能模式)
原文档对该部分的核心说明有三点:
- 模拟器的界面设置里有一个复选框,可以自动启用 GameMode;
libgamemode.so必须能在标准LD_LIBRARY_PATH中被找到,否则不会正常生效;- 如果因故无法工作,可参考 Arch Linux wiki 的 GameMode 条目排查;也可以直接通过包装器
gamemode <program>启动模拟器,通常开箱即用。
源码中的调用链与默认值
构建侧:根 CMakeLists.txt#L553 在非 YUZU_STATIC_ROOM 配置下执行 find_package(gamemode);查找逻辑位于 Findgamemode.cmake,通过 pkg-config 的 pkg_search_module(GAMEMODE QUIET IMPORTED_TARGET gamemode) 定位头文件并生成 gamemode::headers 别名目标,最终链接进 qt_common(见 qt_common/CMakeLists.txt#L89)。
设置项:enable_gamemode 定义于 uisettings.h#L144-L150,是一个 SwitchableSetting<bool>。默认值按编译器区分:非 MSVC 平台(即 Linux/MinGW)默认为 true,MSVC 下为 false。注释也注明 "Linux/MinGW may support (requires libdl support)"——这与原文档"libgamemode.so 必须在 LD_LIBRARY_PATH 中可找到"的要求一致:运行时库缺失时功能无法生效。
运行时行为:核心实现在 gamemode.cpp,Common::FeralGamemode::Start() / Stop() 分别在内部调用 gamemode_request_start() 与 gamemode_request_end(),且仅在 __unix__ 平台编译生效;失败时通过 gamemode_error_string() 输出日志(Linux 上为 LOG_WARNING,其他 unix 为 LOG_INFO)。生命周期与模拟会话绑定,从 main_window.cpp 可以确认完整调用链:
MainWindow::OnStartGame()启动模拟时调用Start()(main_window.cpp#L3005-L3018);MainWindow::OnPauseGame()暂停时调用Stop()(main_window.cpp#L3033-L3039);- 关闭游戏时同样调用
Stop()(main_window.cpp#L2154); - 设置复选框的变更经
SetGamemodeEnabled(bool)(main_window.cpp#L4784-L4789)即时映射为 Start/Stop,无需重启模拟器(见 main_window.cpp#L3436-L3502)。
也就是说,"勾选复选框启用 GameMode" 的实际效果是:仅在模拟真正运行期间向 libgamemode 请求进入/退出游戏模式,空闲浏览界面时不会占用系统性能调优策略。若日志中出现 gamemode_error_string() 的告警,通常就是库未安装、LD_LIBRARY_PATH 不可见或服务未运行,可按原文档建议改用 gamemode <program> 包装器启动验证。
相关仓库路径速查
| 内容 | 路径 |
|---|---|
| 本文主体文档 | docs/user/ThirdParty.md |
| GameMode 客户端封装 | src/qt_common/gamemode.cpp |
enable_gamemode 设置定义 |
src/qt_common/config/uisettings.h |
| 启动/暂停/关闭时的调用链 | src/yuzu/main_window.cpp |
| GameMode 构建查找逻辑 | CMakeModules/find/Findgamemode.cmake、CMakeLists.txt |
| Android 包名与构建 flavor | src/android/app/build.gradle.kts |
| ES-DE intent 对应的 Activity 声明 | src/android/app/src/main/AndroidManifest.xml |