手上有台吹米(Trimui)掌机,之前一直只玩它 TF 卡里预装的模拟器 ROM。这次想给它装两个”移植游戏”:《仙剑奇侠传1》和《Undertale(传说之下)》。整个过程踩了不少坑,好在每个都用 adb 实测验证到了”游戏真的跑起来”才算数,整理成这篇笔记。
先交代设备底细,后面的坑都和它有关。
1. 设备:不是安卓,是 TinaLinux
adb 连上之后先看系统:
1 | $ adb devices -l |
- 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 | $ LD_LIBRARY_PATH=/mnt/SDCARD/Ports/sdlpal/lib \ |
移植包的 lib/ 里只有 GL/X11 一族,没有 SDL2;/usr/lib 里也没有。但机器上明明跑着 SDL2 写的原厂程序——搜一下:
1 | $ adb shell find / -name "libSDL2*" 2>/dev/null |
原厂把 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 | SDL_GAMECONTROLLERCONFIG_FILE="./gamecontrollerdb.txt" ./gptokeyb -k "sdlpal" -c "./sdlpal.gptk" & |
gptokeyb(按键映射工具)也要 SDL2,但它启动时 LD_LIBRARY_PATH 还没设置——在别的系统上 SDL2 在系统默认路径所以从没暴露过,吹米上必挂。冒烟测试第一次跑就抓到了:sdlpal 活着,gptokeyb 死了。
解法:把 export 提到最前面重写脚本。然后做真机冒烟测试——精简系统连 timeout 命令都没有,用后台 + sleep + kill 的土办法:
1 | $ adb shell "cd /mnt/SDCARD/Ports/sdlpal && sh ./launch.sh > /tmp/pal.log 2>&1 & \ |
两个进程同时稳定存活,日志干净(只剩一条无害的 libasound 版本警告),这 14 秒里掌机屏幕上已经能看到仙剑的启动画面了。最后到掌机的 Ports 分类里刷新一下列表,”仙剑奇侠传”就出现了(不用重启)。
3. Undertale(gmloader):壳和数据是分开的
Undertale 是 GameMaker 引擎游戏,移植思路完全不同:社区工具 gmloader 直接运行安卓版的 GameMaker 运行时(libyoyo.so)+ 游戏数据(game.droid)。因为 Undertale 是付费游戏,移植包按规矩不带数据,得自己备。
下载到的移植包两层结构:
1 | undertale/ |
两个问题:
其一,外层 Undertale.sh 不能用。它是给各种自定义固件写的通用模板:路径写死 /roms/ports、/opt/...,还有 bash 专属语法(进程替换 >(tee ...)),吹米上是 busybox ash,路径全对不上。解法:参照机器上已装小丑牌的极简模式自己写:
1 |
|
再照仙剑的格式补一个 config.json(label 用了 label.ch.lang 写中文”传说之下”),SDL2 同样从 /rom/usr/trimui/lib/ 复制一份,依赖检查 0 缺失。
其二,才是真正的重头戏:undertale.port 里只有各架构的 libyoyo.so 和启动图,没有任何游戏数据。第一次冒烟测试的日志把这一点写得明明白白:
1 | YoYo Games Android Runner V0.1 ← 引擎起来了 |
用安卓 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 | import zipfile |
运行时特意用 APK 自带的 libyoyo,不用移植包附带的旧版——运行时和游戏数据同构建,钩子符号才对得上。
打了两次包:第一次进了游戏,但没音乐
第一次只打包了 game.droid + splash + libyoyo 三个文件(82MB),推上去一跑——进程稳定存活 30 秒,日志里 Entering main loop、开场房间 BeginToEnd 加载完成、手柄绑定成功,游戏真的进去了。但日志末尾露馅:
1 | _FileExists fail in zip - assets/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. 通用流程总结
给这台机器装任何移植游戏,照这个顺序走基本不踩坑:
- 验包:
file确认二进制 aarch64;config.json对照已装端口格式; - 推送:ASCII 路径下推,核对文件数和目录名(vfat 免 chmod);
- 补库:依赖检查(
/lib/ld-linux-aarch64.so.1 --list),缺 SDL2 就从/rom/usr/trimui/lib/拷; - 审启动脚本:环境变量在所有进程启动之前设好;gmloader 类用极简模板;
- 冒烟测试:后台跑 15~30 秒,
pidof看进程、读日志找成功标志(gmloader 是Entering main loop,音频类移植重点盯could not find audio),然后 kill 干净; - UI 刷新:Ports 列表刷新即见,无需重启。
两台”游戏”现在的状态:仙剑 95 版直接进;《传说之下》测试时已经跑进开场,存档在 /mnt/SDCARD/Ports/undertale/save/。下一个想装的是暗黑1(DevilutionX),不过那又是另一个需要自备数据文件的故事了。