# legend

**Repository Path**: tib/legend

## Basic Information

- **Project Name**: legend
- **Description**: A framework for hook java methods.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2016-02-13
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Legend
--------
![logo][2]
--------
## What is Legend?

Legend is a **Hook framework** for **Android Development**, it allows you to Hook Java methods **without** ROOT. Even more exciting is that it supports both **Dalvik and Art** environment!


### 1. What is the good
- Programming more **efficient**
- Dynamic debugging
- **HotFix** and needn't reboot app
- Fast **dump** Dex File in the shell
- Software security penetration
- Do some exciting things...


### 2. How to use
Example 1: **Annotation** type Hook
```java
@Hook("android.widget.Toast::show")
public static void Toast_show(Toast thiz) {
  thiz.setText("XXXXXXXXX");
  //Call the origin method
  HookManager.getDefault().callSuper(thiz);
}
```
Example 2: **Interception** of startActivity
```java
@Hook("android.app.Activity::startActivity@android.content.Intent")
public static void Activity_startActivity(Activity thiz, Intent intent) {
  if (!ALLOW_LAUNCH_ACTIVITY) {
    Toast.makeText(thiz, "I am sorry to turn your Activity down :)", Toast.LENGTH_SHORT).show();
  }else {
    HookManager.getDefault().callSuper(thiz, intent);
}
}
```
#### Notice:
- Write the following code down in where you want to your hooks **enable**.
```java
HookManager.getDefault().applyHooks(YourClass.class);
```
- You can also hook a method **without annotation**.
```java
HookManager.getDefault().hookMethod(originMethod, hookMethod);
```

### 3. Compatibility
- [x] Dalvik & Android 4.2
- [x] Dalvik & Android 4.3
- [x] Art & Android 5.0
- [x] Art & Android 5.0.1
- [x] Art & Android 5.1
- [x] Art & Android 6.0
- [x] Art & Android 6.0.1
- [ ] aliyunOS VM

### 4. Help improve Legend
```java
If (Country.China == your.country) {
  QQGroup.join(530497973);
} 
else {
  webView.loadUrl("https://github.com/asLody/legend/issues");
}
```
### 5. Author

> [Lody][3]

[2]: https://raw.githubusercontent.com/asLody/legend/master/art/legend_logo.png
[3]: https://github.com/asLody