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:
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
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)
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 version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.hook">
<application>
<meta-data android:name="xposedmodule" android:value="true" />
<meta-data android:name="xposeddescription" android:value="Hook Module" />
<meta-data android:name="xposedminversion" android:value="82" />
</application>
</manifest>
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
# 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
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
su -c "pm install -r /path/to/build/Module.apk"
Pitfalls
api-82.jar is a fake: The file at ~/tmp/api-82.jar is 554 bytes (POM only). Always create Xposed API stubs manually.
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--manifestonly +--min-sdk-versionetc. to inject SDK versions.zipalign is x86 binary: The zipalign at ~/tmp/android-sdk/ is compiled for x86. Skip it — apksigner handles unaligned APKs fine.
INSTALL_FAILED_DEPRECATED_SDK_VERSION: Must set
--min-sdk-version 21and--target-sdk-version 33in aapt2 link.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.