如何给MojoLauncher添加新渲染器:官方源码直写的7步扩展指南
如何给MojoLauncher添加新渲染器:官方源码直写的7步扩展指南
MojoLauncher 是一款基于 PojavLauncher 的 Minecraft: Java Edition Android 启动器,内置 GL4ES、LTW、Zink、Mesa 等多个渲染器供不同 GPU 切换使用。想为它接入一个新渲染器吗?其实源码里就藏着一份官方亲写的 7 步指南——本文带你完整走通渲染器扩展流程,从 RenderSpec 实现到 UI 自动挂载,一步都不落。
先搞懂:MojoLauncher 渲染器架构
理解扩展流程前,先看一眼四大核心文件,它们各司其职:
| 文件 | 职责 |
|---|---|
| RenderSpec.java | 渲染器规范接口,定义设备兼容性、库文件、环境变量等契约 |
| Renderers.java | 各渲染器标签常量,如 opengles2、vulkan_zink |
| GameRenderer.java | 渲染器总管:解析标签、设置环境、失败时回退 |
| RendererCache.java | 设备兼容性过滤,决定设置界面里显示哪些渲染器 |
具体实现类放在 impl/ 目录 下:GLESRenderSpec.java 承载 GL4ES 与 LTW,MesaRenderSpec.java 承载 Mesa、Zink、Freedreno 等 Vulkan 系渲染器。
官方 7 步指南原文在哪找
在 GameRenderer.java 第 27-38 行 的类注释里,开发者直接写了一份 How to add an extra renderer 的指南,原文大致是:
- 为该渲染器创建一个 RenderSpec
- 添加所有需要的本地化字符串,并接进你的 RenderSpec
- 把渲染器标签加进
getKnownRenderer()的映射- (可选)把标签加进
Renderers类的常量列表- 把标签加进兼容检查列表(见 RendererCache)
- ???
- PROFIT(收益到手)
第 6 步的 "???" 是开发者留的玩笑,实际就是构建并真机测试。下面按顺序展开。
第 1 步:创建 RenderSpec 实现类
RenderSpec 接口要求你提供以下成员,这就是新渲染器的"身份档案":
| 方法 | 说明 |
|---|---|
compatibleDevice(Context) |
判断当前设备能否用此渲染器(如检查 Vulkan 支持、库文件是否存在) |
name() |
内部名称,如 "GL4ES" |
displayName() |
设置界面显示的字符串资源 id |
tag() |
持久化到实例配置的渲染器标签 |
library() |
EGL 动态库文件名,如 libgl4es_114.so |
setupEnvironment(...) |
写入运行所需的环境变量 |
setupRenderer() |
通过 MojoExec.prepareEgl(...) 完成加载 |
参考 GLESRenderSpec 中的 LTWRenderSpec(第 42-61 行) 最省事:继承 GLESRenderSpec 后只需补上 glesVersion() 一个抽象方法。若想接外部独立构建的库,可以模仿 ExtMesaRenderSpec,通过 LibraryPlugin 机制从插件目录发现库文件。
第 2 步:添加本地化字符串
在 strings.xml 第 66-72 行 可以看到现成的命名惯例,全部以 mcl_setting_renderer_ 为前缀:
<string name="mcl_setting_renderer_ltw">LTW (OpenGL ES 3) - 1.17+ only</string>
<string name="mcl_setting_renderer_vulkan_zink">Zink (Vulkan) - all versions</string>
为你的渲染器新增一条同风格条目(建议各语言目录同步更新),然后让 RenderSpec 的 displayName() 返回该资源 id。
第 3 步:注册到 getKnownRenderer()
这是标签字符串到 RenderSpec 实例的总映射。在 GameRenderer.getKnownRenderer()(第 61-77 行) 的 switch 中新增一个 case:
case YOUR_RENDERER: return new YourRenderSpec();
没匹配到的标签会打日志并返回 null,最终回退到默认的 opengles2(GL4ES)。
第 4 步(可选):在 Renderers 中定义常量
Renderers.java 里集中定义了现有标签:opengles2、opengles3_ltw、vulkan_zink、freedreno_kgsl、mesa_desktop 等。为新标签加一行常量能保持代码整洁,但并非必须——直接用字面量也能工作。
第 5 步:加入 RendererCache 兼容检查列表
RendererCache.getCompatibleRenderers()(第 38-57 行) 里的数组被开发者戏称为 "the list that controls em all"(控制一切的名单):
String[] renderers = {
GL4ES_RENDERER, LTW_RENDERER, ZINK_RENDERER,
FREEDRENO_RENDERER, MESA_RENDERER, MESA_RENDERER_EXT,
LEGACYZINK_RENDERER
};
只有出现在这里的标签,才会经过 compatibleDevice() 检查后进入设置下拉框。漏掉这一步,前四步就都白做了。
第 6 步:???(构建 + 真机测试)
用 Gradle 构建应用(详见 README.md 的 Building 部分):
./gradlew :app_mojo:assembleDebug
真机验证要点:
- 打开 设置 → 视频 页面,LauncherPreferenceVideoFragment(第 64-68 行) 会自动从 RendererCache 填充渲染器下拉框,无需改 UI 代码
- 选择你的渲染器启动游戏:GameRunner(第 131-146 行) 负责把选择写入实例并调用
maybeSetupRenderer(),失败时会自动回退 GL4ES - 留意 setupEnvironment 的日志输出("Added renderer env: ..."),确认环境变量注入正确
第 7 步:PROFIT 🎉
到这里,新渲染器已经完整接入:标签可解析、兼容设备才展示、失败有回退、UI 零改动自动挂载。整套流程改动量很小——一个实现类、一条字符串、两个数组注册点,就是 MojoLauncher 渲染器扩展的全部成本。
小结
- 扩展入口认准 RenderSpec 接口,官方指南写在 GameRenderer.java 注释里
- 关键注册点只有两处:
getKnownRenderer()的 case 分支 +RendererCache的标签数组 - UI 与启动链路全自动,改完直接
./gradlew :app_mojo:assembleDebug真机验证即可
