xHook 使用教程

xHook 使用教程

xHook 🔥 A PLT hook library for Android native ELF. 项目地址: https://gitcode.com/gh_mirrors/xh/xHook

1. 项目介绍

xHook 是一个用于 Android 平台上的 PLT（Procedure Linkage Table）hook 库，专门针对 Android 原生 ELF（可执行文件和共享库）进行优化。xHook 旨在提供稳定性和兼容性，支持 Android 4.0 到 10（API 级别 14 到 29），并且支持多种架构，包括 armeabi、armeabi-v7a、arm64-v8a、x86 和 x86_64。

xHook 的主要特点包括：

• 支持 ELF HASH 和 GNU HASH 索引符号。
• 支持 SLEB128 编码的重定位信息。
• 支持通过正则表达式设置 hook 信息。
• 不需要 root 权限或任何系统权限。
• 不依赖任何第三方共享库。

2. 项目快速启动

2.1 环境准备

首先，确保你已经安装了 Android NDK r16b，并将 NDK 的路径添加到系统的 PATH 环境变量中。

export PATH=$PATH:/path/to/android-ndk-r16b

2.2 下载 xHook

使用 Git 克隆 xHook 项目到本地：

git clone https://github.com/iqiyi/xHook.git
cd xHook

2.3 构建和安装

在项目根目录下，运行以下命令来构建和安装 xHook 的本地库：

./build_libs.sh
./install_libs.sh

2.4 运行示例

进入 xhookwrapper 目录，并使用 Gradle 构建和安装示例应用：

cd xhookwrapper
./gradlew assembleDebug
adb install ./app/build/outputs/apk/debug/app-debug.apk

3. 应用案例和最佳实践

3.1 检测内存泄漏

通过 hook malloc、calloc、realloc 和 free 函数，可以实现内存泄漏的检测：

xhook_register(".*\\.so$", "malloc", my_malloc, NULL);
xhook_register(".*\\.so$", "calloc", my_calloc, NULL);
xhook_register(".*\\.so$", "realloc", my_realloc, NULL);
xhook_register(".*\\.so$", "free", my_free, NULL);

3.2 检查套接字生命周期

通过 hook 与套接字相关的函数，可以监控套接字的生命周期：

xhook_register(".*\\.so$", "getaddrinfo", my_getaddrinfo, NULL);
xhook_register(".*\\.so$", "socket", my_socket, NULL);
xhook_register(".*\\.so$", "setsockopt", my_setsockopt, NULL);
xhook_register(".*\\.so$", "bind", my_bind, NULL);
xhook_register(".*\\.so$", "listen", my_listen, NULL);
xhook_register(".*\\.so$", "connect", my_connect, NULL);
xhook_register(".*\\.so$", "shutdown", my_shutdown, NULL);
xhook_register(".*\\.so$", "close", my_close, NULL);

3.3 过滤和保存 Android 日志

通过 hook Android 日志相关的函数，可以将日志保存到本地文件：

xhook_register(".*\\.so$", "__android_log_write", my_log_write, NULL);
xhook_register(".*\\.so$", "__android_log_print", my_log_print, NULL);
xhook_register(".*\\.so$", "__android_log_vprint", my_log_vprint, NULL);
xhook_register(".*\\.so$", "__android_log_assert", my_log_assert, NULL);

4. 典型生态项目

xHook 可以与其他 Android 开发工具和库结合使用，例如：

• Android Studio: 用于开发和调试 Android 应用。
• NDK: 用于编写和编译原生代码。
• GDB: 用于调试原生代码。
• Valgrind: 用于检测内存泄漏和性能问题。

通过结合这些工具，开发者可以更高效地进行 Android 应用的开发和调试。

xHook 🔥 A PLT hook library for Android native ELF. 项目地址: https://gitcode.com/gh_mirrors/xh/xHook