on-device-xposed-build.md 5.66 KB

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

  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.