跳到主要内容

A-DOS — source code and licences

A-DOS is the Android port of DOSBox. It embeds the DOSBox emulator core, which is GPLv2, so A-DOS is a GPLv2 work as well.

GPLv2 puts two obligations on every copy of the program, and this page is where both of them are answered:

  • §2 — the licence and the copyright notices have to travel with the program. The app carries them: open the game launcher and tap Licences in its footer to see the full GNU General Public License version 2 and the attribution notices.
  • §3 — everyone who receives the program has to receive its source as well. The complete source of each build is published below.

The source of the current release​

Version1.0.0.0 (versionCode 1000000)
Source commit8746a77
LicenceGNU General Public License, version 2
Archivea-dos-1.0.0.0-source.tar.gz
SHA-25646aa5e38026dbd480117821c384ca41fde1b58bccbfe9b46654672a24f24d8e7

Verify it before you build it:

curl -LO https://whereq.github.io/downloads/a-dos-1.0.0.0-source.tar.gz
sha256sum a-dos-1.0.0.0-source.tar.gz
# 46aa5e38026dbd480117821c384ca41fde1b58bccbfe9b46654672a24f24d8e7

The archive is the tree of the release commit plus a SOURCE-RELEASE.md that names the version, the commit and the build. The shipped build was made from 649880c; what came after it is the fix of the regression test in examples/, which is not part of the app, and the Game Mode gamepad with the release notes that describe it. It holds the DOSBox core with its per-file copyright and licence headers intact, the Android application, the NDK/CMake build of the native library, the desktop Linux baseline, the benchmark, the dev toolchain and the build scripts.

What this build adds​

Game Mode turns the on-screen keyboard into a gamepad: a full-screen overlay with an 8-way D-pad, a trackball and a face button, in three profiles — HYBRID, ACTION and POINT & CLICK — with per-game button remaps. It is opened from the keyboard with a Konami code and left with the hardware Back button. The implementation lives in android/app/src/main/java/com/whereq/ados/GameModeView.kt in the archive, and the release notes in docs/releases/1.0.0.0.md describe the gesture and the profiles.

Building it​

./bin/build.sh bootstrap # fetch SDL2 and build the toolchain
./bin/build.sh android --abis "arm64-v8a armeabi-v7a x86_64"
./bin/build.sh apk --release # the signed APK

BUILDING.md and bin/build.sh doctor say what is missing.

SDL2 is not in the archive. third_party/fetch-sdl2.sh downloads the exact release the build uses — SDL2 2.30.0 — from

https://github.com/libsdl-org/SDL/releases/download/release-2.30.0/SDL2-2.30.0.tar.gz

./bin/build.sh bootstrap runs that fetch for you.

Try it — the example bundle​

The archive carries an example bundle: STARFALL, a tiny DOS game written for this project. It is published on its own as well, so that the bundle launcher can be seen working without building anything:

Archivea-dos-demo-bundle.zip
SHA-256fa53db56ac78ecf4dead745a247c1d970950ae0442d2763b0730e6689bf20a36
ContentsSTARFALL.COM, PLAY.BAT, README.TXT

To install it in the app:

  1. Download a-dos-demo-bundle.zip to the phone.
  2. Open A-DOS and tap the File key on the on-screen keyboard (top left) to open the bundle launcher.
  3. Tap Install a bundle (.zip) and pick the downloaded file.
  4. It appears in the list. Tap Play and the emulator reboots into STARFALL.

The app itself ships no games — this bundle is an example, published with the source code, and the user brings their own software.

The licence of every part​

PartLicenceWhat it means
DOSBox core (src/, include/, scripts/, visualc_net/)GPLv2the emulator itself, © the DOSBox Team and its contributors, imported with its headers, AUTHORS, ChangeLog and COPYING intact
The WhereQ porting work (android/, native/, bench/, toolchain/, bin/)GPLv2a derivative of the core, so it cannot be relicensed under MIT or anything more permissive
SDL2 (statically linked into libdosbox.so)zlibthe notice has to travel with the binary and is in NOTICE; its source does not have to be published
Kotlin standard library, AndroidXApache-2.0runtime dependencies; neither collects nor transmits anything

The full text of the licence is in COPYING, the attribution notices are in NOTICE, and both are in the archive and in the app itself.

Earlier work​

The native port this app grew out of is public as whereq/whereq-dosbox — the DOSBox core, the JNI glue and the build scripts under GPLv2. The emulator core in A-DOS is that same code with the product name changed; what sits on top of it is A-DOS's own application layer — the Play build — and its own documentation, which is why the snapshot above is published separately.

Trademarks​

"DOSBox" is a trademark of the DOSBox project. A-DOS is not affiliated with, sponsored or endorsed by the DOSBox team.

See also​