SandHook框架手机版(SandVXposed)

SandHook框架手机版是一款面向 Android 平台的开源 Hook 框架。核心能力覆盖 Java 层（ART 环境） 与 Native 层（Inline Hook），支持高精准指令级拦截，兼容 Xposed API，是安卓逆向、插件化与功能定制的核心工具之一。

SandHook怎么用？

下载进入SandHook软件，授予各种权限

进行不同的设置即可

SandHook配置需求

系统支持：Android 4.4（ART 环境）至 11.0（含开发者预览版），覆盖 32/64 位架构（ARM32/Thumb-2/ARM64）。

开发依赖：核心库 hooklib（Java 层）、nativehook（Native 层），注解 API 用于快速定义 Hook 规则，Xposed 兼容包用于生态复用。

开源生态：项目托管于 GitHub，配套 SandVXposed（免 Root 沙箱）、EdXposed（分支适配）等工具，支持快速落地插件化场景。

快速上手教程

集成依赖：在项目 build.gradle 中引入核心库与注解 API

// Java 层核心库

implementation 'com.swift.sandhook:hooklib:4.2.0'

// Native 层核心库

implementation 'com.swift.sandhook:nativehook:4.2.0'

// 注解 API（用于定义 Hook 规则）

provided 'com.swift.sandhook:hookannotation:4.2.0'

// Xposed 兼容包（按需选择）

implementation 'com.swift.sandhook:xposedcompat:4.2.0'

定义 Hook 规则：通过注解标注目标方法与 Hook 逻辑，示例如下：

// 示例：拦截 Activity 的 onCreate 方法

public class ActivityHooker {

    @HookMethod("android.app.Activity")

    public static void onCreate(@ThisObject Activity thiz, Bundle savedInstanceState) {

        // 执行原方法逻辑（可选）

        HookMethodBackup.onCreate(thiz, savedInstanceState);

        // 自定义逻辑（如打印日志、修改参数）

        Log.d("SandHook", "Activity 已创建：" + thiz.getClass().getSimpleName());

    }

}

初始化与加载：在 Application onCreate() 中初始化 SandHook，加载 Hook 规则：

public class MyApp extends Application {

    @Override

    public void onCreate() {

        super.onCreate();

        // 开启调试（可选，OS ≥ 8.0 需目标进程可调试）

        SandHookConfig.DEBUG = BuildConfig.DEBUG;

        // 禁用内联优化（OS ≥ 7.0，针对易被内联的方法）

        SandHook.disableVMInline();

        // 加载 Hook 规则

        SandHook.addHookClass(ActivityHooker.class);

    }

}

注意事项

内联优化处理：Android 7.0+ 需调用 SandHook.disableVMInline() 避免方法被 JIT 内联，导致 Hook 失效；针对 dex2oat 内联可通过 SandHook.tryDisableProfile() 处理。

版本与权限：OS ≥ 8.0 需确保目标进程开启 debuggable 权限；低版本（≤ 5.1）需注意备份方法的调用逻辑，避免内联问题。

使用边界：不支持抽象方法 Hook（逻辑不走 ArtMethod，替换无效）；Native 层短方法（≤ 16 字节）优先用 SandSingleInstHook 实现。