Skip to main content

WhereQ-DOSBox 使用指南:五分钟把 DOS 游戏装进手机

· 17 min read
WhereQ-DOSBoxWhereQ-DOSBox

一份我想要却找不到的指南​

在自己的手机上试用这个应用时,我注意到一件事:我读过的每一份 DOSBox 指南,作者都默认你已经知道 .zip 包是什么。他们直接从有意思的部分讲起——声音芯片、存档格式、JIT——然后假定你从 1994 年起就一直在用 DOS。

对大多数拿着手机的人来说,这个假定是错的。把老游戏搬上现代手机,难的从来不是模拟器,而是最初那五分钟:怎么把游戏弄进手机,而且是应用能启动的形状。

所以我干脆写了一份我想要的那一份。七个步骤,每一步都配一张真机截图,不假设你见过命令行。

五分钟版本​

  1. 安装应用(APK 在发布页)。
  2. 打开它,落到 Files 面板,里面是空的。
  3. 按 + Install a bundle (.zip),选一个 .zip 游戏文件。
  4. 按 Play,游戏就开始了。
  5. 随时按左上角的 File 回到列表。

就这么多。下面全是这五步背后的细节——想弄明白在做什么就读,想直接玩就跳过。

开始之前​

手机Android 5.0 及以上,手机平板都行
空间应用大约 60 MB,再加上游戏本身的大小
网络应用和游戏都在手机上之后,不需要网络
账号不需要

你还需要一个游戏,单个 .zip 文件。这里说的「游戏」不是把你自己的文件打个 ZIP——往下看游戏从哪来?。


第 1 步 —— 安装应用​

应用不在源码仓库里。它由发布流水线构建,发布在发布页上,文件名是 whereq-dosbox-<version>.apk,旁边还有一个 .sha256 文件写着校验和。

把 .apk 拷到手机上——数据线、云盘、文件传输,随你——然后在手机上点它。Android 会问要不要允许这个应用安装,允许就行。

应用会出现在你的主屏幕上,就是那个 >_ 标记:

Android 主屏幕上的 WhereQ-DOSBox 图标,一个深色方块,中间是 >_ 提示符。

主屏幕上的 WhereQ-DOSBox 图标。

应用列表里的名字、通知里的名字、Android 展示应用信息时写的名字,都写着 WhereQ-DOSBox:

WhereQ-DOSBox 的 Android 应用信息页:应用名、版本 1.0.0.13 和应用图标。

WhereQ-DOSBox 的 Android 应用信息页。


第 2 步 —— 安装游戏​

打开应用。你会落到 Files 面板——列出已安装内容的那个界面:

全新安装后空白的 WhereQ-DOSBox Files 面板,顶部是 Install a bundle (.zip) 按钮,下面是 Install all bundles from a folder 按钮。

全新安装后空白的 Files 面板。

两种把游戏放进去的办法,都在面板顶部:

按钮作用
+ Install a bundle (.zip)从手机里选一个 .zip
Install all bundles from a folder把某一个文件夹里的所有 .zip 一次解开

按 + Install a bundle (.zip),系统的文件选择器会打开。选你的游戏 .zip——通常在 Downloads 里——应用会解开它并登记好。面板上就列出它了:

Files 面板里有两个已安装的游戏,starfall-v2 和 F1,每个都带 Play、States、Launch 和 Remove 按钮。

Files 面板里有两个已安装的游戏。

列表里每个游戏有四个按钮:

按钮作用
Play从头开始运行游戏
States为这个游戏存档、读档
Launch…换一段程序来跑,或者在游戏前加载驱动文件
Remove从应用里卸载这个游戏

游戏从哪来?​

这里的游戏是一个形状固定的 .zip:

the bundle
─────────
PLAY.BAT the entry point - the app runs this
<the game files> whatever the game needs
__meta.json the name the app shows in the list

就这些。仓库里附送了一个,你可以照着看形状、马上试起来:examples/game-bundle——就是 STARFALL 演示版。把那个文件夹里的 whereq-demo-bundle.zip 拷到手机上装上就行。

至于真正的游戏:还在托管这些废弃 DOS 游戏的站点,一般都直接给 .zip。如果某个游戏的压缩包里只有游戏文件、没有 PLAY.BAT,应用是起不来的——自己写一个 PLAY.BAT 去运行游戏的可执行文件,再把文件夹压一次。


第 3 步 —— 开始玩​

按 Play。

模拟器会重启应用并引导游戏启动,你落到 DOS 提示符:

DOSBox 欢迎画面和 C:\> 提示符,下方是屏幕键盘。

DOSBox 欢迎画面和 C:\> 提示符,下方是屏幕键盘。

输入游戏的名字,按 Enter。从这一刻起就是真正的游戏了——真正的键盘,真正的声音,真正的鼠标。

这是一款 1994 年的 DOS 游戏跑在手机上的样子:

Formula 1(Domark,1994)跑在手机上,四周是屏幕键盘。

Formula 1(Domark,1994)跑在手机上,四周是屏幕键盘。

这是 STARFALL 演示版:

STARFALL 的标题画面。

STARFALL 的标题画面。

STARFALL 正在游戏中,画面两侧是两块键盘区。

STARFALL 正在游戏中,画面两侧是两块键盘区。

第一次运行游戏时,Android 可能会问要不要允许这个应用发通知。它用通知来提醒你「游戏还在后台」。答哪边都行——拒绝只是少一条提醒:

Android 的通知权限对话框:Allow WhereQ-DOSBox to send you notifications?

Android 的通知权限对话框。

游戏在跑的时候,按左上角的 File 会把 Files 面板拉到上层,面板上会给正在跑的那个游戏显示一行 Resume:

游戏运行中拉出的 Files 面板,列表上方有一行 Resume F1。

游戏运行中拉出的 Files 面板,列表上方有 Resume F1。


第 4 步 —— 键盘和鼠标​

不用外接实体键盘,因为屏幕键盘就是键盘。横屏时画面两侧会出现两块键盘区,像掌机那样摆:左边是方向键组成的十字键加半边 QWERTY,右边是动作键(Alt、Ctrl、Shift、Space、Enter)和另外半边字母。

两个键可以切换键盘区显示的内容:

键显示
#+=标点层
FnF1–F12、Ins/Del、Home/End、PgUp/PgDn、Caps、PrtSc、Pause

切换之后,那个键会亮着。

修饰键有两种用法。 点一下 Ctrl、Alt 或 Shift,它会保持按下状态等你按下一个键——先 Ctrl 再 C。按住它,它的表现就和一个真正的键一样:手指按着多久它就保持多久,游戏里那些开火键、侧移键正是这么用的,另一只拇指同时操控方向。

鼠标就是屏幕本身。 你的手指就是鼠标:拖动是移动指针,点一下是点击,屏幕上的 RMB 键(左边那块,紧挨 Tab)是鼠标右键——在大多数 DOS 游戏里那代表取消或返回。在画面上按住第二根手指也是同一个意思,而且是在那根手指自己的位置上。

把手机转成竖屏,两块键盘区会折成底部的一条,适合画面高比宽大的游戏。


第 5 步 —— 存档​

存档是把整台机器冻住:CPU、内存、显存、声卡芯片、打开着的 DOS 文件句柄,全都冻住。读档之后,游戏正好停在你离开时的样子——哪怕中间应用被关掉过。

按 File,再按游戏旁边的 States:

Save states 面板,三个空档位。

Save states 面板,三个空档位。

一共有三个档位。按 Save 把当前游戏冻进档位 1,面板会告诉你是什么时候存的:

Save states 面板里已存的档位:档位 1 写着两分钟前,带 Save 和 Load 按钮。

已存的档位——档位 1,两分钟前。

关掉面板,Files 面板会为这个游戏保留一行 Resume,写明是哪个档位、什么时候存的:

Files 面板上有一行绿色的 Resume starfall-v2 - slot 1 - just now。

Resume starfall-v2 · slot 1 · just now。

Load 把游戏放回去。档位能撑过退出应用,也能撑过手机重启。


第 6 步 —— 让存档更安全​

存档默认放在应用自己的私有存储里。卸载应用时 Android 会把它删掉——手机丢了、换手机了,也一样。你的游戏和你的存档跟着一起没。

所以应用会问你一次:要不要在你自己掌管的地方再留一份:

Keep your saves safe 提示,首次存档后出现,带 Choose folder 按钮。

首次存档后出现的 Keep your saves safe 提示。

应用自己的对话框里也是同一套说法,随时可以打开看:

Saves folder 对话框,尚未设置任何文件夹,带 Choose folder 和 Close 按钮。

Saves folder 对话框,尚未设置任何文件夹。

按 Choose folder,系统会问要不要允许这个应用访问手机上的某个文件夹:

Android 的文件夹访问授权对话框,带 Use this folder 和 Allow 按钮。

系统对文件夹的授权对话框。

选好文件夹,按 USE THIS FOLDER,再按 ALLOW。从这以后每个档位都会压缩一份镜像到那个文件夹里,就放在游戏旁边。

你随时可以在 Config → Saves folder 下查看或更换这个文件夹:

WhereQ-DOSBox 的设置对话框。

设置对话框。

Saves folder 对话框,已经设置好文件夹。

Saves folder 对话框,已经设置好文件夹。

两点提醒:

  • Android 不允许应用直接占用整个 Download 文件夹,那个权限太宽了。挑别的文件夹就行——Documents 完全可以。
  • 你只需要回答这一次,应用不会再问。

第 7 步 —— 重装之后,或者换了新手机​

这就是那个文件夹的用处。

把应用卸载,重新装上,选同一个文件夹。应用会进去一看,你的游戏还在——它们从来就不在应用里面:

应用卸载之后,手机上那个文件夹里的内容:游戏包和已保存的档位。

应用卸载之后,手机上那个文件夹里的内容。

应用会认出那些没被安装的游戏,问你要不要把它们带回来:

Restore games 提示,询问是否把未安装的游戏带回来。

Restore games 提示。

按 Restore,它们连名字带存档一起回来:

Files 面板里恢复出来的两个游戏,存档也在。

恢复出来的两个游戏,存档也在。

而存档仍然记得自己是什么时候存的:

恢复出来的存档档位,仍然写着三分钟前。

恢复出来的档位,仍然写着三分钟前。

最后这一行就是整个功能的意义所在。三分钟前存的存档,就写着三分钟前——哪怕它是从文件夹里重新装回一个新装的版本。


东西都放在哪里​

inside the app the folder you picked
──────────── ───────────────────
the games <your folder>/
the save-state slots <game name>/
slot1.gz
slot2.gz
bundle.zip

gone when the app is removed stays until you delete it

出问题了怎么办​

你看到的意味着怎么办
「That save file is damaged」这个档位是旧版本写的存档格式升过版本号,太旧的档位会被拒绝而不是读错。重新存一个新档位。
游戏起不来包里没有 PLAY.BAT,或者入口指错了打开那个 .zip,确认 PLAY.BAT 能运行游戏的可执行文件
按 Play 没动静模拟器正在重启来引导游戏等几秒——进程是故意重启的,游戏会在新进程里起来
键盘挡住了画面两块键盘区占了画面两侧把手机转成竖屏,键盘会折成底部一条
鼠标点不动游戏要的是「按住」状态拖动用来移动;右键用屏幕上的 RMB 键,或者在画面上按住第二根手指
Download 文件夹选不了Android 不允许应用占用整个 Download换一个文件夹,比如 Documents
弹出通知授权应用想发「回到游戏」的通知允许或拒绝都行——拒绝只是少这条通知
游戏很卡模拟器跑的是当年的硬件,不是快机器这是 1994 年那台机器本来的速度,不是手机慢

接下来​

这篇就是指南。仓库里存着同一份文档,以及它背后的一切:

👉 github.com/whereq/whereq-dosbox——源码、示例包、问题追踪,指南本身在 docs/USER-GUIDE.md。

**技术参考**是长文——原生构建怎么做、存档机制怎么把整台机器拍下来、FM 芯片怎么被精确还原、包怎么变成一个跑起来的 DOS 程序、屏幕键盘怎么把按键送进模拟器、以及构建流水线。它是写给工程师看的,不是给拿着手机的人看的。

**发布页**上有 APK 和它的校验和。

致谢 DOSBox​

没有 DOSBox 项目,这一切都不可能。

DOSBox 由 DOSBox Team 写成——一群志愿者把 1994 年的一套操作系统改造到此后世界造出的每一台机器上都能跑,包括那些当时还不存在的机器。他们让它活过了三十年,并免费交给任何想要的人。WhereQ-DOSBox 只是建在他们工作之上的一层薄薄的壳。原创力、手艺和慷慨完全属于他们。

这个移植基于 Em-DOSBox——Boris Gjenero 做的 DOSBox r4305 的 Emscripten 版,它又来自 Ismail Khatib 最早那次用 Emscripten 编译 DOSBox 的尝试,并且踩着 Alon Zakai 的 Emscripten 工作一路往前。窗口、音频和触摸输入则由 Sam Lantinga 的 SDL2 库承担。

DOSBox 是 DOSBox 项目的商标;这个移植与 DOSBox 团队没有任何隶属或背书关系。


上面每一张截图都是真机,跑的是正式签名的 APK。这里没有任何一张是效果图。