This is a bash script to build Vulkan Only Turnip Drivers for android as a magisk module and adpkg. Made specifically for compatibilty with Linux-Debian architecture. Linux-Deb users may have encountered a host of problems when attempting to compile the bash script originally given by ilhan-athn7 and later forked by k11mch1; this new bash script bypasses issues surrounding dependency issues, lack of explicit work environment definition, and missing non-linux native host-lib-functions.
The script now successfully builds vulkan.turnip.so (Mesa 26.0.X) for Android aarch64 on Linux Debian; and packages it into a Magisk module and adpkg, ready for installation on Adreno GPU devices. Developer debug tools disabled. GPU Cache disabled.
1. Variable Scope: Fixed a bug where $MESASRC_DIR was used as an absolute path after cding into it, causing double-path errors. Switched to relative paths (src/...) inside the build function.
-
Host vs. Target Mismatch: The linker kept trying to link against x86_64 host libraries (/usr/lib/x86_64-linux-gnu/libz.so, libelf.so) instead of the aarch64 NDK libraries.
-
Fix: Added sed commands to strip these explicit host paths from the generated build.ninja file.
-
Missing libz (Zlib): Disabling zlib caused "undefined symbol" errors (gzopen, deflate, etc.) because parts of the code still called these functions.
-
Fix: Created custom C stubs (zlib_stubs.c) that provide empty implementations of all gz* functions. Compiled these into a static library (libz_stub.a) and injected it into the link command right before --end-group to satisfy the linker without needing the real library.
-
Missing libdl: Meson couldn't find libdl in the cross-compile environment.
-
Fix: Added -ldl explicitly to the linker arguments, relying on the NDK's libc which provides these symbols on Android.
- To bypass complex dependencies that are impossible to resolve cleanly in a cross-compile environment, deliberately disabled non-essential features:
-Dshader-cache=disabled: Prevented the build from requiring zlib for shader caching. (Trade-off: Slightly longer initial game load times after reboot, but no runtime stutter).
-Dzlib=disabled & -Dzstd=disabled: Removed the need for real compression libraries.
-Dspirv-tools=disabled: Avoided header path conflicts with the system spirv-tools.
-Dgallium-drivers=: Disabled the Gallium API (desktop OpenGL) to focus purely on the Vulkan driver, reducing build size and complexity.
-
libfreedreno_drm Error: The perfcntrs/meson.build file referenced a variable that only exists when Gallium is enabled.
-
Fix: Added a sed command to comment out line 40 of src/freedreno/perfcntrs/meson.build before running Meson.
-
Test Tool Failures: Debug tools like ir3_disasm and fd5_layout failed to link due to the host library issues.
-
Fix: Created dummy empty files for these targets in the build directory so Ninja would skip the failed link step and proceed.
-
Dynamic NDK Handling: Replaced hardcoded NDK paths with variables ($ndkver, $NDK_TOOLCHAIN) so the script works with different NDK versions (e.g., r27c or r26d).
-
Redundancy Removal: Consolidated multiple sed patches into single, robust blocks. Removed failed fallback logic and duplicate commands.
-
Magisk Packaging: Streamlined the port_lib_for_magisk function to correctly set permissions, sonames, and generate the update-binary and customize.sh scripts.
- Script now auto populates appropriately consistent naming convention for output zipped files, and meta/config info based upon the particular version you are building.
The final meson setup command that made it all work:
-Dbuildtype=release
-Dplatforms=android
-Dandroid-stub=true
-Dgallium-drivers=
-Dvulkan-drivers=freedreno
-Dvulkan-beta=true
-Dfreedreno-kmds=kgsl
-Dzstd=disabled
-Dspirv-tools=disabled
-Dzlib=disabled
-Dshader-cache=disabled
-Dc_link_args="-L$workdir/stub_libs -lz_stub -ldl"
Downloads the NDK and Mesa source. Patches the source code to remove incompatible features. Generates custom stub libraries to fool the linker. Builds the Vulkan driver. Auto populates correct meta and other config info based on version. Packages it into a flashable Magisk module following consistent naming convention. Packages an ADPKG file ready for emulators, or for other Adreno GPU's by other root method access; following consistent naming convention.
Tested with the apps/games listed here. 🎮
- Ensure program is using Vulkan for best compatibility - try forcing Vulkan via a VulkanSwitching Magisk Module - soon to be forked
- else-OpenGL_ES - Defaults to Vulkan driver for render (vulkan -> egl -> opengles)
- For emulators, or other root level adpkg installs - software or firmware
- Obtain the script [turnip_builder.sh]
- Execute script on linux deb terminal
bash ./turnip_builder.sh - script will require >= 3.3gb of space for work_dir - depending on settings - work_dir can be deleted after exported zips are moved out of work_dir and installed
| Planned | Completed | Purpose |
|---|---|---|
| - Update script so that a readable, reasonable, consistent file naming convention is used | ✅ | Scipt stability feature |
| - Update script to include the auto population of approriate meta and config info to be auto zipped | ✅ | Scipt meta convention consistency feature |
| - Update script to include auto building .adpkg file so manual build isn't necessary (auto zip - contents only! - of both build folders -Magisk/ADPKG) | ✅ | Script ease of access feature |
| - Update script to make version-agnostic; functioning regardless of mesarc version pulled and making inclusive of all version folder paths used by differently named archives and builds | ✅ | Script compatibility feature |
| - Bump Vulkan to v1.4 | Auto | Script will auto populate in reporting programs when Vulkan 1.4 is standardized - ie. Mesa3d repo header update & Vendors update their Vulkan Loader & System Libraries to offer official support and system reporting - No force flags used in compilation |
| - Resolve complex dependency issues to enable shader cache and shader cache compression | Next | Driver efficiency |