{"id":33196957,"url":"https://github.com/turing-technician/fasthook","last_synced_at":"2025-11-25T21:01:07.349Z","repository":{"id":41368158,"uuid":"174653264","full_name":"turing-technician/FastHook","owner":"turing-technician","description":"Android ART Hook","archived":false,"fork":false,"pushed_at":"2019-05-15T06:47:53.000Z","size":233,"stargazers_count":570,"open_issues_count":16,"forks_count":153,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-03-13T13:39:33.603Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/turing-technician.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-09T05:37:59.000Z","updated_at":"2025-03-05T11:13:30.000Z","dependencies_parsed_at":"2022-07-19T00:47:23.988Z","dependency_job_id":null,"html_url":"https://github.com/turing-technician/FastHook","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/turing-technician/FastHook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turing-technician%2FFastHook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turing-technician%2FFastHook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turing-technician%2FFastHook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turing-technician%2FFastHook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/turing-technician","download_url":"https://codeload.github.com/turing-technician/FastHook/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turing-technician%2FFastHook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286079811,"owners_count":27282121,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-25T02:00:05.816Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-16T08:00:28.999Z","updated_at":"2025-11-25T21:01:07.334Z","avatar_url":"https://github.com/turing-technician.png","language":"C","funding_links":[],"categories":["\u003ca id=\"2110ded2aa5637fa933cc674bc33bf21\"\u003e\u003c/a\u003e工具"],"sub_categories":["\u003ca id=\"596b6cf8fd36bc4c819335f12850a915\"\u003e\u003c/a\u003eHOOK"],"readme":"# FastHook\n一种高效稳定、简洁易用的Android Hook框架，**实际项目验证，拥有远超其他同类框架的优异稳定性**。\n实现原理，请参考\n- [**FastHook——一种高效稳定、简洁易用的Android Hook框架**](https://blog.csdn.net/TuringTechnician/article/details/88613555)\n- [**FastHook——巧妙利用动态代理实现非侵入式AOP**](https://blog.csdn.net/TuringTechnician/article/details/88925234)\n# 使用\n提供两种使用方式：**配置方式**、**Callback方式**\n- **配置方式**：代码取master分支\n- **callback方式**：代码取callback分支\n\n## 配置方式\n提供一个Hook信息类，可以是任意类，但是必须定义有**static String[] HOOK_ITEMS**；例如\nHookInfo.java\n```\nprivate static String[] mHookItem = {\n            \"mode\",\n            \"targetClassName\",\"targetMethodName\",\"targetParamSig\",\n            \"hookClassName\",\"hookMethodName\",\"hookParamSig\",\n            \"forwardClassName\",\"forwardMethodName\",\"forwardParamSig\"\n};\npublic static String[][] HOOK_ITEMS = {\n            mHookItem\n};\n```\nmode:提供两种hook模式：\"1\":**Inline Hook(性能高效)**；\"2\":**EntryPoint替换模式(弥补Inline Hook在一些情况下不能Hook的缺陷)**\n\n**接口**\n```\n/**\n *\n *@param hookInfoClassName HookInfo类名\n *@param hookInfoClassLoader HookInfo类所在的ClassLoader，如果为null，代表当前ClassLoader\n *@param targetClassLoader Target方法所在的ClassLoader，如果为null，代表当前ClassLoader\n *@param hookClassLoader Hook方法所在的ClassLoader，如果为null，代表当前ClassLoader\n *@param forwardClassLoader Forward方法所在的ClassLoader，如果为null，代表当前ClassLoader\n *@param jitInline 是否内联，false，禁止内联；true，允许内联\n *\n */\npublic static void doHook(String hookInfoClassName, ClassLoader hookInfoClassLoader, ClassLoader targetClassLoader, ClassLoader hookClassLoader, ClassLoader forwardClassLoader, boolean jitInline)\n```\n- **hookInfoClassName**：HookInfo类名\n- **hookInfoClassLoader**：HookInfo类所在的ClassLoader，如果为null，代表当前ClassLoader\n- **targetClassLoader**：Target方法所在的ClassLoader，如果为null，代表当前ClassLoader\n- **hookClassLoader**：Hook方法所在的ClassLoader，如果为null，代表当前ClassLoader\n- **forwardClassLoader**：Forward方法所在的ClassLoader，如果为null，代表当前ClassLoader\n- **jitInline**：是否内联，false，禁止内联；true，允许内联\n\n**调用**\n- 插件式Hook：需要提供插件的ClassLoader,建议在attachBaseContext方法里调用。\n```\n//插件式Hook，需要提供插件的ClassLoader\nFastHookManger.doHook(\"hookInfoClassName\",pluginsClassloader,null,pluginsClassloader,pluginsClassloader,false);\n```\n- 内置Hook：都位于当前ClassLoader建议在attachBaseContext方法里调用。\n```\n//内置Hook，都位于当前ClassLoader\nFastHookManger.doHook(\"hookInfoClassName\",null,null,null,null,false);\n```\n- 其他形式 Hook：需要体供插件的ClassLoader和apk的ClassLoader，建议在handleBindApplication方法里合适的地方调用，一般在加载apk后，调用attachBaseContext前。\n```\n//Root Hook，需要体供插件的ClassLoader和apk的ClassLoader\nFastHookManger.doHook(\"hookInfoClassName\",pluginsClassloader,apkClassLoader,pluginsClassloader,pluginsClassloader,false);\n```\n## Callback方式\n**实现FastHookCallback接口**\n```\npublic interface FastHookCallback {\n    void beforeHookedMethod(FastHookParam param);\n    void afterHookedMethod(FastHookParam param);\n}\n```\n- **beforeHookedMethod**：原方法调用前调用\n- **afterHookedMethod**：原方法调用后调用\n```\npublic class FastHookParam {\n    public Object receiver;\n    public Object[] args;\n    public Object result;\n    public boolean replace;\n}\n```\n- **receiver**：this对象，static方法则为null\n- **args**：方法参数\n- **result**：方法返回值\n- **replace**：是否替换方法，如果为true，则不会调用原方法，并以result返回\n\n**接口**\n```\n/**\n *\n *@param className 目标方法类名\n *@param classLoader 目标方法所在ClassLoader，如果为null，代表当前ClassLoader\n *@param methodName 目标方法方法名\n *@param methodSig 目标方法参数签名，不包括返回类型\n *@param callback hook回调方法\n *@param mode hook模式\n *@param jitInline 是否内联，false，禁止内联；true，允许内联\n *\n */\n FastHookManager.doHook(String className, ClassLoader classLoader, String methodName, String methodSig, FastHookCallback callback, int mode, boolean jitInline)\n ```\n- **className**：目标方法类名\n- **classLoader**：目标方法所在ClassLoader，如果为null，代表当前ClassLoader\n- **methodName**：目标方法方法名\n- **methodSig**：目标方法参数签名，不包括返回类型\n- **callback**：hook回调方法\n- **mode**：hook模式，FastHookManager.MODE_REWRITE和FastHookManager.MODE_REPLACE\n- **jitInline**：是否内联，false，禁止内联；true，允许内联\n\n**调用**\n```\nFastHookManager.doHook(className,classLoader, methodName, methodSig, new FastHookCallback() {\n            @Override\n            public void beforeHookedMethod(FastHookParam param) {\n                \n            }\n\n            @Override\n            public void afterHookedMethod(FastHookParam param) {\n\n            }\n        },FastHookManager.MODE_REWRITE,false);\n```\n\n# 支持Android版本\n- Android 9.0 (API 28)\n- Android 8.1 (API 27)\n- Android 8.0 (API 26)\n- Android 7.1 (API 25)\n- Android 7.0 (API 24)\n- Android 6.0 (API 23)\n- Android 5.1 (API 22)\n- Android 5.0 (API 21)\n# 支持架构\n- Thumb2\n- Arm64\n# 参考\n1. **[VirtualFastHook](https://github.com/turing-technician/VirtualFastHook)**：结合VirtualApp的免root Hook工具。\n2. **[Enhanced_dlfunctions](https://github.com/turing-technician/Enhanced_dlfunctions)**：增强版本的dl函数，支持获取所有符号，包括.dynsym段和.symtab段\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturing-technician%2Ffasthook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturing-technician%2Ffasthook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturing-technician%2Ffasthook/lists"}