33 KiB
API 异常处理
异常是在开发过程经常遇到的主要问题，这里介绍了
YukiHookAPI在使用过程中可能遇到的常见异常以及处理方式。
这里的异常说明只会同步最新的 API 版本，较旧的 API 版本的异常将不会再进行说明，请始终保持 API 版本为最新。
非阻断异常
这些异常不会导致 APP 停止运行(FC)，但是会在控制台打印
E级别的日志，也可能会停止继续执行相关功能。
!> loggerE Could not found XposedBridge in current space! Aborted
异常原因
你的 Hook Framework 未在工作或并未成功装载 XposedBridge。
解决方案
请确认你在正确的地方装载了 YukiHookAPI 的 encase 方法，详情请参考 作为 Xposed 模块使用的相关配置 以及 作为 Hook API 使用的相关配置。
!> loggerE You cannot load a hooker in "onInit" or "onXposedEvent" method! Aborted
异常原因
你尝试在继承 IYukiHookXposedInit 的 Hook 入口类的 onInit 或 onXposedEvent 方法中装载了 encase 方法。
示例如下
class HookEntry : IYukiHookXposedInit {
override fun onInit() {
// ❗错误的使用方法
YukiHookAPI.encase {
// Your code here.
}
}
override fun onXposedEvent() {
// ❗错误的使用方法
YukiHookAPI.encase {
// Your code here.
}
}
override fun onHook() {
// Your code here.
}
}
解决方案
请在 onHook 方法中装载 encase 方法。
示例如下
class HookEntry : IYukiHookXposedInit {
override fun onInit() {
// 这里只能装载 configs 方法
YukiHookAPI.configs {
// Your code here.
}
}
override fun onHook() {
// ✅ 正确的使用方法
YukiHookAPI.encase {
// Your code here.
}
}
}
!> loggerE Hooking Process exception occurred
异常原因
YukiHookAPI 在进行自身初始化 Hook 过程中发生异常。
解决方案
通常情况下这种错误不会轻易发生，若一旦发生此错误，可直接提交日志进行反馈。
!> loggerE YukiHookAPI try to load HookEntryClass failed
异常原因
YukiHookAPI 在尝试装载 Hook 入口类 onInit 或 onHook 方法时发生了不能处理的异常或找不到入口类。
解决方案
通常情况下这种错误不会轻易发生，若一旦发生此错误，请自行查看控制台打印的日志定位问题，确定并非自己的代码发生的问题后，可提交日志进行反馈。
!> loggerE YukiHookAPI bind initZygote failed
异常原因
YukiHookAPI 在尝试装载 Xposed 原生接口 initZygote 方法时发生了不能处理的异常。
解决方案
通常情况下这种错误不会轻易发生，若一旦发生此错误，请自行查看控制台打印的日志定位问题，确定并非自己的代码发生的问题后，可提交日志进行反馈。
!> loggerE Failed to execute method "NAME", maybe your Hook Framework not support Resources Hook
异常原因
YukiHookAPI 在尝试进行 Resources Hook 时发生错误。
解决方案
通常这种情况不会发生，请仔细检查错误日志的详细信息，若发生 ClassNotFound 等情况可能是 Hook Framework 不支持 Resources Hook(资源钩子)。
!> loggerE HookClass [NAME] not found
异常原因
当前被 Hook 的 Class 没有被找到。
解决方案
请检查目标 Class 是否存在，若想忽略此错误请使用 ignoredHookClassNotFoundFailure 方法。
!> loggerE Hook Member [NAME] failed
异常原因
Hook 目标方法、构造方法时发生错误。
解决方案
此问题通常由 Hook Framework 产生，请检查对应的日志内容，若问题持续出现请携带详细日志进行反馈。
!> loggerE Hooked Member with a finding error by CLASS
异常原因
在 Hook 执行后被 Hook 的 member 为 null 且已经设置目标 Hook 方法、构造类。
解决方案
请检查此错误发生前的上一个错误日志，或许在查找方法、构造方法的时候发生了找不到方法、构造方法的错误。
!> loggerE Hooked Member cannot be non-null by CLASS
异常原因
在 Hook 执行后被 Hook 的 member 为 null 且没有设置目标 Hook 方法、构造类。
示例如下
injectMember {
// 这里并没有设置需要 Hook 的方法、构造方法的查询条件
afterHook {
// ...
}
}
解决方案
请确认你已经在 Hook 之前正确设置了要 Hook 的方法、构造方法的查询方式。
示例如下
injectMember {
// ✅ 正确的使用方法举例
method {
// Your code here.
}
afterHook {
// ...
}
}
!> loggerE Hooked method return type match failed, required [TYPE] but got [TYPE]
异常原因
在 Hook 回调方法体中设置了 HookParam.result 或使用了 replaceHook 但是被 Hook 的方法返回值类型与原返回值类型不匹配。
示例如下
假设这个是被 Hook 的方法。
private boolean test()
下面是一个错误的案列。
injectMember {
method {
name = "test"
emptyParam()
}
// <情景1> 设置了错误的类型，原类型为 Boolean
beforeHook {
result = 0
}
// <情景2> 返回了错误的类型，原类型为 Boolean
replaceAny {
0
}
// <情景3> 直接使用了错误的类型，原类型为 Boolean
replaceTo(any = 0)
}
!> 若上述场景在 beforeHook 或 afterHook 中发生，则会造成被 Hook 的 APP (宿主) 由 XposedBridge 抛出异常。
解决方案
请确认当前被 Hook 方法的正确返回值类型，修改后再试一次。
!> loggerE Hook initialization failed because got an Exception
异常原因
在准备 Hook 时发生了任意的异常。
解决方案
这是一个准备 Hook 阶段就发生异常的提醒，请仔细查看具体的异常是什么以重新确定问题。
!> loggerE Try to hook NAME[NAME] got an Exception
异常原因
在 Hook 开始时发生了任意的异常。
解决方案
这是一个 Hook 开始就发生异常的提醒，请仔细查看具体的异常是什么以重新确定问题。
!> loggerE Method/Constructor/Field match type "TYPE" not allowed
异常原因
在查找方法、构造方法以及变量时设置了不允许的参数类型。
示例如下
// 查询一个方法
method {
// ❗设置了无效的类型举例
param(false, 1, 0)
// ❗设置了无效的类型举例
returnType = false
}
// 查询一个变量
field {
// ❗设置了无效的类型举例
type = false
}
解决方案
在查询中 param、returnType、type 中仅接受 Class、String、VariousClass 类型的传值，不可传入参数实例。
示例如下
// 查询一个方法
method {
// ✅ 正确的使用方法举例
param(BooleanType, IntType, IntType)
// ✅ 正确的使用方法举例
returnType = BooleanType
// ✅ 以下方案也是正确的
returnType = "java.lang.Boolean"
}
// 查询一个变量
field {
// ✅ 正确的使用方法举例
type = BooleanType
}
!> loggerE NoSuchMethod/NoSuchConstructor/NoSuchField happend in [NAME]
异常原因
在查找方法、构造方法以及变量时并未找到目标方法、构造方法以及变量。
解决方案
请确认你的查询条件是否能正确匹配到目标 Class 中的指定方法、构造方法以及变量。
!> loggerE Trying COUNT times and all failure by RemedyPlan
异常原因
使用 RemedyPlan 重新查找方法、构造方法、变量时依然没有找到方法、构造方法、变量。
解决方案
请确认你设置的 RemedyPlan 参数以及宿主内存在的 Class，再试一次。
!> loggerE You must set a condition when finding a Method/Constructor/Field
异常原因
在查找方法、构造方法以及变量时并未设置任何条件。
示例如下
method {
// 这里没有设置任何条件
}
解决方案
请将查询条件补充完整并再试一次。
!> loggerE Can't find this Method/Constructor/Field [NAME] because classSet is null
异常原因
在查找方法、构造方法以及变量时所设置的 Class 实例为 null。
示例如下
// 假设 TargetClass 的实例为 null
TargetClass.method {
// ...
}
解决方案
这种情况比较少见，请检查你要查询的目标 Class 是否被正确赋值并检查整个 Hook 流程和使用范围。
!> loggerE Can't find this Method/Constructor/Field --> TYPE in [CLASS] by YukiHookAPI#ReflectionTool
异常原因
通过指定条件找不到需要查找的方法、构造方法以及变量。
示例如下
TargetClass.method {
name = "test"
param(BooleanType)
}
解决方案
这是一个安全异常，请检查你设置的条件，使用相关工具查看所在 Class 中的字节码对象特征，并再试一次。
!> loggerE Field match type class is not found
异常原因
在查找变量时所设置的查询条件中 type 的 Class 实例未被找到。
示例如下
field {
name = "test"
// 假设这里设置的 type 的 Class 并不存在
type = "com.example.TestClass"
}
解决方案
请检查查询条件中 type 的 Class 是否存在，然后再试一次。
!> loggerE Method match returnType class is not found
异常原因
在查找方法时所设置的查询条件中 returnType 的 Class 实例未被找到。
示例如下
method {
name = "test"
// 假设这里设置的 returnType 的 Class 并不存在
returnType = "com.example.TestClass"
}
解决方案
请检查查询条件中 returnType 的 Class 是否存在，然后再试一次。
!> loggerE Method/Constructor match paramType[INDEX] class is not found
异常原因
在查找方法、构造方法时所设置的查询条件中 param 的 index 号下标的 Class 实例未被找到。
method {
name = "test"
// 假设这里设置的 1 号下标的 Class 并不存在
param(StringType, "com.example.TestClass", BooleanType)
}
解决方案
请检查查询条件中 param 的 index 号下标的 Class 是否存在，然后再试一次。
!> loggerE Resources Hook condition name/type cannot be empty [TAG]
异常原因
在查找 Resources 时并未设置任何条件。
示例如下
// 情况 1
conditions {
// 这里没有设置任何条件
}
// 情况 2
conditions {
name = "test"
// 这里缺少了 type 条件
}
解决方案
Resources 的 Hook 并非类似方法的 Hook，其必须拥有完整的名称和类型描述才能查询成功，请将查询条件补充完整并再试一次。
!> loggerE Resources Hook type is invalid [TAG]
异常原因
在 Hook Resources 时发生了类型错误的异常。
解决方案
YukiHookAPI 会尝试在 initZygote 与 handleInitPackageResources 中装载 Resources Hook，若全部装载失败可能会发生此异常，当前 Hook Framework 需要支持并启用资源钩子(Resources Hook)功能，请检查后再试一次。
!> loggerE Resources Hook got an Exception [TAG]
异常原因
在 Hook Resources 时发生了任意的异常。
解决方案
这是一个异常汇总，请自行向下查看日志具体的异常是什么，例如找不到 Resources Id 的问题。
!> loggerE Received action "ACTION" failed
异常原因
使用 YukiHookDataChannel 时回调广播事件异常。
解决方案
一般情况下，此错误基本上不会发生，一旦发生错误，排除自身代码的问题后，请携带详细日志进行反馈。
!> loggerE Failed to sendBroadcast like "KEY", because got null context in "PACKAGENAME"
异常原因
使用 YukiHookDataChannel 时发送广播取到了空的上下文实例。
解决方案
一般情况下，此错误基本上不会发生，在最新版本中已经修复宿主使用时可能发生的问题，若最新版本依然发生错误，排除自身代码的问题后，请携带详细日志进行反馈。
!> loggerE Failed to inject module resources into [RESOURCES]
异常原因
在 (Xposed) 宿主环境中使用 injectModuleAppResources 注入模块资源时发生异常。
解决方案
一般情况下，此错误基本上不会发生，排除自身代码的问题后，请携带详细日志进行反馈。
!> loggerE Activity Proxy initialization failed because got an Exception
异常原因
在 (Xposed) 宿主环境中使用 registerModuleAppActivities 注入模块 Activity 时发生异常。
解决方案
请检查此错误发生后的下一个错误日志，或许在配置参数上可能发生了一些问题，若找不到相关错误日志的说明，排除自身代码的问题后，请携带详细日志进行反馈。
!> loggerE Activity Proxy got an Exception in msg.what [WHAT]
异常原因
在 (Xposed) 宿主环境中使用 registerModuleAppActivities 注入模块 Activity 时发生异常。
解决方案
一般情况下，此错误基本上不会发生，但根据系统版本差异性并未做详细测试，排除自身代码的问题后，请携带详细日志进行反馈。
!> loggerE This proxy [TYPE] type is not allowed
异常原因
在 (Xposed) 宿主环境中使用 registerModuleAppActivities 注入模块 Activity 时填入了无效的参数。
示例如下
// ❗ 这里填入的内容仅为举例，其中 proxy 填入了不能理解的无效参数
registerModuleAppActivities(proxy = false)
解决方案
方法中的 proxy 参数只接受 String、CharSequence、Class 类型，请查看相关使用方法正确填入方法参数。
!> loggerE Cound not got launch intent for package "NAME"
异常原因
在 (Xposed) 宿主环境中使用 registerModuleAppActivities 注入模块 Activity 时找不到宿主的启动 Activity。
示例如下
// 使用了默认参数直接进行注册
registerModuleAppActivities()
解决方案
默认参数 (无参) 只能用于可被启动的 APP，若 APP 并未声明启动入口 Activity，你就需要手动指定方法的 proxy 参数。
!> loggerE Could not found "NAME" or Class is not a type of Activity
异常原因
在 (Xposed) 宿主环境中使用 registerModuleAppActivities 注入模块 Activity 时无法找到被填入参数 proxy 的 Activity。
示例如下
registerModuleAppActivities(proxy = "com.demo.test.TestActivity")
解决方案
请确认你填入的 Activity 名称真实有效地存在于宿主中，且目标 Class 继承于 Activity。
阻断异常
这些异常会直接导致 APP 停止运行(FC)，同时会在控制台打印
E级别的日志，还会造成 Hook 进程“死掉”。
!> RuntimeException !!!DO NOT ALLOWED!!! You cannot hook or reflection to call the internal class of the YukiHookAPI itself, The called class is [CLASS]
异常原因
你使用 YukiHookAPI 的相关反射或 Hook 功能调用了 API 自身的 Class 对象。
示例如下
// <情景1>
YukiHookAPI.current()
// <情景2>
PackageParam::class.java.hook {
// ...
}
// <情景3>
MethodFinder::class.java.method {
name = "name"
param(StringType)
}.get().call("name")
// ...
解决方案
请检查代码部分是否有错误，例如下面的情况。
示例如下
YourClass.method {
// ...
// ❗ 没有调用方法执行，这里实际调用的是 MethodFinder.Result 对象
}.get(instance).current()
YourClass.method {
// ...
// ✅ 正确的使用方法，假设此方法无参
}.get(instance).call().current()
不允许内联、反射、Hook YukiHookAPI 自身的 Class 以及内部功能，防止发生错误。
!> UnsupportedOperationException !!!DANGEROUS!!! Hook [CLASS] Class is a dangerous behavior! [CONTENT] [SOLVE]
异常原因
你尝试 Hook 了处于危险行为列表中的 Class 对象，例如 Class、ClassLoader、Method。
示例如下
// <情景1>
JavaClassLoader.hook {
// ...
}
// <情景2>
JavaClass.hook {
// ...
}
// <情景3>
JavaMethod.hook {
// ...
}
// ...
解决方案
这些功能是系统内部的，它们不应该被 Hook，在部分 Hook Framework 上可能不被支持，还会引发其它错误，请尝试更换 Hook 点。
若你仍要使用此功能，请参考 useDangerousOperation。
示例如下
JavaClassLoader.hook {
useDangerousOperation(option = "Yes do as I say!")
injectMember {
method {
// ...
}
afterHook {
// ...
}
}
}
这只是一个用于调试的功能，强烈建议不要这样做，发生问题请不要反馈，自行承担一切后果。
!> NoClassDefFoundError Can't find this Class --> name:[NAME] in [CLASSLOADER] by YukiHookAPI#ReflectionTool
异常原因
通过 String.toClass(...) 或 classOf<...>() 找不到需要查找的 Class 对象。
示例如下
"com.demo.Test".toClass()
解决方案
请检查当前字符串或实体匹配到的 Class 是否存在于当前 ClassLoader，并再试一次。
!> IllegalStateException Failed to got SystemContext
异常原因
在被 Hook 的宿主内调用了 systemContext 但并未成功获取到实例对象。
示例如下
encase {
// 调用了此变量
systemContext...
}
解决方案
这种情况不应该存在，由于 systemContext 通过反射从 ActivityThread 中得到，除非系统进程发生异常，否则获取到的对象不会为空。
!> IllegalStateException App is dead, You cannot call to appContext
异常原因
第一种情况
在被 Hook 的宿主内调用了 ModuleApplication 的 appContext。
示例如下
encase {
// 调用了此变量
ModuleApplication.appContext...
}
第二种情况
使用 ModuleApplication 时调用了 appContext 但是 APP 可能已经被销毁或没有正确启动。
示例如下
// 调用了此变量但是 APP 可能已被销毁或没有正确启动
ModuleApplication.appContext...
解决方案
第一种情况
你只能在模块内使用 ModuleApplication 的 appContext，在宿主内请使用 PackageParam 中的 appContext，请确认你使用的是否正确。
第二种情况
这种情况基本不存在，由于 appContext 是在 onCreate 中被赋值的，除非遇到多进程并发启动或 APP 没有启动完成前被反射调用了父类的 onCreate 方法。
!> IllegalStateException YukiHookModulePrefs not allowed in Custom Hook API
异常原因
在 Hook 自身 APP(非 Xposed 模块) 中使用了 YukiHookModulePrefs。
示例如下
class MyApplication : Application() {
override fun attachBaseContext(base: Context?) {
YukiHookAPI.encase(base) {
// ❗不能在这种情况下使用 prefs
prefs.getBoolean("test_data")
}
super.attachBaseContext(base)
}
}
解决方案
你只能在 作为 Xposed 模块使用 时使用 YukiHookModulePrefs，在 Hook 自身 APP 中请使用原生的 Sp 存储。
!> IllegalStateException Cannot load the XSharedPreferences, maybe is your Hook Framework not support it
异常原因
在 (Xposed) 宿主环境使用了 YukiHookModulePrefs 但是无法得到 XSharedPreferences 对象。
示例如下
encase {
prefs... // 调用了此变量
}
解决方案
一般情况下不会发生此问题，若持续无法获取 XSharedPreferences 对象则可能是你使用的 Hook Framework 不支持此功能或自身存在错误。
!> IllegalStateException YukiHookDataChannel not allowed in Custom Hook API
异常原因
在 Hook 自身 APP(非 Xposed 模块) 中使用了 YukiHookDataChannel。
示例如下
class MyApplication : Application() {
override fun attachBaseContext(base: Context?) {
YukiHookAPI.encase(base) {
// ❗不能在这种情况下使用 dataChannel
dataChannel.wait(key = "test_data") {
// ...
}
}
super.attachBaseContext(base)
}
}
解决方案
你只能在 作为 Xposed 模块使用 时使用 YukiHookDataChannel。
!> IllegalStateException YukiHookDataChannel only support used on an Activity, but this current context is "CLASSNAME"
异常原因
在模块的非 Activity 环境中使用了 YukiHookDataChannel。
解决方案
你只能在 Activity 或 Fragment 中使用 YukiHookDataChannel。
!> IllegalStateException Xposed modulePackageName load failed, please reset and rebuild it
异常原因
在 Hook 过程中使用 YukiHookModulePrefs 或 YukiHookDataChannel 时无法读取装载时的 modulePackageName 导致不能确定自身模块的包名。
解决方案
请仔细阅读 这里 的帮助文档，正确配置模块的 Hook 入口类包名。
!> IllegalStateException YukiHookModulePrefs missing Context instance
异常原因
在模块中使用了 YukiHookModulePrefs 存储数据但并未传入 Context 实例。
示例如下
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// ❗错误的使用方法
// 构造方法已在 API 1.0.88 及以后的版本中设置为 private
YukiHookModulePrefs().getBoolean("test_data")
}
}
解决方案
在 Activity 中推荐使用 modulePrefs 方法来装载 YukiHookModulePrefs。
示例如下
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// ✅ 正确的使用方法
modulePrefs.getBoolean("test_data")
}
}
!> IllegalStateException Key-Value type TYPE is not allowed
异常原因
在使用 YukiHookModulePrefs 的 get 或 put 方法或 YukiHookDataChannel 的 wait 或 put 方法时传入了不支持的存储类型。
解决方案
YukiHookModulePrefs 支持的类型只有 String、Set<String>、Int、Float、Long、Boolean，请传入支持的类型。
YukiHookDataChannel 支持的类型为 Intent.putExtra 限制的类型，请传入支持的类型。
!> IllegalStateException YukiHookDataChannel cannot used in zygote
异常原因
在 loadZygote 中使用了 YukiHookDataChannel。
示例如下
loadZygote {
// 调用了此变量
dataChannel...
}
解决方案
YukiHookDataChannel 只能在 loadSystem、loadApp 中使用。
!> IllegalStateException Custom Hooking Members is empty
异常原因
在 MemberHookCreator 中调用 members() 但是未设置需要 Hook 的 Member 实例。
示例如下
injectMember {
// 括号里的方法参数被留空了
members()
afterHook {
// ...
}
}
解决方案
若要使用 members() 设置自定义 Hook 方法，你必须保证其方法参数里的 Member 数组对象不能为空。
!> IllegalStateException HookParam Method args index must be >= 0
异常原因
在 HookParam 中调用 args().last() 但是目标 param 为空或 args 中的 index 设置了小于 0 的数值。
示例如下
injectMember {
// ...
afterHook {
// 假设 param 是空的
args().last()...
// 设置了小于 0 的 index
args(index = -5)...
}
}
解决方案
请确认你 Hook 的目标方法、构造方法的方法参数数量是否不为空，且不能对 args 的下标设置小于 0 的数值。
!> IllegalStateException HookParam instance got null! Is this a static member?
异常原因
在 HookParam 中调用 instance 变量或 instance 方法但获取不到当前实例的对象。
示例如下
injectMember {
// ...
afterHook {
// 调用了此变量
instance...
// 调用了此方法
instance<Any>()...
}
}
解决方案
请确认你 Hook 的方法是否为静态类型，静态类型的方法没有实例，不能使用此功能，若非静态方法，请检查实例是否已经销毁。
!> IllegalStateException Current hooked Member args is null
异常原因
在 HookParam 中调用 args 变量但获取不到当前实例方法、构造方法的参数数组。
示例如下
injectMember {
// ...
afterHook {
// 调用了此变量
args...
}
}
解决方案
这种问题一般不会发生，真的发生了此问题，请携带详细日志进行反馈。
!> IllegalStateException Current hooked Member is null
异常原因
在 HookParam 中调用 member 变量但获取不到当前实例的方法、构造方法实例。
示例如下
injectMember {
// ...
afterHook {
// 调用了此变量
member...
}
}
解决方案
这种问题一般不会发生，真的发生了此问题，请携带详细日志进行反馈。
!> IllegalStateException Current hooked Member is not a Method
异常原因
在 HookParam 中调用 method 变量但获取不到当前实例的方法实例。
示例如下
injectMember {
// ...
afterHook {
// 调用了此变量
method...
}
}
解决方案
请确认你 Hook 的方法是构造方法还是普通方法并使用对应类型的方法获取指定的实例，若不知道字节码的类型可以直接使用 member 来获取。
!> IllegalStateException Current hooked Member is not a Constructor
异常原因
在 HookParam 中调用 constructor 变量但获取不到当前实例的方法实例。
示例如下
injectMember {
// ...
afterHook {
// 调用了此变量
constructor...
}
}
解决方案
请确认你 Hook 的方法是普通方法还是构造方法并使用对应类型的方法获取指定的实例，若不知道字节码的类型可以直接使用 member 来获取。
!> IllegalStateException HookParam instance cannot cast to TYPE
异常原因
在 HookParam 中调用 instance 方法指定了错误的类型。
示例如下
injectMember {
// ...
afterHook {
// 类型被 cast 为 Activity 但假设当前实例的类型并非此类型
instance<Activity>()...
}
}
解决方案
请确认当前 Hook 实例的正确类型并重新填写泛型中的类型，若不能确定请使用 Any 或直接使用 instance 变量。
!> IllegalStateException HookParam Method args is empty, mabe not has args
异常原因
在 HookParam 中调用 ArgsModifyer.set 方法但是当前实例的方法参数数组为空。
示例如下
injectMember {
// ...
afterHook {
// 调用了此方法
args(...).set(...)
}
}
解决方案
请确认你 Hook 的目标方法、构造方法的方法参数数量是否不为空，否则你无法使用此功能。
!> IllegalStateException HookParam Method args index out of bounds, max is NUMBER
异常原因
在 HookParam 中调用 ArgsModifyer.set 方法指定了超出方法参数下标的数组序号。
示例如下
injectMember {
// ...
afterHook {
// 下标从 0 开始，假设原始的参数下标是 5 个，但是这里填写了 6
args(index = 6).set(...)
}
}
解决方案
请确认你 Hook 的目标方法、构造方法的方法参数个数，并重新设置数组下标。
!> IllegalStateException PackageParam got null ClassLoader
异常原因
在 PackageParam 中调用了 appClassLoader 变量但是无法获取到实例对象。
示例如下
encase {
// 调用了此变量
appClassLoader...
}
解决方案
这种情况几乎不存在，除非模块被装载的宿主或目标 Xposed 框架自身存在问题，若真的发生了此问题，请携带详细日志进行反馈。
!> IllegalStateException PackageParam got null appContext
异常原因
在 PackageParam 中调用了 appContext 变量但是无法获取到实例对象。
示例如下
encase {
// 调用了此变量
appContext...
}
解决方案
appContext 在宿主环境初始化完成之前有大的概率可能是空的，请延迟获取或在宿主的 Hook 方法回调方法体内再使用此变量。
!> IllegalStateException Current Hook Framework not support moduleAppResources
异常原因
在 PackageParam 中调用了 moduleAppResources 变量但是无法获取到实例对象。
示例如下
encase {
// 调用了此变量
moduleAppResources...
}
解决方案
moduleAppResources 需要当前 Hook Framework 支持 initZygote 功能，请检查后再试一次。
!> IllegalStateException You cannot call to appResources in this time
在 PackageParam 中调用了 appResources 变量但是无法获取到实例对象。
示例如下
encase {
// 调用了此变量
appResources...
}
解决方案
appResources 不会在 initZygote 中装载，另外，这个功能需要当前 Hook Framework 支持并启用资源钩子(Resources Hook)功能，请检查后再试一次。
!> IllegalStateException VariousClass match failed of those CLASSES
异常原因
在使用 VariousClass 创建不确定的 Class 对象时全部的 Class 都没有被找到。
解决方案
检查当前 Hook 的宿主内是否存在其中能够匹配的 Class 后，再试一次。
!> IllegalStateException Cannot get hook class "NAME" cause THROWABLE
异常原因
在 hook 方法体非 onPrepareHook 方法内调用了 instanceClass 变量且当前 Hook 的 Class 不存在。
示例如下
TargetClass.hook {
// 可能的情况为在非 onPrepareHook 方法体内调用了 instanceClass 变量用于打印日志
loggerD(msg = "$instanceClass hook start")
}
解决方案
在 hook 内直接使用 instanceClass 是很危险的，若 Class 不存在则会直接导致 Hook 进程“死掉”。
详情请参考 状态监听。
!> IllegalStateException LayoutInflatedParam View instance got null
异常原因
在布局 Hook 回调中调用了 currentView 但没取到实例对象。
示例如下
injectResource {
conditions {
name = "activity_main"
layout()
}
injectAsLayout {
// 调用了此变量
currentView...
}
}
解决方案
这种情况基本上不存在，除非被 Hook 的宿主当前 Activity 已经销毁或 Hook Framework 自身存在问题。
!> IllegalStateException XResForwarder is invalid
异常原因
在 YukiResForwarder 中调用了 resources 但没取到实例对象。
示例如下
// 调用了此变量
moduleAppResources.fwd(...).resources
解决方案
这种情况基本上不存在，除非 Hook Framework 自身存在问题。
!> IllegalStateException paramTypes is empty, please use emptyParam() instead
异常原因
在查找方法、构造方法时保留了空的 param 方法。
示例如下
method {
name = "test"
// 括号内没有填写任何参数
param()
}
解决方案
若要标识此方法、构造方法没有参数，你可以有如下设置方法。
第一种，设置 emptyParam (推荐)
示例如下
method {
name = "test"
emptyParam()
}
第二种，设置 paramCount = 0
示例如下
method {
name = "test"
paramCount = 0
}
!> IllegalStateException Invalid YukiHookCallback type
异常原因
YukiHookAPI 的核心 Hook 功能发生故障。
解决方案
这种情况基本上不存在，若发生上述问题，确定并非自己的代码发生的问题后，可提交日志进行反馈。
!> IllegalStateException ModuleContextThemeWrapper already loaded
异常原因
在 Context 中使用 applyTheme 方法时重复进行调用。
示例如下
// 假设这就是当前的 Context 对象
context.applyTheme(R.style.Theme_AppCompat).applyTheme(R.style.Theme_AppCompat)
解决方案
在 Context 中只能创建一次 ModuleContextThemeWrapper，请检查代码是否有循环调用问题。