Patching dependencies
There is a patches folder at the root of the repository. If you check it out, it contains source code of other libraries/dependencies that Local Desktop uses.
Local Desktop is built on top of niche, cutting-edge technologies. We frequently face situations where we have to make updates to the code of our libraries/components. Here is our approach: we temporarily clone the component/library and make changes to them. That allows us to move forward without blocking and experiment with features until they are stable enough so that we can create a pull request upstream.
What have we patched so far?
xbuild
- Support
use_cleartext_trafficinAndroidManifest.xml. During the setup phase, Local Desktop shows the documentation website in a webview, and it reports setup progress via WebSocket. Without this option, the WebSocket won't work. - Support
extract_native_libsinAndroidManifest.xml. Local Desktop invokes proot binary, which is placed in the native libs folder. In traditional Android applications, these libraries are intended to be loaded, not to be directly executed, thus they can either be put inside the APK, or extracted to the FS. In Local Desktop, we need the extracted native libraries so that we can invoke them directly. - Patch
gradlebuild process:- Pick up
assetswhen building with gradle. - Support signing if a
release-key.jksis provided. - Compile Java (and Kotlin) sources, Android resources (
res/) and ProGuard rules, so the app can have a few Java classes. - Declare services, activities with intent filters,
meta-dataand a separateprocessinmanifest.yaml. The settings page and the keyboard service need these. - Pin the Android Gradle Plugin and Kotlin plugin versions, so builds don't break when a new one comes out.
- Pick up
- Support building on an Android host (Termux), with an
aapt2override, and NDK r28 for 16 KB page alignment.
The full history is in git log -- patches/xbuild.
smithay
- Load
libEGL.soinstead oflibEGL.so.1. - Create a dummy 1x1 pbuffer surface and use it as both the draw and read surface when calling
eglMakeCurrentto avoid theEGL_BAD_MATCHerror. More details here. - When a driver rejects the EGL 1.5 context attributes with
EGL_BAD_ATTRIBUTE, retry with the olderEGL_CONTEXT_CLIENT_VERSION. This fixed a crash when Android relaunches the app on some devices (#208).
The first version of the patched code can be found here.
winit
winit gives us the Android window and its input events. Our patches:
- Report mouse and touchpad pointer events, not only touches, so a real mouse works.
- Run on Android versions before 13.
- Expose
physical_key()and make the key code module public, so keys from the accessibility service and the trackpad's keyboard can be mapped like real key presses (#343).
Both Smithay and winit are wired in with [patch.crates-io] in Cargo.toml.
build-proot-android & build-libxkbcommon
The patched code and configurations are intended to make cross-compilation work, since these repositories were originally created to build binaries for the host architecture. Local Desktop does not intend to merge these changes back upstream, as the original repositories are not designed for cross-compilation.
PRoot itself is vendored from termux/proot (commit ab2e346), with a few changes on top. The full list is in patches/build-proot-android/README.md:
- Speed. Its seccomp filter only stops the guest for the few
ioctlrequests PRoot rewrites (terminal settings andFICLONE). It used to stop on everyioctl, which is how GPU drivers talk to the kernel, several times per frame. - Built for API 23, so PRoot reads the guest's memory with
process_vm_readvinstead of a fallback that doesn't work on every kernel. This fixed "Device Unsupported" on some phones (#331). chmodon the app's own files bound into the guest is let through, so a script written there can be made executable (#347).fstaton sockets gets the real answer. Node checks its standard streams withfstat, and a child process gets sockets for them, so every Node or Electron child process used to abort at startup (#353).- Meta files for paths with a trailing slash.
--root-idkeeps fake owners and modes in.proot-meta-file.*files. Fordir/, it used to write one inside the directory instead of next to it, where nothing removed it. And when a directory holds nothing but meta files, they are removed with it, since-Hhides them from the program that empties the directory.
build-mesa
A Docker build of Mesa for the Arch Linux ARM guest, producing assets/guest-mesa.tar.xz (run patches/build-mesa/build.sh, which needs Docker with linux/arm64). It enables the KGSL backend for Turnip, which Arch Linux ARM's Mesa leaves out, and carries one patch: Zink can present through kopper on Wayland compositors that offer no DRM render node, which is how labwc runs under proot. See Understanding the architecture.