WhereQ-DOSBox 1.0.0.9:把键盘改造成掌机


一个戴着键盘外形的妥协
DOS 的画面是 4:3,手机横过来是 20:9。多出来的那部分就是左右两条黑边,前两个版本里,键盘就住在那两条黑边上。
那两条黑边并不算糟。方向键排成真键盘上的倒 T 形,修饰键和编辑键在另一侧,画面占住了整个屏幕中间。用起来是没问题的。
但对一个想模拟的东西来说,那是错的形状。DOS 游戏是左手拇指管方向、右手拇指管按键的,而这些键全都不在拇指习惯待的地方。
掌机是怎么做的
掌机的做法是:屏幕放中间,操作键分到两只手上——一边一个——而且绝不让按键盖到画面上。
1.0.0.9 就是照着这个来的。那两条黑边不再是「能塞多少塞多少」的两列键,而是两块手柄区,画面依然完整地留在中间。

左手那半负责方向键和左半边键盘,右手那半负责动作键和右半边。画面留在中间, 没有一个键画在它上面。
左半边是负责转向的那只手:四个方向键做成十字键——上键在最上面,左右并排,下键在最下面,手指靠形状就能读出方向——再往上是劈成两半的 QWERTY 的左半边,最顶上一排是 File、Esc 和 Tab。
右半边是负责操作的那只手:拇指下面是 Alt、Ctrl、Shift、Space 和 Enter,往上是 QWERTY 的右半边,最顶上一排是 #+=、Fn 和退格。
QWERTY 是「劈开」的,不是「缩小」的。左边是 12345 qwert asdfg zxcvb,右边是 67890 yuiop hjkl: nm./\——每一半都是正常尺寸的真键,而不是把整块键盘缩小后的玩具。
三层,一个键一层
键盘劈成两半只解决了一半问题;另一半是键不够用的时候怎么办。这里的答案是一层一个键,就放在右半边最上面那一排。
#+= 把两半同时换成标点。切到这一层时,这个键会亮成蓝色,并且变成 abc——因为按下它就是回到字母层。

标点层。每个带 Shift 的字符就在它对应的不带 Shift 的键正下方,被切走的那个键会亮起来。
Fn 换来功能键:左边是 F1 到 F12,右边是 Ins / Del、Home / End、PgUp / PgDn、Caps、PrtSc 和 Pause。

功能层——整个 F 排和编辑键,一个字母键都不用让出来。
而右半边的字母层本身就已经带着 : . / \,所以敲一条 DOS 路径根本不需要切层:C:\GAMES\DUNE\SETUP.EXE 只是一串字母加标点,在同一层上顺序按下去就行。
Ctrl、Alt 和 Shift,按游戏想要的方式来
修饰键是我想得最久的一部分,因为两种游戏对 Ctrl 的要求是不一样的。
点一下 Ctrl、Alt 或 Shift 会让它待命:接下来按的那个键会被修饰,然后修饰键自己松开。Ctrl、然后 C——文本编辑器和 DOS 命令行要的就是这个。
按住则是一直按着,直到你松手,和真键盘一样。这正是游戏对开火键和移动键的期待:右拇指按住 Ctrl,左拇指在十字键上走,游戏两个都收得到。
旧键盘只能做前一种。新的手柄区两种都能做,因为修饰键无非就是一个「处于按下状态」的键。
布局跟着屏幕走
不是每部手机都能腾出 20:9 那么宽的黑边,所以键盘会按黑边的宽度挑自己的形态:宽度够(至少 116 dp)就用完整的两块手柄区,差一点就退回到每侧一列键加上可折叠的 QWERTY 面板,竖屏则是贴底边的一条窄条。
下面这部分我并不满意。

同一套布局在 18:9 屏幕上。手柄区照样放得下,但字母键明显小了——大约 24 dp 宽, 而 20:9 屏上是 33 dp。
在 20:9 屏上,字母键的宽度是 32.8 dp。到了 18:9 屏——很多手机就是这个比例——黑边变窄,同一套布局下字母键只剩 23.6 dp,大约是屏幕宽度的 2.9 %,而正常手机键盘的一个键差不多是这个的两倍。十字键和动作键不受影响,挤小的只有字母。
这个数是量出来的,不是我猜的:两种宽度都在模拟器上跑过、也都实际敲过字,三层布局在两种宽度下的截图都在仓库里。我没有做的是在真正的 18:9 手机上试——这台设备上没有的读者如果愿意替我补上这一课,我很想听。
底下什么都没变
这一版全是应用层的工作。SDL 的 surface 依然是全屏,键盘只画在画面两侧的黑边里,libdosbox.so 和 1.0.0.8 发出来的是同一个库——同样的原生核心,同样的编译参数。
有时候,描述一个大改动最诚实的方式,是说清楚什么没有变。
流水线现在会自己出版本
这个仓库第一次有了 CI 流水线。每次推送和每个 PR,ci.yml 都会把模拟器从源码编译三个 ABI——SDL2 加整个 DOSBox 核心,编译三遍——再在上面打包出应用,并检查三个原生库确实都进了 APK。
遇到 v* 标签时,release.yml 会编译发布版 APK、用发布密钥签名、比对证书指纹,然后把它连同 SHA-256 一起发成 GitHub Release。
密钥本身放在仓库的 secrets 里——keystore 用 base64 编码,密码和别名放在旁边——绝不进代码库。流水线会拒绝发布证书对不上的构建:换了密钥签出来的 APK 装不上旧版本,而让用户在自己的手机上发现这件事,不是发现的好地方。
拿去用
发布版 APK 就在仓库里,用发布密钥签名,可以直接覆盖安装 1.0.0.8:
👉 github.com/whereq/whereq-dosbox — tag v1.0.0.9
downloads/whereq-dosbox-1.0.0.9.apk
sha256: cd6d0bdafd0f84c7324936c89a6cab14ed87a21e4211ed8909078b4a7a51ac02
它跑在 arm64-v8a、armeabi-v7a 和 x86_64 设备上,要求 Android 5.0 及以上,完全离线,不需要账号,没有任何追踪。项目采用 GPL-2.0 许可,DOSBox 核心连同它的 AUTHORS、ChangeLog、COPYING 和逐文件头注释一起嵌入。
再说一遍:这篇文章不是文档。 文档是仓库本身:构建指南、移植日志(里面有一节专门讲那三条宽度规则和量出来的键宽)、键盘本身的设计笔记,以及这个移植的每一行代码。请去读那些,而不是信我的一面之词。
谢谢 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 团队没有任何隶属或背书关系。
如果你手上的手机屏幕比较窄、觉得字母键太小——请告诉我。这一版里唯一一件我希望在发布前就见到真机的事情,与其我自己发现,不如你来告诉我。