mabbcoll13/xposed-module-kit
GitHub: mabbcoll13/xposed-module-kit
Xposed/LSPosed 模块开发脚手架,提供可复用的 Hook 模板、Gradle 构建配置和离线类扫描工具,帮助开发者快速搭建 Android Hook 模块。
Stars: 5 | Forks: 1
# Xposed Module Kit
[](LICENSE)
一个“开箱即用”的脚手架,用于在 Android 上构建 **Xposed / LSPosed** 模块,
并附带了一小组用于发现 hook 目标的命令行辅助工具。
## 功能
- 用于 Xposed / LSPosed 模块的 Gradle 构建配置 (api 82 → 93)。
- `src/hooks/` 下可复用的 hook 模板:
- `HookTemplate` – before/after hook 的抽象基类。
- `MethodHook` – 按名称 + 签名 hook 单个方法(防御性)。
- `PackageHook` – 将 hook 限定在目标 package 范围内。
- `src/utils/` 下用于离线分析的 Python 工具:
- `logger.py` – 彩色控制台日志记录器。
- `class_scanner.py` – 解析已编译的 `.class` 文件(或 `.jar`)并生成
可直接使用的 hook 桩代码。
- `examples/bypass_root_check/` – 完整示例:中和常见的
root 检测逻辑(针对 `su` 的 File.exists、`Runtime.exec`、`Build.TAGS`)。
## 项目结构
```
xposed-module-kit/
├── build.gradle / settings.gradle / gradle.properties
├── app/ # Android module project
│ ├── build.gradle
│ └── src/main/java/com/qtphone/xposedkit/
│ ├── MainHook.java # IXposedHookLoadPackage entry
│ ├── XKitLogger.java
│ └── hooks/ # HookTemplate / MethodHook / PackageHook
├── examples/bypass_root_check/ # Root-detection bypass example
└── src/utils/ # Python dev tooling
├── logger.py
└── class_scanner.py
```
## 构建模块
```
# 需要 Android SDK + JDK 17
./gradlew assembleRelease
# 安装生成的 APK,然后在 LSPosed 中启用该 module。
```
## 使用 class_scanner.py
```
cd src/utils
python class_scanner.py path/to/decompiled/classes --filter com.example --emit-hooks
```
这会打印出每个非构造函数方法,以及为每个方法生成一行可直接复制粘贴的
`MethodHook.hookMethod(...)` 代码。
## 免责声明
本工具仅供您拥有或获得授权测试的设备与应用进行**安全研究、教育及合法测试**。作者不对任何滥用行为承担责任。
标签:Android开发, JS文件枚举, LSPosed, SOC Prime, Xposed, 云资产清单, 免杀/防御绕过, 后台面板检测, 开发工具, 逆向工具, 逆向工程