How xoureldeen/vectras-vm-android works
Project type and purpose
• Vectras VM is a multi-module Android application that embeds QEMU to emulate virtual machines (Windows, Linux, macOS, Android) on Android devices.
• It comprises an “app” module (the Android UI, services, VM manager), supporting modules (library/X11 server, shell-loader, terminal-emulator, terminal-view), plus web and asset resources (bootstraps, ISO wrappers).
File structure
• Top-level Gradle modules:
– app: main Android APK, Activities, Fragments, Services, JNI integration, VNC viewer, proot wrapper, QMP client
– library: pure-Java X11 server implementation (au.com.darkside.xserver) used by app
– shell-loader: AIDL + stub for loading native binaries (JNI, ActivityThread hacks) to start QEMU
– terminal-emulator & terminal-view: reusable terminal core and view components (ByteQueue, TerminalEmulator, TerminalView)
• assets in app/src/main/assets: QEMU bootstraps (Alpine images, 3dfx wrappers, ROMs)
• configuration files: AndroidManifest.xml in each module, build.gradle at root & per-module, ProGuard rules, fastlane metadata
• web folder: static front-end for documentation, store JSON for remote ROM store
README for additional insights
• Confirms: Android 6.0+ target, QEMU-based VM manager, uses PROOT, VNC and X11 for display, GitHub API for blog posts, OkHttp & Gson for networking, Glide for images.