Hello World

吞风吻雨葬落日 欺山赶海踏雪径

0%

吹米 Trimui 掌机 adb 装机实战:仙剑1 与 Undertale

手上有台吹米(Trimui)掌机,之前一直只玩它 TF 卡里预装的模拟器 ROM。这次想给它装两个”移植游戏”:《仙剑奇侠传1》和《Undertale(传说之下)》。整个过程踩了不少坑,好在每个都用 adb 实测验证到了”游戏真的跑起来”才算数,整理成这篇笔记。

先交代设备底细,后面的坑都和它有关。

1. 设备:不是安卓,是 TinaLinux

adb 连上之后先看系统:

1
2
3
4
5
$ adb devices -l
1c000c6605064751d5d device product:€肂 model:__B device:€肂

$ adb shell uname -a
Linux TinaLinux 4.9.191 #407 SMP PREEMPT ... aarch64 GNU/Linux
  • TinaLinux(全智 A133P 平台,4× Cortex-A53),不是 Android,但自带 adbd 所以 adb 照常能用;
  • model 显示 __B、product 是乱码,这是吹米固件的老毛病,不影响使用;
  • 存储就一个 TF 卡,挂载在 /mnt/SDCARD(57.5G):
1
/dev/mmcblk1p1 on /mnt/SDCARD type vfat (rw,fmask=0000,...)

卡里是标准吹米目录:Roms(约 2500 个模拟器 ROM,GBA/MAME/PS 等 30 多个平台)、Ports、RetroArch、Emus 等。

Ports 是什么

Ports(移植游戏)和 Roms(模拟器)是两条完全不同的路线:

Roms + Emus(模拟) Ports(移植)
原理 模拟器伪装成 FC/GBA 主机跑卡带 游戏程序重新编译成 ARM Linux 原生代码直接跑
开销 大 小,所以这台入门机也能跑 DOOM 级别
代表 模拟器 ROM 仙剑(sdlpal)、Undertale(gmloader)、小丑牌、星露谷

Ports 目录名的约定来自社区工具 PortMaster(这台机器预装了 v6.55):每个游戏一个目录,放一个 config.json 描述菜单项、一个 launch.sh 启动脚本。原厂 UI 开机扫描这个目录生成游戏列表。机器上已经装好的小丑牌就是这个结构,照着抄就行。

2. 仙剑1(sdlpal):三个坑

sdlpal 是仙剑 95 版的开源重制引擎,社区有打包好的 PortMaster 移植包:主程序 + 仙剑原版 .mkf 数据文件 + 配置,共 42 个文件 253MB。下载的包先做两件事:确认二进制是 aarch64(file 命令看,三个可执行文件都是 ARM aarch64 ✅)、确认 config.json 格式和机器上已有的小丑牌一致(✅,label 已经写好”仙剑奇侠传”)。然后开始推。

坑一:中文路径毁掉 adb push 的目标目录名

第一版命令:

1
adb push "E:/游戏/Trimui/games/sdlpal" "/mnt/SDCARD/Ports/"

adb 报告 42 个文件全部推送成功,但设备上的目录名变成了 sdl 而不是 sdlpal——中文路径 游戏 经过 Windows adb.exe 传参时把编码搞乱了,文件本身没事,目标目录名被截断。

解法:换到 ASCII 路径再推,或者事后在设备上改回来都行:

1
adb shell "mv /mnt/SDCARD/Ports/sdl /mnt/SDCARD/Ports/sdlpal"

推完一定要核对文件数(本地 42 = 设备 42)和目录名。

坑二:系统里找不到 libSDL2

用动态链接器做依赖检查(不等同于真跑,但能把缺库提前暴露):

1
2
3
$ LD_LIBRARY_PATH=/mnt/SDCARD/Ports/sdlpal/lib \
/lib/ld-linux-aarch64.so.1 --list /mnt/SDCARD/Ports/sdlpal/sdlpal
error while loading shared libraries: libSDL2-2.0.so.0: cannot open shared object file

移植包的 lib/ 里只有 GL/X11 一族,没有 SDL2;/usr/lib 里也没有。但机器上明明跑着 SDL2 写的原厂程序——搜一下:

1
2
3
4
5
$ adb shell find / -name "libSDL2*" 2>/dev/null
/rom/usr/trimui/lib/libSDL2-2.0.so.0 ← 在这
/rom/usr/trimui/lib/libSDL2_image-2.0.so.0
/rom/usr/trimui/lib/libSDL2_mixer-2.0.so.0
...

原厂把 SDL2 全家桶放在只读 rootfs 的 /rom/usr/trimui/lib/,这个路径不在默认搜索路径里。解法:把 SDL2 复制进移植包自己的 lib/(launch.sh 的 LD_LIBRARY_PATH 正好覆盖到),不动系统:

1
adb shell "cp /rom/usr/trimui/lib/libSDL2-2.0.so.0 /mnt/SDCARD/Ports/sdlpal/lib/"

顺带一提,TF 卡是 fmask=0000 的 vfat,所有文件自动带执行权限,不需要 chmod。

坑三:launch.sh 的环境变量顺序写反了

包里自带的启动脚本:

1
2
3
4
SDL_GAMECONTROLLERCONFIG_FILE="./gamecontrollerdb.txt" ./gptokeyb -k "sdlpal" -c "./sdlpal.gptk" &
sleep 1
export LD_LIBRARY_PATH=$(dirname "$0")/lib:$LD_LIBRARY_PATH ← 在 gptokeyb 之后才设置
HOME=/mnt/SDCARD $progdir/sdlpal

gptokeyb(按键映射工具)也要 SDL2,但它启动时 LD_LIBRARY_PATH 还没设置——在别的系统上 SDL2 在系统默认路径所以从没暴露过,吹米上必挂。冒烟测试第一次跑就抓到了:sdlpal 活着,gptokeyb 死了。

解法:把 export 提到最前面重写脚本。然后做真机冒烟测试——精简系统连 timeout 命令都没有,用后台 + sleep + kill 的土办法:

1
2
3
4
5
$ adb shell "cd /mnt/SDCARD/Ports/sdlpal && sh ./launch.sh > /tmp/pal.log 2>&1 & \
sleep 14; pidof sdlpal; pidof gptokeyb; \
kill -9 \$(pidof sdlpal) \$(pidof gptokeyb)"
4146 ← sdlpal 活着
4139 ← gptokeyb 也活着了

两个进程同时稳定存活,日志干净(只剩一条无害的 libasound 版本警告),这 14 秒里掌机屏幕上已经能看到仙剑的启动画面了。最后到掌机的 Ports 分类里刷新一下列表,”仙剑奇侠传”就出现了(不用重启)。

3. Undertale(gmloader):壳和数据是分开的

Undertale 是 GameMaker 引擎游戏,移植思路完全不同:社区工具 gmloader 直接运行安卓版的 GameMaker 运行时(libyoyo.so)+ 游戏数据(game.droid)。因为 Undertale 是付费游戏,移植包按规矩不带数据,得自己备。

下载到的移植包两层结构:

1
2
3
4
5
6
7
8
undertale/
├── Undertale.sh ← PortMaster 通用启动模板
└── undertale/ ← 游戏本体目录
├── gmloadernext.aarch64 ← gmloader 加载器
├── undertale.port ← 数据包(zip 格式)
├── undertale.gptk ← 按键映射
├── lib/ ← openal/zip/crypto 等库
└── ...

两个问题:

其一,外层 Undertale.sh 不能用。它是给各种自定义固件写的通用模板:路径写死 /roms/ports、/opt/...,还有 bash 专属语法(进程替换 >(tee ...)),吹米上是 busybox ash,路径全对不上。解法:参照机器上已装小丑牌的极简模式自己写:

1
2
3
4
5
6
7
#!/bin/sh
cd $(dirname "$0")
export LD_LIBRARY_PATH=$(dirname "$0")/lib:$(dirname "$0")/lib/arm64-v8a:$LD_LIBRARY_PATH
/mnt/SDCARD/Ports/PortMaster/gptokeyb "gmloadernext.aarch64" -c "undertale.gptk" &
sleep 1
./gmloadernext.aarch64 -c "./gmloader.json" > log.txt 2>&1
kill -9 $(pidof gptokeyb)

再照仙剑的格式补一个 config.json(label 用了 label.ch.lang 写中文”传说之下”),SDL2 同样从 /rom/usr/trimui/lib/ 复制一份,依赖检查 0 缺失。

其二,才是真正的重头戏:undertale.port 里只有各架构的 libyoyo.so 和启动图,没有任何游戏数据。第一次冒烟测试的日志把这一点写得明明白白:

1
2
3
4
5
YoYo Games Android Runner V0.1        ← 引擎起来了
Importing GL ← 显示正常
RunnerLoadGame: game.droid
_FileExists fail in zip - assets/game.droid
Unable to find game!! ← 卡死在这

用安卓 APK 重打包数据包

正版的安卓 APK 里就有 gmloader 要的一切。手上有个 undertale.apk(2020-03 官方构建,149MB),解包验证三样东西:

  • assets/game.droid:76.4MB,游戏数据本体 ✅
  • lib/arm64-v8a/libyoyo.so:运行时 ✅
  • assets/ 下还有 200 多个独立的 .ogg —— 全部背景音乐(后面有大用)

打包用 Python(设备上没有 zip 命令,PC 端搞定),存储模式等价于原脚本的 zip -r -0:

1
2
3
4
5
6
7
8
import zipfile

apk = zipfile.ZipFile("D:/download/undertale.apk.v2.0.1.apk")
names = [n for n in apk.namelist()
if n.startswith("assets/") or n == "lib/arm64-v8a/libyoyo.so"]
with zipfile.ZipFile("undertale.port", "w", zipfile.ZIP_STORED) as out:
for name in names:
out.writestr(name, apk.read(name))

运行时特意用 APK 自带的 libyoyo,不用移植包附带的旧版——运行时和游戏数据同构建,钩子符号才对得上。

打了两次包:第一次进了游戏,但没音乐

第一次只打包了 game.droid + splash + libyoyo 三个文件(82MB),推上去一跑——进程稳定存活 30 秒,日志里 Entering main loop、开场房间 BeginToEnd 加载完成、手柄绑定成功,游戏真的进去了。但日志末尾露馅:

1
2
_FileExists fail in zip - assets/mus_story.ogg
COggAudio::PlaySound- could not find audio file for sound mus_story.ogg

原来安卓版 Undertale 的音乐不在 game.droid 数据包里,而是 APK assets 下的独立 ogg 文件,引擎按文件名现取现放。只打数据文件等于无声版。

解法:把 APK 的 全部 assets(217 个文件,含全部音乐)+ libyoyo 一起打进去,最终 176MB。重新推送后再跑 30 秒:

  • 进程存活 ✅
  • 主循环进入、开场加载 ✅
  • 音频错误 0 条 ✅

到掌机上刷新 Ports 列表,”传说之下”出现,直接能玩。日志里剩余的 undertale.ini / config.ini 找不到是首次运行的正常现象,存档后自动生成。

4. 踩坑清单

# 坑 现象 解法
1 adb push 中文路径 42 文件推成功但目录名 sdlpal→sdl cd 到父目录用相对名推,或事后设备端 mv
2 系统 SDL2 不在默认路径 依赖检查报 libSDL2-2.0.so.0 找不到 从 /rom/usr/trimui/lib/ 复制进移植包 lib/
3 launch.sh 顺序 bug gptokeyb 启动失败 export LD_LIBRARY_PATH 提到所有启动之前
4 通用启动模板不兼容 Undertale.sh 里 bash 语法 + CFW 路径 仿已装端口的极简模式重写
5 移植包不含商业数据 Unable to find game!! 用自备 APK 的 game.droid 重打包 port
6 只打 game.droid 进游戏但 BGM 报 could not find audio file APK 的全部 assets 都要打进 port
7 精简系统没 timeout 没法限时跑冒烟测试 后台 & + sleep + kill -9 $(pidof ...)

5. 通用流程总结

给这台机器装任何移植游戏,照这个顺序走基本不踩坑:

  1. 验包:file 确认二进制 aarch64;config.json 对照已装端口格式;
  2. 推送:ASCII 路径下推,核对文件数和目录名(vfat 免 chmod);
  3. 补库:依赖检查(/lib/ld-linux-aarch64.so.1 --list),缺 SDL2 就从 /rom/usr/trimui/lib/ 拷;
  4. 审启动脚本:环境变量在所有进程启动之前设好;gmloader 类用极简模板;
  5. 冒烟测试:后台跑 15~30 秒,pidof 看进程、读日志找成功标志(gmloader 是 Entering main loop,音频类移植重点盯 could not find audio),然后 kill 干净;
  6. UI 刷新:Ports 列表刷新即见,无需重启。

两台”游戏”现在的状态:仙剑 95 版直接进;《传说之下》测试时已经跑进开场,存档在 /mnt/SDCARD/Ports/undertale/save/。下一个想装的是暗黑1(DevilutionX),不过那又是另一个需要自备数据文件的故事了。