原生 Xposed 服務整合

2026-09-23T15:37:56+08:00

適用範圍與依賴

僅適用於 FoxPhone 支援的 AOSP 10 / AOSP 12 原生映像，最低 Android API 26。先確認原生啟用元件支援；不保證第三方應用相容。請勿同時加入另一套 Xposed Bridge。

下載與校驗

下載平台提供的 xposed-bridge-debug.aar，核對大小及 SHA-256。放入 app/libs/，使用 compileOnly 引用，避免重複打包 Bridge。

Size: 271231 bytes
SHA-256: D9DC538315E875D83357B3986CC27D1F7535BE17D9F3F6E69C2F327C9A23FC98

Kotlin DSL · app/build.gradle.kts

dependencies {
    compileOnly(files("libs/xposed-bridge-debug.aar"))
}

Groovy · app/build.gradle

dependencies {
    compileOnly files('libs/xposed-bridge-debug.aar')
}

建立入口

在 Android Studio 建立 No Activity 專案。在 app/src/main/assets/xposed_init 每行填寫一個完整入口類別名稱。命名空間為 de.robv.android.examed，請勿替換為其他 Bridge 套件名稱。

com.example.myapplication.Main

package com.example.myapplication;
import de.robv.android.examed.IXposedHookLoadPackage;
import de.robv.android.examed.XposedBridge;
import de.robv.android.examed.callbacks.XC_LoadPackage;
public class Main implements IXposedHookLoadPackage {
    @Override
    public void handleLoadPackage(XC_LoadPackage.LoadPackageParam param) throws Throwable {
        if (!"com.example.target".equals(param.packageName)) { return; }
        XposedBridge.log("Native Xposed module loaded: " + param.packageName);
    }
}

建置、啟用與驗證

實作入口類別，只對授權目標套件執行邏輯。程式碼縮減時加入 keep 規則。確認 APK 包含 assets/xposed_init，安裝至支援裝置，透過原生元件啟用，再啟動目標應用檢查日誌。

-keep class com.example.myapplication.Main { *; }

載入失敗時檢查映像、入口類別、assets 路徑、混淆規則、命名空間及重複依賴。更新映像或應用後重新驗證。