Whale Hook 框架使用指南

项目介绍

Whale 是一个跨平台的 Hook 框架，支持在 Android、iOS、Linux 和 MacOS 上运行。它兼容 ARM/THUMB、ARM64、X86 及 X86_64 架构，几乎覆盖了当前市场上的所有主要设备。Whale 提供类似 Xposed 的方法 Hook 功能，并允许在运行时修改类的继承关系及对象所属类，从而绕过隐藏 API 政策。在 iOS 平台上，尽管内联 Hook 限于非越狱设备的调试编译模式，但即将推出名为“Binary Static Inline Hook”的新核心来解决此限制。

特性亮点：

• 支持多种平台的原生 Hook。
• 内置 Just-In-Time (JIT) 引擎，满足高级 Hook 需求。
• 兼容性涵盖多个操作系统版本，包括特定版本的 Android 和 iOS。

项目快速启动

环境准备

确保你的开发环境已经安装了 CMake，并准备好相应的 SDK（对于Android和iOS开发）。

安装与集成

对于Android:

1. 快速集成: 将 built/Android 文件夹下的库文件复制到你项目的 src/main/jniLibs 中。
2. 源码编译: 若需编译源码，在你的 build.gradle 文件中添加外部原生构建配置，指定 CMakeLists.txt 路径。

externalNativeBuild {
    cmake {
        cppFlags ""
        abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        ldFlags ""
        fileName "path_to_your_whale/CMakeLists.txt"
    }
}

对于iOS:

1. 进入 toolchain 目录。
2. 使用CMake配置并编译，确保设置正确的目标平台和架构。

cd toolchain
cmake -DCMAKE_TOOLCHAIN_FILE=ios_toolchain.cmake \
      -DIOS_PLATFORM=OS64 \
      -DPLATFORM=IOS \
      -DIOS_ARCH=arm64 \
      ... # 其他必要参数
make -j4

应用案例与最佳实践

• 上帝模式开启: 通过 Hook 修改应用行为，实现特权功能。
• 应用监控与篡改: 实现对App内部事件的监控或修改。
• 即时热修复: 利用动态Hook技术进行不重启修复。
• 沙箱环境注入: 在系统级别注入Hook，模拟或替换服务。

示例代码片段:

对于简单的Hook操作，首先引入Whale库，然后定义Hook点：

// 假设我们要Hook某个方法
import com.lody.whale.Hook;
import com.lody.whale.annotation.HookMethod;

public class MyHook {

    @HookMethod // 标记要Hook的方法
    public static void hookedMethod() {
        // 在这里执行Hook逻辑
        System.out.println("Method hooked!");
        // 呼叫原始方法，如果需要的话
        // YourOriginalClass.originalMethod();
    }
}

典型生态项目

虽然Whale本身作为一个强大的Hook框架，目前在其官方页面上并未直接提供典型的生态项目列表。然而，开发者可以将Whale应用于各种场景，从定制化的安卓 ROM 修改、安全审计工具的开发，到企业级应用的即时bug修正等，成为移动与桌面应用开发中的强大辅助工具。

考虑到开源社区的性质，用户通常会在论坛、博客和技术分享会上找到基于Whale的实际应用案例，例如在Discord或者专门的技术讨论区。

---

请注意，实际应用中务必遵守目标平台的权限规范和隐私政策，合理合法地利用此类技术。