Eglantine(Eden)第三方工具与附加组件配置实战:镜像仓库、Obtainium、ES-DE 与 GameMode

原创2026-11-01 10:57:042,141 阅读

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/mirror
  • git.crueter.xyz/mirror/eden
  • codeberg.org/eden-emu/eden
  • collective.taymaerz.de/eden/eden

互联网上还存在其他镜像,但官方无法保证其可靠性与可用性。如果你有 Forgejo 实例,也可以自行搭建镜像:从源仓库自动 mirror,或者直接镜像一个已有镜像以减轻官方带宽压力——原文明确表示这两种方式都可以接受。

为什么镜像如此重要

镜像不只是"下载更快"的问题:后文 Obtainium 的自动更新完全依赖某个镜像站点的 release 数据解析。选择一个你所在网络环境下稳定可达、且后端类型已知的镜像(例如基于 Forgejo/Gitea 的站点),是后续配置能否生效的前提。

配置 Obtainium:Android 端自动追踪新版本

Obtainium 是一个基于 Git 仓库 release 页面自动安装与更新 Android 应用的工具,原文档称其为"very nice handy app"。配置步骤如下:

  1. 复制源仓库(或你偏好的镜像)URL,例如 git.eden-emu.dev/eden-emu/eden/;
  2. 打开 Obtainium,点击 Add App;
  3. 将该 URL 粘贴到 App Source URL 字段;
  4. 在 Override Source 下拉菜单中选择 Forgejo (Codeberg);
  5. 点击 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 启动"。原文档给出两种配置方法,两者都适用,按需选择。

方法一:使用现成配置包

  1. 从社区仓库 GlazedBelmont/es-de-android-custom-systems 下载 ZIP;
  2. 解压后将 es_systems.xml 与 es_find_rules.xml 提取到 \Odin2\Internal shared storage\ES-DE\custom_systems 目录;
  3. 在 ES-DE 中按 Start -> Other Settings -> Alternative Emulators,将其设置为 Eden (Standalone)。

方法二:手动写入配置

  1. 进入 \Odin2\Internal shared storage\ES-DE\custom_systems;
  2. 在 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>
  1. 在 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 对应 genshinSpoof product flavor(应用名显示为 "Eden Optimized",开启 GENSHIN_SPOOF=ON 编译参数,minSdk 35),见 build.gradle.kts#L201-L217。原文档 XML 中 <!-- Optimized --> 的注释即指这一构建;
  • 从源码结构看,仓库还有一个 legacy flavor,包名为 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_filter meta-data(L102)——虽然名字源于 NFC,但它同时也是外部前端投递 ROM 的入口 action;
  • android.intent.action.VIEW + content scheme + 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 性能模式)

原文档对该部分的核心说明有三点:

  1. 模拟器的界面设置里有一个复选框,可以自动启用 GameMode;
  2. libgamemode.so 必须能在标准 LD_LIBRARY_PATH 中被找到,否则不会正常生效;
  3. 如果因故无法工作,可参考 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 可以确认完整调用链:

也就是说,"勾选复选框启用 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
登录后查看全文
Eglantine