---
pageClass: code-page
---

# MethodFinder <span class="symbol">- class</span>

```kotlin:no-line-numbers
class MethodFinder internal constructor(override val classSet: Class<*>) : MemberBaseFinder
```

**变更记录**

`v1.0` `添加`

`v1.0.2` `修改`

合并到 `BaseFinder`

`v1.1.0` `修改`

合并到 `MemberBaseFinder`

`v1.1.8` `修改`

移动 `hookInstance` 参数到 `MemberBaseFinder.MemberHookerManager`

**功能描述**

> `Method` 查找类。

可通过指定类型查找指定 `Method` 或一组 `Method`。

## name <span class="symbol">- field</span>

```kotlin:no-line-numbers
var name: String
```

**变更记录**

`v1.0` `添加`

`v1.0.70` `修改`

允许不填写名称

**功能描述**

> 设置 `Method` 名称。

::: danger

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

:::

## paramCount <span class="symbol">- field</span>

```kotlin:no-line-numbers
var paramCount: Int
```

**变更记录**

`v1.0.67` `新增`

**功能描述**

> 设置 `Method` 参数个数。

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

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

## returnType <span class="symbol">- field</span>

```kotlin:no-line-numbers
var returnType: Any?
```

**变更记录**

`v1.0` `添加`

**功能描述**

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

## modifiers <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun modifiers(conditions: ModifierConditions): IndexTypeCondition
```

**变更记录**

`v1.0.67` `新增`

`v1.0.80` `修改`

将方法体进行 inline

`v1.1.0` `修改`

合并到 `ModifierConditions`

**功能描述**

> 设置 `Method` 标识符筛选条件。

可不设置筛选条件。

::: danger

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

:::

## emptyParam <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun emptyParam(): IndexTypeCondition
```

**变更记录**

`v1.0.75` `新增`

**功能描述**

> 设置 `Method` 空参数、无参数。

## param <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun param(vararg paramType: Any): IndexTypeCondition
```

**变更记录**

`v1.0` `添加`

**功能描述**

> 设置 `Method` 参数。

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

如果 `Method` 中存在一些无意义又很长的类型，你可以使用 [VagueType](../../../type/defined/DefinedTypeFactory#vaguetype-field) 来替代它。

::: danger

无参 **Method** 请使用 **emptyParam** 设置查找条件。

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

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

:::

## param <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun param(conditions: ObjectsConditions): IndexTypeCondition
```

**变更记录**

`v1.1.5` `新增`

**功能描述**

> 设置 `Method` 参数条件。

::: danger

无参 **Method** 请使用 **emptyParam** 设置查找条件。

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

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

:::

## order <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun order(): IndexTypeCondition
```

**变更记录**

`v1.0.70` `新增`

**功能描述**

> 顺序筛选字节码的下标。

## name <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun name(value: String): IndexTypeCondition
```

**变更记录**

`v1.0.70` `新增`

**功能描述**

> 设置 `Method` 名称。

::: danger

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

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

:::

## name <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun name(conditions: NameConditions): IndexTypeCondition
```

**变更记录**

`v1.0.88` `新增`

`v1.1.0` `修改`

合并到 `NameConditions`

**功能描述**

> 设置 `Method` 名称条件。

::: danger

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

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

:::

## paramCount <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun paramCount(num: Int): IndexTypeCondition
```

**变更记录**

`v1.0.70` `新增`

**功能描述**

> 设置 `Method` 参数个数。

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

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

::: danger

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

:::

## paramCount <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun paramCount(numRange: IntRange): IndexTypeCondition
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> 设置 `Method` 参数个数范围。

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

::: danger

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

:::

## paramCount <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun paramCount(conditions: CountConditions): IndexTypeCondition
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> 设置 `Method` 参数个数条件。

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

::: danger

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

:::

## returnType <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun returnType(value: Any): IndexTypeCondition
```

**变更记录**

`v1.0.70` `新增`

**功能描述**

> 设置 `Method` 返回值。

可不填写返回值。

::: danger

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

:::

## returnType <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun returnType(conditions: ObjectConditions): IndexTypeCondition
```

**变更记录**

`v1.1.5` `新增`

**功能描述**

> 设置 `Method` 返回值条件。

可不填写返回值。

::: danger

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

:::

## superClass <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun superClass(isOnlySuperClass: Boolean)
```

**变更记录**

`v1.0.80` `新增`

**功能描述**

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

::: warning

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

:::

## RemedyPlan <span class="symbol">- class</span>

```kotlin:no-line-numbers
inner class RemedyPlan internal constructor()
```

**变更记录**

`v1.0` `添加`

**功能描述**

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

### method <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun method(initiate: MethodConditions): Result
```

**变更记录**

`v1.0` `添加`

`v1.0.80` `修改`

将方法体进行 inline

**功能描述**

> 创建需要重新查找的 `Method`。

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

### Result <span class="symbol">- class</span>

```kotlin:no-line-numbers
inner class Result internal constructor()
```

**变更记录**

`v1.0.1` `新增`

**功能描述**

> `RemedyPlan` 结果实现类。

#### onFind <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun onFind(initiate: MutableList<Method>.() -> Unit)
```

**变更记录**

`v1.0.1` `新增`

`v1.1.0` `修改`

`initiate` 参数 `Method` 变为 `HashSet<Method>`

`v1.2.0` `修改`

`initiate` 类型由 `HashSet` 修改为 `MutableList`

**功能描述**

> 当在 `RemedyPlan` 中找到结果时。

**功能示例**

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

> 示例如下

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

## Process <span class="symbol">- class</span>

```kotlin:no-line-numbers
inner class Process internal constructor(internal val isNoSuch: Boolean, internal val throwable: Throwable?) : BaseResult
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> `Method` 查找结果处理类，为 `hookManager` 提供。

### result <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun result(initiate: Process.() -> Unit): Process
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

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

**功能示例**

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

> 示例如下

```kotlin
method {
    // Your code here.
}.result {
    all()
    remedys {}
    onNoSuchMethod {}
}
```

### all <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun all(): Process
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> 设置全部查找条件匹配的多个 `Method` 实例结果到 `hookManager`。

### remedys <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun remedys(initiate: RemedyPlan.() -> Unit): Result
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> 创建 `Method` 重查找功能。

**功能示例**

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

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

> 示例如下

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

### onNoSuchMethod <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun onNoSuchMethod(result: (Throwable) -> Unit): Result
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> 监听找不到 `Method` 时。

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

## Result <span class="symbol">- class</span>

```kotlin:no-line-numbers
inner class Result internal constructor(internal val isNoSuch: Boolean, private val throwable: Throwable?) : BaseResult
```

**变更记录**

`v1.0` `添加`

`v1.1.0` `修改`

继承到接口 `BaseResult`

**功能描述**

> `Method` 查找结果实现类。

### result <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun result(initiate: Result.() -> Unit): Result
```

**变更记录**

`v1.0` `添加`

`v1.0.80` `修改`

将方法体进行 inline

**功能描述**

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

**功能示例**

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

> 示例如下

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

### get <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun get(instance: Any?): Instance
```

**变更记录**

`v1.0.2` `新增`

**功能描述**

> 获得 `Method` 实例处理类。

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

::: danger

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

:::

**功能示例**

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

> 示例如下

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

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

> 示例如下

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

### all <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun all(instance: Any?): MutableList<Instance>
```

**变更记录**

`v1.1.0` `新增`

`v1.2.0` `修改`

返回值类型由 `ArrayList` 修改为 `MutableList`

**功能描述**

> 获得 `Method` 实例处理类数组。

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

**功能示例**

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

> 示例如下

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

### give <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun give(): Method?
```

**变更记录**

`v1.0.67` `新增`

**功能描述**

> 得到 `Method` 本身。

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

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

### giveAll <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun giveAll(): MutableList<Method>
```

**变更记录**

`v1.1.0` `新增`

`v1.2.0` `修改`

返回值类型由 `HashSet` 修改为 `MutableList`

**功能描述**

> 得到 `Method` 本身数组。

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

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

### wait <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun wait(instance: Any?, initiate: Instance.() -> Unit)
```

**变更记录**

`v1.0.2` `新增`

**功能描述**

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

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

::: danger

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

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

:::

### waitAll <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun waitAll(instance: Any?, initiate: MutableList<Instance>.() -> Unit)
```

**变更记录**

`v1.1.0` `新增`

`v1.2.0` `修改`

`initiate` 类型由 `ArrayList` 修改为 `MutableList`

**功能描述**

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

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

::: danger

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

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

:::

### remedys <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun remedys(initiate: RemedyPlan.() -> Unit): Result
```

**变更记录**

`v1.0` `添加`

`v1.0.80` `修改`

将方法体进行 inline

**功能描述**

> 创建 `Method` 重查找功能。

**功能示例**

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

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

> 示例如下

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

### onNoSuchMethod <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun onNoSuchMethod(result: (Throwable) -> Unit): Result
```

**变更记录**

`v1.0` `添加`

`v1.0.80` `修改`

将方法体进行 inline

**功能描述**

> 监听找不到 `Method` 时。

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

### ignored <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun ignored(): Result
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

> 忽略异常并停止打印任何错误日志。

若 `MemberBaseFinder.MemberHookerManager.isNotIgnoredNoSuchMemberFailure` 为 `false` 则自动忽略。

::: warning

此时若要监听异常结果，你需要手动实现 **onNoSuchMethod** 方法。

:::

<h3 class="deprecated">ignoredError - method</h3>

**变更记录**

`v1.0.3` `新增`

`v1.1.0` `作废`

请迁移到新方法 `ignored()`

### Instance <span class="symbol">- class</span>

```kotlin:no-line-numbers
inner class Instance internal constructor(private val instance: Any?, private val method: Method?)
```

**变更记录**

`v1.0.2` `新增`

`v1.1.0` `修改`

新增 `method` 参数

**功能描述**

> `Method` 实例处理类。

#### original <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun original(): Instance
```

**变更记录**

`v1.1.0` `新增`

**功能描述**

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

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

::: danger

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

:::

#### call <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun call(vararg args: Any?): Any?
```

**变更记录**

`v1.0.2` `新增`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，不指定返回值类型。

#### invoke <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun <T> invoke(vararg args: Any?): T?
```

**变更记录**

`v1.0.2` `新增`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 `T` 返回值类型。

#### byte <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun byte(vararg args: Any?): Byte?
```

**变更记录**

`v1.0.68` `新增`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Byte 返回值类型。

#### int <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun int(vararg args: Any?): Int
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callInt`~~ 为 `int`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Int 返回值类型。

#### long <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun long(vararg args: Any?): Long
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callLong`~~ 为 `long`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Long 返回值类型。

#### short <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun short(vararg args: Any?): Short
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callShort`~~ 为 `short`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Short 返回值类型。

#### double <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun double(vararg args: Any?): Double
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callDouble`~~ 为 `double`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Double 返回值类型。

#### float <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun float(vararg args: Any?): Float
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callFloat`~~ 为 `float`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Float 返回值类型。

#### string <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun string(vararg args: Any?): String
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callString`~~ 为 `string`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 String 返回值类型。

#### char <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun char(vararg args: Any?): Char
```

**变更记录**

`v1.0.68` `新增`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Char 返回值类型。

#### boolean <span class="symbol">- method</span>

```kotlin:no-line-numbers
fun boolean(vararg args: Any?): Boolean
```

**变更记录**

`v1.0.65` `新增`

`v1.0.68` `修改`

修改 ~~`callBoolean`~~ 为 `boolean`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Boolean 返回值类型。

### array <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun <reified T> array(vararg args: Any?): Array<T>
```

**变更记录**

`v1.0.68` `新增`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 Array 返回值类型。

### list <span class="symbol">- method</span>

```kotlin:no-line-numbers
inline fun <reified T> list(vararg args: Any?): List<T>
```

**变更记录**

`v1.0.68` `新增`

`v1.1.6` `修改`

修改参数命名 `param` 为 `args`

**功能描述**

> 执行 `Method`，指定 List 返回值类型。