Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/binarycounter/bogodroid
Highly experimental framework for running NDK Android Apps on ARM Linux
https://github.com/binarycounter/bogodroid
Last synced: about 2 months ago
JSON representation
Highly experimental framework for running NDK Android Apps on ARM Linux
- Host: GitHub
- URL: https://github.com/binarycounter/bogodroid
- Owner: binarycounter
- License: gpl-3.0
- Created: 2024-02-03T07:55:24.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-02-18T20:48:52.000Z (11 months ago)
- Last Synced: 2024-11-02T20:03:16.731Z (2 months ago)
- Language: C
- Homepage:
- Size: 818 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Bogodroid
### **WARNING: VERY EARLY IN DEVELOPMENT, VERY NON-FUNCTIONAL, CODE QUALITY QUESTIONABLE**
This is an experimental project attempting to create a wrapper environment around native libraries (armeabi) from Android Apps, with the intent of running the libraries (or entire apps and games) on ARM Linux (armhf and arm64) handhelds.
The project is heavily based on [JohnnyOnFlame/droidports](https://github.com/JohnnyonFlame/droidports) and [ChristopherHX/libjnivm](https://github.com/ChristopherHX/libjnivm).
The idea is to:
- load the libraries, patch them at runtime
- wrap, bridge or stub any required symbols from Android system libraries
- Provide a JNI interface for communication with placeholder "java" classes
- Provide implementations and stubs for common java and android classes
- Ultimately wrap Audio, GLES and Input to host interfaces and libraries.
This project does not aim to be able to run your App out of the box. It is meant as a framework or starting point for your own porting project. For existing porting projects, check the "Ports in progress" table and the projects folder.
# How to Build (Debug)
(This process will be simplified later on)
1. Create a armhf chroot environment for building and testing. I recommend [this VM](https://forum.odroid.com/viewtopic.php?p=306185#p306185) image as a starting point.
2. Inside your chroot, get the requisites `apt install cmake git libzip-dev`
3. Clone the repository into your chroot
4. Create the folder "./libjnivm/build" inside the repository and enter it
5. `cmake .. -DJNIVM_ENABLE_TRACE=ON -DJNIVM_ENABLE_GC=ON -DJNIVM_ENABLE_DEBUG=ON -DJNIVM_USE_FAKE_JNI_CODEGEN=ON `
6. `make -j8`
7. Create the folder "./build" inside the repository and enter it
8. `cmake ..`
9. `make -j8`
By default this will build the `unityloader` project. If you want to build a different project, you can specify the project in step 8 with `cmake .. --build -DPROJ=`
# Running
*Please note that most loaders require /proc to be mounted, which is not the case in the chroot environment in the VM image. Run `mount -t proc none /proc` as root inside the chroot environment to fix this.*
`unityloader` and `limboloader` use a TOML config file to configure paths and properties. Example config files are provided in `configs/`. If you run the program directly from the build directory and have extracted your Unity game APK in `gamefiles/unity/` you can use this config without changes:
`./unityloader ../configs/unity.toml`
**Warning: hexagonloader is broken until I implement TOML configs there aswell**
# Debugging with QEMU and GDB-multiarch
(This expects the chroot environment as provided by [this VM](https://forum.odroid.com/viewtopic.php?p=306185#p306185))
1. Exit your chroot, we will call the binary directly
2. Enter the build directory
3. Start the binary with:
`QEMU_LD_PREFIX=/mnt/data/armhf/ qemu-arm-static -g 5 ./unityloader ../configs/unity.toml`
4. Open another terminal and type in `gdb-multiarch`
5. Enter the location of your chroot: `set sysroot /mnt/data/armhf`
6. Enter the location of your binary: `file /mnt/data/armhf/root/bogodroid/build/unityloader`
7. Connect to the open GDB session in QEMU: `target remote :5`
6. "c" to run the program, "si" to step a single instruction, "bt" to read stack trace, "break" to set breakpoint. ***Refer to the GDB manpage and internet resources on how to debug***
# JNI Tracing your App
(This requires a rooted Android device and a computer with ADB and Python installed)
1. [Install a Frida server on your Android device](https://frida.re/docs/android/)
2. Install jnitrace on your computer: `pip install jnitrace`
3. Run the trace: `jnitrace -o jnitrace.json com.example.myapplication`
4. Press CTRL-C to finish aquiring data
5. `jnitrace.json` will contain all JNI calls made by the application
6. `python tools/jnitrace_parse.py ` will give you a consolidated tree of all classes, methods and fields (and their signatures) accessed during the tracing period.
See `tools/unity_traces` for a trace of a minimal Unity game starting up
# Ports in Progress
| Name | Project Name | Status | Notes |
|-----------------------------------|---------------|---------------|--------------------------------------------------------------------------------------------------------------------|
| Unity (Mono) | unityloader | Not Booting | Makes it 70% through initialization. Crashes when Mono creates first thread. Pthread bridge needs to be reworked. |
| Super Hexagon | hexagonloader | Not Booting | Crashes very early during init while writing first log message. Issue with libc++_shared.so |
| Limbo | limboloader | Loading Screen| Immediately crashes after first frame of the loading screen. Requires implementation of `ALooper` function bindings|
| Crazy Taxi Classic | taxiloader | Investigated | Requires better file handling for loading the big OBB files, before it can be attempted. |
| Terraria | - | Not attempted | (Engine: FNA, Monogame port might be easier) |
| Baba is you | - | Not attempted | |
| Super Meat Boy Forever | - | Not attempted | |
| Streets of rage 4 | - | Not attempted | (Engine: FNA, Monogame port might be easier) |
| Chrono Trigger | - | Not attempted | (Engine: cocos2d-x) |
| Dead Cells | - | Not attempted | |
| Brotato | - | Not attempted | |
| Castlevania Symphony of the Night | - | Not attempted | |
| Five Nights At Freddy | - | Not attempted | |
| Gris | - | Not attempted | |
| The Way Home | - | Not attempted | |
| Vampire Survivors | - | Not attempted | |
| Scourgebringer | - | Not attempted | |
| Haak | - | Not attempted | |