CVS: commit code.

Author: asLody

.gitignore

@@ -1,3 +1,5 @@
+.idea
+.DS_Store
 CMakeCache.txt
 CMakeFiles
 CMakeScripts

CMakeLists.txt

@@ -0,0 +1,9 @@
+cmake_minimum_required(VERSION 3.4.1)
+
+set(CMAKE_CXX_STANDARD 14)
+add_subdirectory(whale)
+include_directories(whale/include)
+include_directories(whale/src)
+
+#add_executable(test whale/test/test_hook.cc)
+#target_link_libraries(test whale)

README.md

@@ -1,6 +1,106 @@
-# whale
-## The next generation Hook Engine For Android/IOS/Linux/MacOS
+# Whale
+![logo][0]
 
+[Chinese Version](https://github.com/asLody/whale/blob/master/README.zh-CN.md)
 
-## This project is about to open source, Please click the `WATCH` in the upper right corner to follow the project :)
+## 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-Stylae** 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
+- [x] Android 5.0.0
+- [x] Android 5.1.1
+- [x] Android 6.0
+- [x] Android 6.0.1
+- [x] Android 7.1.2
+- [x] Android 8.1.0
+- [x] Android 9.0.0
+- [x] IOS 11.3
+- [x] IOS 12.0
+- [x] 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
+1. If you need to use ` Java Hook ` please copy java folder to your project.
+
+2. Direct use of binary，You just copy the files under ++built/Android++ to ++src/main/jniLibs++ in your project.
+
+3. If you need to compile the source code, specify `CMakeLists.txt` in 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
+> [GOTO => Discord](https://discord.gg/j2Cdy2g)
+
+
+[0]: https://github.com/asLody/whale/blob/master/LOGO.png?raw=true

README.zh-CN.md

@@ -0,0 +1,105 @@
+# Whale
+![logo][0]
+
+## 概述
+Whale是一个跨平台的Hook Framework，同时支持Android、IOS、Linux、MacOS。
+Whale 支持**ARM/THUMB、ARM64、X86、X86_64 (AMD64)**，这几乎覆盖了目前所有主流的设备。
+
+## 特性
+#### Android
+* **Xposed-Style** Method Hook
+* 运行时修改类之间的继承关系
+* 修改对象所属的类
+* 绕过`Hidden API Policy`
+
+#### Darwin/Linux Platforms
+* Internal symbol resolver
+* Native Hook
+
+#### IOS的限制
+IOS的InlineHook在非越狱设备上只限在debug编译模式下开启，
+release编译模式下将无法正常工作。
+
+为了解决这个问题，Whale将提供`Binary Static Inline Hook`。
+
+IOS下的`Binary Static Inline Hook`将在近期开源。
+
+
+## 你可以用它做什么？
+* 开启App的上帝模式
+* 监控或篡改软件的行为
+* 即时生效的热修复
+* SandBox
+* 注入到系统代替Xposed
+
+## Whale的兼容性
+- [x] Android 5.0.0
+- [x] Android 5.1.1
+- [x] Android 6.0
+- [x] Android 6.0.1
+- [x] Android 7.1.2
+- [x] Android 8.1.0
+- [x] Android 9.0.0
+- [x] IOS 11.3
+- [x] IOS 12.0
+- [x] MacOS mojave (10.14)
+- (不在清单内表示 ++未测试++ ）
+
+## InlineHook
+对于`pcrel指令`, Whale会将其转换为`pc 无关指令`，
+如果在Hook过程有遇到未转换的指令，请提`issue`。
+
+## 关于Jit
+Whale内置了 **Jit Engine**, 当你有更高级的Hook需求时可以通过Jit直接在内存中生成可执行的指令。
+不再需要像从前那样通过工具来生成丑陋的hard code。
+
+## 编译
+我们已提前编译了Android & IOS的**二进制版本**，您可以在`built目录`找到它们。
+
+Whale使用了CMake来构建项目，所以你需要在你的系统上安装CMake。
+
+#### Android
+1. 如果需要使用`Java Hook`, 请把java文件夹的代码复制到你的项目。
+
+2. 直接使用二进制，你只需要复制 ++built/Android++ 下你所需的abi到你的项目的src/main/jniLibs下。
+
+3. 如果需要编译源码，请在build.gradle中指定CMakelists.txt：
+```
+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 -j8
+```
+
+## Technogy communication
+> **QQ Group: 977793836**
+
+
+
+[0]: https://github.com/asLody/whale/blob/master/LOGO.png?raw=true

built/Android/arm64-v8a/libwhale.so

@@ -0,0 +1,105 @@
+package com.lody.whale;
+
+import java.lang.reflect.Constructor;
+import java.lang.reflect.Member;
+import java.lang.reflect.Method;
+import java.util.HashMap;
+
+/**
+ * @author Lody
+ */
+class VMHelper {
+
+    // Holds a mapping from Java type names to native type codes.
+    private static final HashMap<Class<?>, String> PRIMITIVE_TO_SIGNATURE;
+
+    static {
+        PRIMITIVE_TO_SIGNATURE = new HashMap<>(9);
+        PRIMITIVE_TO_SIGNATURE.put(byte.class, "B");
+        PRIMITIVE_TO_SIGNATURE.put(char.class, "C");
+        PRIMITIVE_TO_SIGNATURE.put(short.class, "S");
+        PRIMITIVE_TO_SIGNATURE.put(int.class, "I");
+        PRIMITIVE_TO_SIGNATURE.put(long.class, "J");
+        PRIMITIVE_TO_SIGNATURE.put(float.class, "F");
+        PRIMITIVE_TO_SIGNATURE.put(double.class, "D");
+        PRIMITIVE_TO_SIGNATURE.put(void.class, "V");
+        PRIMITIVE_TO_SIGNATURE.put(boolean.class, "Z");
+    }
+
+    /**
+     * Returns the internal name of {@code clazz} (also known as the
+     * descriptor).
+     */
+    private static String getSignature(final Class<?> clazz) {
+        final String primitiveSignature = PRIMITIVE_TO_SIGNATURE.get(clazz);
+        if (primitiveSignature != null) {
+            return primitiveSignature;
+        } else if (clazz.isArray()) {
+            return "[" + getSignature(clazz.getComponentType());
+        } else {
+            return "L" + clazz.getName().replace('.', '/') + ";";
+        }
+    }
+
+    /**
+     * Returns the native type codes of {@code clazz}.
+     */
+    private static String getShortyType(final Class<?> clazz) {
+        final String primitiveSignature = PRIMITIVE_TO_SIGNATURE.get(clazz);
+        if (primitiveSignature != null) {
+            return primitiveSignature;
+        }
+        return "L";
+    }
+
+    // @SuppressWarnings("ConstantConditions")
+    private static String getSignature(final Class<?> retType,
+                                       final Class<?>[] parameterTypes) {
+        final StringBuilder result = new StringBuilder();
+
+        result.append('(');
+        for (final Class<?> parameterType : parameterTypes) {
+            result.append(getSignature(parameterType));
+        }
+        result.append(")");
+        result.append(getSignature(retType));
+
+        return result.toString();
+    }
+
+    private static String getShorty(final Class<?> retType,
+                                    final Class<?>[] parameterTypes) {
+        final StringBuilder result = new StringBuilder();
+
+        result.append(getShortyType(retType));
+        for (final Class<?> parameterType : parameterTypes) {
+            result.append(getShortyType(parameterType));
+        }
+
+        return result.toString();
+    }
+
+    static String getSignature(final Member m) {
+        if (m instanceof Method) {
+            final Method md = (Method) m;
+            return getSignature(md.getReturnType(), md.getParameterTypes());
+        }
+        if (m instanceof Constructor) {
+            final Constructor<?> c = (Constructor<?>) m;
+            return getSignature(void.class, c.getParameterTypes());
+        }
+        return null;
+    }
+
+    static String getShorty(final Member m) {
+        if (m instanceof Method) {
+            final Method md = (Method) m;
+            return getShorty(md.getReturnType(), md.getParameterTypes());
+        }
+        if (m instanceof Constructor) {
+            final Constructor<?> c = (Constructor<?>) m;
+            return getShorty(void.class, c.getParameterTypes());
+        }
+        return null;
+    }
+}