Xposed 模块开发
自动构建程序可以帮你快速创建一个 Xposed 模块，完全省去配置入口类和 xposed_init 文件。
轻量优雅
拥有一套强大、优雅和人性化的 Kotlin Lambda Hook API，可以帮你快速实现 Method、Constructor、Field 的查找以及 Hook。
高效调试
拥有丰富的调试日志功能，细到每个 Hook 方法的名称、所在类以及查找耗时，可进行快速调试和排错。
方便移植
原生支持 Xposed API 用法，并原生对接 Xposed API，拥有 Xposed API 的 Hook 框架都能快速对接 Yuki Hook API。
支持混淆
使用 Yuki Hook API 构建的 Xposed 模块原生支持 R8 压缩优化混淆，混淆不会破坏 Hook 入口点，R8 下无需任何其它配置。
快速上手
简单易用，不需要繁琐的配置，不需要十足的开发经验，搭建环境集成依赖即可立即开始使用。

Supports

以下是 YukiHookAPI 支持的 Hook Framework 以及 Xposed 框架。

Hook Framework	ST	Describe
LSPosed	✅	多场景下稳定使用
EdXposed	☑	部分兼容
Pine	⭕	可以使用
SandHook	⭕	可以使用
Whale	⭕	需要 xposed-hook-based-on-whale
YAHFA	❗	需要自行实现 Xposed API
FastHook	❗	需要自行实现 Xposed API
Epic	❗	需要自行对接 Dexposed
TaiChi	⭕	可以作为模块使用
Xposed	❎	未测试，不再推荐使用

Advantage

以前，我们在构建 Xposed 模块的时候，首先需要在 assets 下创建 xposed_init 文件。

然后，将自己的入口类名手动填入文件中，使用 XposedHelper 去实现我们的 Hook 逻辑。

示例如下

class MainHook : IXposedHookLoadPackage {

    override fun handleLoadPackage(lpparam: XC_LoadPackage.LoadPackageParam) {
        if (lpparam.packageName == "com.android.browser")
            XposedHelpers.findAndHookMethod(
                Activity::class.java.name,
                lpparam.classLoader,
                "onCreate",
                Bundle::class.java,
                object : XC_MethodHook() {
                    override fun beforeHookedMethod(param: MethodHookParam?) {
                        // Your code here.
                    }

                    override fun afterHookedMethod(param: MethodHookParam?) {
                        // Your code here.
                    }
                })
    }
}

自 Kotlin 作为 Android 主要开发语言以来，这套 API 用起来确实已经不是很优雅了。

有没有什么 好用、轻量、优雅 的解决办法呢？

本着这样的想法，YukiHookAPI 诞生了。

现在，我们只需要编写少量的代码，一切时间开销和花费交给自动化处理。

示例如下

@InjectYukiHookWithXposed
class MainHook : YukiHookXposedInitProxy {

    override fun onHook() = encase {
        loadApp(name = "com.android.browser") {
            ActivityClass.hook {
                injectMember {
                    method {
                        name = "onCreate"
                        param(BundleClass)
                    }
                    beforeHook {
                        // Your code here.
                    }
                    afterHook {
                        // Your code here.
                    }
                }
            }
        }
    }
}

是的，你没有看错，仅仅就需要这几行代码，就一切安排妥当。

代码量少，逻辑清晰，借助高效强大的 YukiHookAPI，你就可以实现一个非常简单的 Xposed 模块。

Get Started

你可以点击快速开始，在 Gradle 中集成 YukiHookAPI 并开始使用。
更多使用教程及 API 文档请前往 Wiki 主页进行查看。

Changelogs

1.0
首个版本提交至 Maven。
1.0.1
RemedyPlan 增加 onFind 功能；
整合并修改了部分反射 API 代码；
增加了 type 中的 java 类型；
修复忽略错误在控制台仍然输出的问题。
1.0.2
修复 Windows 下无法找到项目路径的问题；
移除部分反射 API，合并至 BaseFinder 进行整合；
增加直接使用字符串创建 Hook 的方法。
1.0.3
修复一个潜在性的异常未拦截 BUG；
增加 ignoredError 功能；
增加了 type 中的 android 类型；
增加监听 hook 后的 ClassNotFound 功能。
1.0.4
修复 LSPosed 在最新版本中启用“只有模块classloader可以使用Xposed API”选项后找不到 XposedBridge 的问题；
添加 YukiHookAPI 的常量版本名称和版本号；
新增 hasField 方法以及 isAllowPrintingLogs 配置参数；
新增 isDebug 开启的情况下 API 将自动打印欢迎信息测试模块是否生效。
1.0.5
修复旧版本 LSPosed 框架情况下欢迎信息多次打印的问题；
添加 onInit 方法来配置 YukiHookAPI；
新增 executorName 和 executorVersion 来获取当前 Hook 框架的名称和版本号；
新增 by 方法来设置 Hook 的时机和条件；
YukiHookModulePrefs 新增可控制的键值缓存，可在宿主运行时模块动态更新数据；
修复了一些可能存在的 BUG。
1.0.55
修正一处注释错误；
临时修复一个 BUG；
增加了 type 中的大量 android 类型以及少量 java 类型；
修复新版与旧版 Kotlin APIs 的兼容性问题。
1.0.6
修复 YukiHookModulePrefs 在使用一次 direct 忽略缓存后每次都忽略的 BUG；
增加新的 API，作废了 isActive 判断模块激活的传统用法；
修复非 Xposed 环境使用 API 时打印调试日志的问题；
修复查找 Field 时的日志输出问题和未拦截的异常问题；
解耦合 ReflectionUtils 中的 Xposed API；
增加 YukiHookModuleStatus 方法名称的混淆，以精简模块生成的体积；
装载模块自身 Hook 时将不再打印欢迎信息；
修复上一个版本仍然存在的某些 BUG。
1.0.65
重新发布版本修复 Maven 仓库因为缓存问题新版本不正确的情况；
增加 MethodFinder 与 FieldFinder 新的返回值调用方法；
修复可能存在的问题，并修复太极使用过程中可能存在的问题；
修复自动生成 Xposed 入口类可能发生的问题；
增加了 type 中的 android 类型以及 java 类型。
1.0.66
修复 MethodFinder 中的一个严重问题；
增加 hookParam 中的 args 调用方法；
修复其它可能存在的问题以及修复部分类的注释问题。
1.0.67
增加三个 Finder 中的 modifiers 功能，可筛选 static、native、public、abstract 等诸多描述类型；
增加方法和构造方法查找时可模糊方法参数类型为指定个数进行查找；
增加 Member 的 hasModifiers 扩展功能；
增加 MethodFinder 和 ConstructorFinder 中的 give 方法，可获得原始类型；
增加 YukiHookModulePrefs 中的 PrefsData 模板功能；
彻底对方法、构造方法及变量的查找方案进行重构；
优化代码注释，修复了可能产生的 BUG。
1.0.68
增加 Demo 中的新用例和 LSPosed 作用域；
增加 Member 查找缓存和查找缓存配置开关；
移除和修改 MethodFinder、FieldFinder 以及 HookParam 相关方法的调用；
增加更多 Finder 中的 cast 类型并支持 cast 为数组；
整体的性能和稳定性提升；
修复上一个版本可能存在的 BUG。
1.0.69
添加并改进一些方法功能的注释；
增加 Demo 中的更多示例 Hook 内容；
修复在一个 Hook 实例中，allMethods 多次使用时只有最后一个生效的问题，感谢 WankkoRee 的反馈。
1.0.7
完善中。

Features

如果你喜欢 YukiHookAPI 项目，欢迎为此项目贡献你的代码，可以是任何改进的建议以及新增的功能。

Cooperations

以下是经过合作并稳定使用 YukiHookAPI 的项目。

Repository	Developer
TSBattery	fankesyooni
MIUI 原生通知图标	fankesyooni
ColorOS 通知图标增强	fankesyooni

Donate

工作不易，无意外情况此项目将继续维护下去，提供更多可能，欢迎打赏。

License

MIT License

Copyright (C) 2019-2022 HighCapable

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

README.md Unescape Escape

Yuki Hook API

What's this

Functions