[peiikai]

Second step of bringing in mamcjr's LASRecompAndroid (MIT), on top of the moving guest window from #611. The Android app now builds and opens the start screen, and the game files can be picked and copied in. It can't play yet: building the game code on the device is the next piece. Nothing changes for the desktop builds.

The app (android/)

• Gradle + CMake. libmain.so is the runtime, the Vulkan backend and the UI, built with LARECOMP_DYN_BASE.
• SDL's activity, with our own icon.
• android/deps/build_deps.sh builds SDL3, shaderc, volk and the Vulkan headers for arm64 from pinned sources.
• docs/android.md covers building and running it in the emulator.

Platform layer

• runtime/platform/linux.c now also builds for Android, guarded by __ANDROID__:
  • the log goes to logcat and to lasrecomp.log
  • the data folder and shipped resources come from the app
  • backtraces come from the unwinder
  • there is no re-exec
  • the device name and Android version go in the log
• runtime/main.c: on Linux the moving window can take a free spot from /proc/self/maps. An app process can't restart itself for another memory layout.

Vulkan on Android

• Every function is loaded through volk, because Android's loader exports only Vulkan 1.1 before API 33.
• The swapchain is left unrotated and the compositor turns it, so presents return SUBOPTIMAL by design. That is no longer logged as a failure.
• The app is always full screen.
• The window surface is made again after the app was in the background. Before this, coming back from the folder picker or the home screen gave a black screen.

Game files on Android

• SDL has no folder dialog on Android, so Choose... showed the Linux message about xdg-desktop-portal.
• Choose... now opens Android's own folder picker. Set Up copies exefs and romfs from the picked folder through the storage framework into the data folder, found the same way find_game finds them, with progress and cancel. It then checks and builds as on the desktop.
• The Data folder row is fixed to the app's own folder.

Small shared fixes

• apple_trees.c: kill() renamed, since Bionic's signal.h declares one.
• Bionic's CPU_SET is a statement, so linux.c no longer uses comma forms of it.
• FFmpeg is left out on Android for now (the start screen's background frame). It comes with the movies.

CI

• A new Android job builds the APK and fails if the APK holds anything but the runtime, SDL, shaderc and the shipped fonts and icon.

Tested

• On an arm64 Android 15 emulator (Vulkan 1.3 on an M3 Max):
  • the start screen opens, and touch works
  • lasrecomp.log is written in the data folder
  • Home and back, and the folder picker, return to a drawn screen
  • picking Download/LASGameFiles copied the 1.0.0 files (all 3,836 romfs files), then the build stopped as expected ("the game code builder is missing")
• On macOS, the normal build still plays in Mabe Village.
• Desktop Linux and the new Android CI job get their first full run on this PR.

🤖 Generated with Claude Code