# On-Device Xposed/LSPosed Module Build Pipeline Date: 2026-06-30 Device: Pixel 10 Pro Fold, Android 16, Termux ## Overview Build Xposed modules entirely on-device WITHOUT gradle or Android Studio. Uses the same pipeline as xhshook: javac → d8 → aapt2 → zip → apksigner. ## Toolchain Location All tools already on device at: ``` java 17: /data/data/com.termux/files/usr/bin/java (pkg install openjdk-17) d8: ~/tmp/android-sdk/build-tools/36.0.0/d8 aapt2: /data/data/com.termux/files/usr/bin/aapt2 (pkg install aapt2) apksigner: ~/tmp/android-sdk/build-tools/36.0.0/apksigner android.jar: ~/tmp/android.jar (27MB, platform stubs) Xposed stubs: ~/tmp/xposed-api-stub.jar (5KB, hand-crafted from minimal interfaces) debug keystore: ~/tmp/debug.keystore (pass: android, alias: debug) ``` ## Step-by-Step Build ### 1. Create Xposed API Stubs The `api-82.jar` found on device is a 554-byte POM file, not the actual jar. Create minimal stubs with ONLY the classes you need: ```bash mkdir -p xposed_stub/de/robv/android/xposed mkdir -p xposed_stub/de/robv/android/xposed/callbacks # IXposedHookLoadPackage cat > xposed_stub/de/robv/android/xposed/IXposedHookLoadPackage.java << 'EOF' package de.robv.android.xposed; import de.robv.android.xposed.callbacks.XC_LoadPackage; public interface IXposedHookLoadPackage { void handleLoadPackage(XC_LoadPackage.LoadPackageParam lpparam) throws Throwable; } EOF # XC_LoadPackage (minimal) cat > xposed_stub/de/robv/android/xposed/callbacks/XC_LoadPackage.java << 'EOF' package de.robv.android.xposed.callbacks; public class XC_LoadPackage { public static final class LoadPackageParam { public String packageName; public ClassLoader classLoader; public boolean isFirstApplication; } } EOF # XC_MethodHook (minimal) cat > xposed_stub/de/robv/android/xposed/XC_MethodHook.java << 'EOF' package de.robv.android.xposed; public abstract class XC_MethodHook { public static class MethodHookParam { public Object thisObject; public Object[] args; public Object getResult() { return null; } public void setResult(Object result) {} } protected void beforeHookedMethod(MethodHookParam param) throws Throwable {} protected void afterHookedMethod(MethodHookParam param) throws Throwable {} } EOF # XposedHelpers (minimal) cat > xposed_stub/de/robv/android/xposed/XposedHelpers.java << 'EOF' package de.robv.android.xposed; public class XposedHelpers { public static void findAndHookMethod(String className, ClassLoader cl, String methodName, Object... paramTypesAndCallback) {} public static Object callMethod(Object obj, String methodName, Object... args) { return null; } } EOF # Compile stubs javac -source 17 -target 17 \ -cp ~/tmp/android.jar \ -d xposed_stub \ xposed_stub/de/robv/android/xposed/*.java \ xposed_stub/de/robv/android/xposed/callbacks/*.java cd xposed_stub && jar cf ~/tmp/xposed-api-stub.jar de/ && cd .. ``` ### 2. Compile Java → .class ```bash javac \ -source 17 -target 17 \ -cp ~/tmp/android.jar:~/tmp/xposed-api-stub.jar \ -d build/classes \ app/src/main/java/com/example/hook/MainHook.java ``` ### 3. DEX (class → dex) ```bash D8=~/tmp/android-sdk/build-tools/36.0.0/d8 $D8 --lib ~/tmp/android.jar --min-api 21 \ --output build/ \ build/classes/com/example/hook/*.class # → build/classes.dex ``` ### 4. aapt2 (manifest → base APK) Create minimal AndroidManifest.xml: ```xml ``` ```bash aapt2 link \ --manifest AndroidManifest.xml \ -I ~/tmp/android.jar \ --min-sdk-version 21 \ --target-sdk-version 33 \ --version-code 1 --version-name "1.0" \ -o build/base.apk ``` ### 5. Merge assets + dex → unsigned APK ```bash # Add assets (xposed_init, etc.) mkdir -p build/assets echo "com.example.hook.MainHook" > build/assets/xposed_init cd build/assets && zip -qr ../base.apk . && cd ../.. # Add classes.dex cd build && zip -qj base.apk classes.dex && cd .. ``` ### 6. Sign ```bash APKSIGNER=~/tmp/android-sdk/build-tools/36.0.0/apksigner KEYSTORE=~/tmp/debug.keystore # Generate keystore if needed keytool -genkey -v -keystore $KEYSTORE -alias debug \ -keyalg RSA -keysize 2048 -validity 10000 \ -storepass android -keypass android -dname "CN=Debug" $APKSIGNER sign --ks $KEYSTORE --ks-pass pass:android --key-pass pass:android \ --out build/Module.apk build/base.apk ``` ### 7. Install ```bash su -c "pm install -r /path/to/build/Module.apk" ``` ## Pitfalls 1. **api-82.jar is a fake**: The file at ~/tmp/api-82.jar is 554 bytes (POM only). Always create Xposed API stubs manually. 2. **aapt2 -S not supported**: This version of aapt2 only supports `-R` (compiled .flat files). Skip resources entirely for Xposed modules — they don't need layout/strings/icons. Use `--manifest` only + `--min-sdk-version` etc. to inject SDK versions. 3. **zipalign is x86 binary**: The zipalign at ~/tmp/android-sdk/ is compiled for x86. Skip it — apksigner handles unaligned APKs fine. 4. **INSTALL_FAILED_DEPRECATED_SDK_VERSION**: Must set `--min-sdk-version 21` and `--target-sdk-version 33` in aapt2 link. 5. **No resources needed**: Xposed modules don't need res/values/string.xml or mipmap. A pure manifest-only APK with assets/xposed_init + classes.dex is sufficient.