Ratel 项目使用教程
1. 项目介绍
Ratel 是一个在非 root 环境下使用 Xposed 框架的项目,且不依赖于其他虚拟化容器环境,使得 Xposed 具有二次分包的能力。Ratel 通过嵌入式沙盒机制,为指定的 APK 加壳,并在运行时导入 Xposed 环境,完成 Xposed 模块的加载,从而实现进程内的 hook 功能。
主要特点:
- 非 root 环境:无需 root 权限即可使用 Xposed 框架。
- 独立运行:不依赖于其他虚拟化容器环境。
- 二次分包:支持对 APK 进行二次分包,增强应用的灵活性。
原理:
Ratel 通过嵌入式沙盒机制,为指定的 APK 加壳。在运行时,首先导入 Xposed 环境,完成 Xposed 模块的加载,然后将控制权交给原始的 APK。由于原始 APK 在运行之前已经被 Xposed 框架挟持,因此原始 APK 的行为将受到 Xposed 模块的控制。
依赖:
Ratel 使用 Exposed 替代 Xposed 框架,底层使用阿里的 Dexposed(4.x 以下)或者 Epic(5.x 以上)。
2. 项目快速启动
环境准备
- JDK 1.8 或更高版本
- Gradle 构建工具
克隆项目
git clone https://github.com/mcdevjin/ratel.git
cd ratel
构建项目
./gradlew ratel-driver:assembleDebug
构建工具包
./gradlew ratel-tool:assemble
使用工具包
java -jar ratel-tool/build/libs/ratel-tool-1.0.0.jar test/crackmodule-debug.apk test/demoapp-debug.apk
签名 APK
jarsigner -verbose -keystore ~/Downloads/dwjmantou.keystore com.virjar.ratel.demoapp_1.0_1_ratel_unsigned.apk dwjmantou.keystore
3. 应用案例和最佳实践
应用案例
Ratel 可以用于以下场景:
- 应用测试:在非 root 环境下对应用进行测试,模拟 Xposed 模块的效果。
- 应用开发:在开发过程中,使用 Ratel 进行应用的二次分包,增强应用的灵活性。
最佳实践
- 模块开发:开发 Xposed 模块时,确保模块的挂载时机在
handleBindApplication
到application attachBaseContext
之间,以确保模块能够正常生效。 - 兼容性测试:在不同的 Android 版本和机型上进行测试,确保 Ratel 的兼容性。
4. 典型生态项目
相关项目
- Exposed:Ratel 使用的 Xposed 替代框架,支持进程内 hook。
- Epic:Ratel 在 Android 5.x 以上版本使用的底层 hook 框架。
- Apktool:用于 APK 的反编译和重新打包。
生态项目
- Ratel-Driver:驱动项目,作为打包产生的 APK 的入口,负责组装和加载其他模块。
- Ratel-Tool:一个 Java 项目,作为 Ratel 打包的工具入口,可以构建为一个独立的 JAR 包,提供打包服务。
通过以上步骤,您可以快速上手 Ratel 项目,并在非 root 环境下使用 Xposed 框架进行应用的二次分包和 hook 操作。