Whale
Overview
Whale is a cross-platform Hook Framework, allowed to run Android、IOS、Linux、MacOS.
Whale support both ARM/THUMB, ARM64, X86, X86_64 (AMD64), This covers almost all the major devices available today.
Feature
Android
- Xposed-Style Method Hook
- Modify the inheritance relationship between classes at runtime
- Modifies the class to which the object belongs at runtime
- bypass
Hidden API Policy
Darwin/Linux Platforms
- Internal symbol resolver
- Native Hook
IOS Restrictions
InlineHook on IOS is only usable in debug compile mode on non-jailbreak devices.
Release compilation mode will not work properly.
To solve this problem，Whale will provide a new core named Binary Static Inline Hook.
Binary Static Inline Hook will open source in the near future.
What can you do with it?
- Turn on the god mode of an app
- The act of monitoring or tampering with app
- Instant hotfix
- SandBox
- Inject to system and instead of Xposed
Compatibility
- Android 5.0.0
- Android 5.1.1
- Android 6.0
- Android 6.0.1
- Android 7.1.2
- Android 8.1.0
- Android 9.0.0
- IOS 11.3
- IOS 12.0
- MacOS mojave (10.14)
- (Not in the list means
untested）
InlineHook
For pcrel instruction, Whale will convert it to pc-independent instruction，
If the Hook procedure have not convert instructions, please feedback to issue.
About Jit
Whale has a built-in Jit Engine, When you have more advanced Hook requirements, you can directly generate executable instructions in memory through the Jit.
There is no longer the need to generate ugly hard code through tools as before.
Compile
We have pre-built binary versions of Android & IOS. You can find them in the built directory.
Whale uses CMake to build projects, so you need to install CMake on your system.
Android
-
If you need to use
Java Hookplease copy java folder to your project. -
Direct use of binary，You just copy the files under
built/Androidtosrc/main/jniLibsin your project. -
If you need to compile the source code, specify
CMakeLists.txtin build.gradle:
externalNativeBuild {
cmake {
path "your/whale/path/CMakeLists.txt"
}
}
IOS
cd toolchain
cmake .. \
-DCMAKE_TOOLCHAIN_FILE=ios.toolchain.cmake \
-DIOS_PLATFORM=OS64 \
-DPLATFORM=IOS \
-DIOS_ARCH=arm64 \
-DENABLE_ARC=0 \
-DENABLE_BITCODE=0 \
-DENABLE_VISIBILITY=0 \
-DIOS_DEPLOYMENT_TARGET=9.3 \
-DSHARED=ON \
-DCMAKE_BUILD_TYPE=Release
make -j4
Ohter platforms
cmake .
make -j4
Technogy communication
Email: imlody@foxmail.com