YukiHookAPI/docs/api/public/MethodFinder.md

MethodFinder [class]

class MethodFinder internal constructor(override val hookInstance: YukiMemberHookCreater.MemberHookCreater?, override val classSet: Class<*>) : BaseFinder()

变更记录

v1.0 添加

v1.0.2 修改

合并到 BaseFinder

功能描述

Method 查找类。

可通过指定类型查找指定方法或一组方法。

name [field]

var name: String

变更记录

v1.0 添加

v1.0.70 修改

允许不填写名称

功能描述

设置 Method 名称。

!> 若不填写名称则必须存在一个其它条件。

paramCount [field]

var paramCount: Int

变更记录

v1.0.67 新增

功能描述

设置 Method 参数个数。

你可以不使用 param 指定参数类型而是仅使用此变量指定参数个数。

若参数个数小于零则忽略并使用 param。

returnType [field]

var returnType: Any?

变更记录

v1.0 添加

功能描述

设置 Method 返回值，可不填写返回值。

modifiers [method]

inline fun modifiers(initiate: ModifierRules.() -> Unit): IndexTypeCondition

变更记录

v1.0.67 新增

v1.0.80 修改

将方法体进行 inline

功能描述

设置 Method 标识符筛选条件。

可不设置筛选条件。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

emptyParam [method]

fun emptyParam(): IndexTypeCondition

变更记录

v1.0.75 新增

功能描述

设置 Method 空参数、无参数。

param [method]

fun param(vararg paramType: Any): IndexTypeCondition

变更记录

v1.0 添加

功能描述

设置 Method 参数。

如果同时使用了 paramCount 则 paramTypes 的数量必须与 paramCount 完全匹配。

!> 无参 Method 请使用 emptyParam 设置查询条件。

!> 有参 Method 必须使用此方法设定参数或使用 paramCount 指定个数。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

order [method]

fun order(): IndexTypeCondition

变更记录

v1.0.70 新增

功能描述

顺序筛选字节码的下标。

name [method]

fun name(value: String): IndexTypeCondition

变更记录

v1.0.70 新增

功能描述

设置 Method 名称。

!> 若不填写名称则必须存在一个其它条件。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

name [method]

inline fun name(initiate: NameConditions.() -> Unit): IndexTypeCondition

变更记录

v1.0.88 新增

功能描述

设置 Method 名称条件。

!> 若不填写名称则必须存在一个其它条件。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

paramCount [method]

fun paramCount(num: Int): IndexTypeCondition

变更记录

v1.0.70 新增

功能描述

设置 Method 参数个数。

你可以不使用 param 指定参数类型而是仅使用此方法指定参数个数。

若参数个数小于零则忽略并使用 param。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

paramCount [method]

fun paramCount(numRange: IntRange): IndexTypeCondition

变更记录

v1.0.93 新增

功能描述

设置 Method 参数个数范围。

你可以不使用 param 指定参数类型而是仅使用此方法指定参数个数范围。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

returnType [method]

fun returnType(value: Any): IndexTypeCondition

变更记录

v1.0.70 新增

功能描述

设置 Method 返回值。

可不填写返回值。

!> 存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

superClass [method]

fun superClass(isOnlySuperClass: Boolean)

变更记录

v1.0.80 新增

功能描述

设置在 classSet 的所有父类中查找当前 Method。

!> 若当前 classSet 的父类较多可能会耗时，API 会自动循环到父类继承是 Any 前的最后一个类。

RemedyPlan [class]

inner class RemedyPlan internal constructor()

变更记录

v1.0 添加

功能描述

Method 重查找实现类，可累计失败次数直到查找成功。

method [method]

inline fun method(initiate: MethodFinder.() -> Unit): Result

变更记录

v1.0 添加

v1.0.80 修改

将方法体进行 inline

功能描述

创建需要重新查找的 Method。

你可以添加多个备选 Method，直到成功为止，若最后依然失败，将停止查找并输出错误日志。

Result [class]

inner class Result internal constructor()

变更记录

v1.0.1 新增

功能描述

RemedyPlan 结果实现类。

onFind [method]

fun onFind(initiate: HashSet<Method>.() -> Unit)

变更记录

v1.0.1 新增

v1.0.93 修改

initiate 参数 Method 变为 HashSet<Method>

功能描述

当在 RemedyPlan 中找到结果时。

功能示例

你可以方便地对重查找的 Method 实现 onFind 方法。

示例如下

method {
    // Your code here.
}.onFind {
    // Your code here.
}

Result [class]

inner class Result internal constructor(internal val isNoSuch: Boolean, private val throwable: Throwable?) : BaseResult

变更记录

v1.0 添加

v1.0.93 修改

继承到接口 BaseResult

功能描述

Method 查找结果实现类。

result [method]

inline fun result(initiate: Result.() -> Unit): Result

变更记录

v1.0 添加

v1.0.80 修改

将方法体进行 inline

功能描述

创建监听结果事件方法体。

功能示例

你可以使用 lambda 形式创建 Result 类。

示例如下

method {
    // Your code here.
}.result {
    get(instance).call()
    all(instance)
    remedys {}
    onNoSuchMethod {}
}

get [method]

fun get(instance: Any?): Instance

变更记录

v1.0.2 新增

功能描述

获得 Method 实例处理类。

若有多个 Method 结果只会返回第一个。

!> 若你设置了 remedys 请使用 wait 回调结果方法。

功能示例

你可以通过获得方法所在实例来执行方法。

示例如下

method {
    // Your code here.
}.get(instance).call()

若当前为静态方法，你可以不设置实例。

示例如下

method {
    // Your code here.
}.get().call()

all [method]

fun all(instance: Any?): ArrayList<Instance>

变更记录

v1.0.93 新增

功能描述

获得 Method 实例处理类数组。

返回全部查询条件匹配的多个 Method 实例结果并在 isBindToHooker 时设置到 hookInstance。

功能示例

你可以通过此方法来获得当前条件结果中匹配的全部 Method，其方法所在实例用法与 get 相同。

示例如下

method {
    // Your code here.
}.all(instance).forEach { instance ->
    instance.call(...)
}

give [method]

fun give(): Method?

变更记录

v1.0.67 新增

功能描述

得到 Method 本身。

若有多个 Method 结果只会返回第一个。

在查询条件找不到任何结果的时候将返回 null。

giveAll [method]

fun giveAll(): HashSet<Method>

变更记录

v1.0.93 新增

功能描述

得到 Method 本身数组。

返回全部查询条件匹配的多个 Method 实例。

在查询条件找不到任何结果的时候将返回空的 HashSet。

wait [method]

fun wait(instance: Any?, initiate: Instance.() -> Unit)

变更记录

v1.0.2 新增

功能描述

获得 Method 实例处理类，配合 RemedyPlan 使用。

若有多个 Method 结果只会返回第一个。

!> 若你设置了 remedys 必须使用此方法才能获得结果。

!> 若你没有设置 remedys 此方法将不会被回调。

waitAll [method]

fun waitAll(instance: Any?, initiate: ArrayList<Instance>.() -> Unit)

变更记录

v1.0.93 新增

功能描述

获得 Method 实例处理类数组，配合 RemedyPlan 使用。

返回全部查询条件匹配的多个 Method 实例结果。

!> 若你设置了 remedys 必须使用此方法才能获得结果。

!> 若你没有设置 remedys 此方法将不会被回调。

remedys [method]

inline fun remedys(initiate: RemedyPlan.() -> Unit): Result

变更记录

v1.0 添加

v1.0.80 修改

将方法体进行 inline

功能描述

创建 Method 重查找功能。

功能示例

当你遇到一种 Method 可能存在不同形式的存在时，可以使用 RemedyPlan 重新查找它，而没有必要使用 onNoSuchMethod 捕获异常二次查找 Method。

若第一次查找失败了，你还可以在这里继续添加此方法体直到成功为止。

示例如下

method {
    // Your code here.
}.remedys {
    method {
        // Your code here.
    }
    method {
        // Your code here.
    }
}

onNoSuchMethod [method]

inline fun onNoSuchMethod(result: (Throwable) -> Unit): Result

变更记录

v1.0 添加

v1.0.80 修改

将方法体进行 inline

功能描述

监听找不到 Method 时。

只会返回第一次的错误信息，不会返回 RemedyPlan 的错误信息。

ignoredError [method]

fun ignoredError(): Result

变更记录

v1.0.3 新增

功能描述

忽略任何错误发出的警告。

若 isNotIgnoredHookingFailure 为 false 则自动忽略。

Instance [class]

inner class Instance internal constructor(private val instance: Any?, private val method: Method?)

变更记录

v1.0.2 新增

v1.0.93 修改

新增 method 参数

功能描述

Method 实例处理类。

original [method]

fun original(): Instance

变更记录

v1.0.93 新增

功能描述

标识需要调用当前 Method 未经 Hook 的原始方法。

若当前 Method 并未 Hook 则会使用原始的 Method.invoke 方法调用。

!> 你只能在 (Xposed) 宿主环境中使用此功能。

call [method]

fun call(vararg param: Any?): Any?

变更记录

v1.0.2 新增

功能描述

执行方法，不指定返回值类型。

invoke [method]

fun <T> invoke(vararg param: Any?): T?

变更记录

v1.0.2 新增

功能描述

执行方法，指定 T 返回值类型。

byte [method]

fun byte(vararg param: Any?): Byte?

变更记录

v1.0.68 新增

功能描述

执行方法，指定 Byte 返回值类型。

int [method]

fun int(vararg param: Any?): Int

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callInt 为 int

功能描述

执行方法，指定 Int 返回值类型。

long [method]

fun long(vararg param: Any?): Long

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callLong 为 long

功能描述

执行方法，指定 Long 返回值类型。

short [method]

fun short(vararg param: Any?): Short

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callShort 为 short

功能描述

执行方法，指定 Short 返回值类型。

double [method]

fun double(vararg param: Any?): Double

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callDouble 为 double

功能描述

执行方法，指定 Double 返回值类型。

float [method]

fun float(vararg param: Any?): Float

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callFloat 为 float

功能描述

执行方法，指定 Float 返回值类型。

string [method]

fun string(vararg param: Any?): String

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callString 为 string

功能描述

执行方法，指定 String 返回值类型。

char [method]

fun char(vararg param: Any?): Char

变更记录

v1.0.68 新增

功能描述

执行方法，指定 Char 返回值类型。

boolean [method]

fun boolean(vararg param: Any?): Boolean

变更记录

v1.0.65 新增

v1.0.68 修改

修改 callBoolean 为 boolean

功能描述

执行方法，指定 Boolean 返回值类型。

array [method]

inline fun <reified T> array(vararg param: Any?): Array<T>

变更记录

v1.0.68 新增

功能描述

执行方法，指定 Array 返回值类型。

list [method]

inline fun <reified T> list(vararg param: Any?): List<T>

变更记录

v1.0.68 新增

功能描述

执行方法，指定 List 返回值类型。