Files
DroidDeck/tools/nativeguest
Kurt Himebauch dc98b6b96a feat: target Android 14 so Play Protect installs DroidDeck without a warning (#2683)
* fix(proot): ship proot in the APK and run it from the native library directory

* fix(native): start rootfs programs through an APK-shipped exec loader where data files may not be executed

* fix(audio): start PulseAudio through the system linker where data files may not be executed

* feat: target Android 14 (SDK 34) so Play Protect installs DroidDeck without a warning

* fix: ask for all-files access on Android 11+, reject unloadable ELFs before exec, keep checking the proot pack

* fix: hand host scripts to the kernel, skip startup launch while all-files Settings is open

* fix: run proot from its add-on pack through Android's linker, so the APK carries no proot

* fix: declare high sampling rate sensors for controller gyro at target 34

* fix: offer the rootfs proot fallback only where Android lets proot exec its loader

* test: install the runtime's proot pack in GameFileSync fixtures
2026-11-16 09:35:16 -05:00
..

Native userland (no proot)

libddnatv-hook.so is an LD_PRELOAD library that lets the glibc rootfs run directly on Android: it maps the guest's absolute paths into the rootfs (plus the mounts proot used to provide, from DDNATV_BINDS), starts every program through the rootfs's ld.so, and answers the system calls Android's seccomp policy kills a process for (SIGSYS handler). There is no tracer. The app side is runtime/NativeGuest.kt; the setting is Performance > "Run without proot (experimental)".

The hook is derived from the Apache-2.0 libcortex-hook of ssfuisu/cortex (see LICENSE), renamed (cortex -> ddnatv, same length: the code compares environment names by length) and extended with:

  • DDNATV_BINDS mounts, DDNATV_PRELOAD (what /etc/ld.so.preload does for proot), and mapping of guest paths inside LD_PRELOAD;
  • POSIX shm_open/shm_unlink through /dev/shm;
  • starting Wine without its static preloader, which opens files with raw system calls.

Build: tools/nativeguest/build.sh out.so with an aarch64 glibc cross compiler.

Testing under Android's seccomp filter

Some devices (eng builds, setenforce 0 ROMs) run apps with no seccomp filter, so a hook that passes there can still die with SIGSYS on a stock phone (GUEST_EXIT 159). seccomp-sim.c applies a filter that answers the calls Android blocks with SIGSYS, then runs the program:

aarch64-linux-gnu-gcc -static -O2 -o seccomp-sim tools/nativeguest/seccomp-sim.c
# copy it into the rootfs, then name it for every native launch:
echo /usr/local/bin/seccomp-sim > <rootfs>/etc/droiddeck/seccomp-sim

grep Seccomp: /proc/<pid>/status should then show 2 for the session's processes. Empty the file to turn it off. seccomp-sim -a NR,NR PROGRAM leaves the listed calls allowed, to find which one kills a program.