原生 Xposed 服务集成

2026-09-10T09:56:15+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 路径、混淆规则、命名空间和重复依赖。升级镜像或应用后重新验证。