refactor: merge HashSet, ArrayList to MutableList

2025-09-04 01:35:17 +08:00 · 2023-10-01 23:00:55 +08:00
parent 2ee38ee54e
commit 00bea93085
15 changed files with 241 additions and 129 deletions
--- a/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/classes/DexClassFinder.md
+++ b/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/classes/DexClassFinder.md
@@ -625,20 +625,24 @@ fun get(): Class<*>?
 ### all <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun all(): HashSet<Class<*>>
+fun all(): MutableList<Class<*>>
 ```

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 得到 `Class` 本身数组。

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

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

 若你设置了 `async` 请使用 [waitAll](#waitall-method) 方法。

@@ -685,20 +689,24 @@ fun wait(result: (Class<*>?) -> Unit): Result
 ### waitAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun waitAll(result: (HashSet<Class<*>>) -> Unit): Result
+fun waitAll(result: (MutableList<Class<*>>) -> Unit): Result
 ```

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+`result` 类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 得到 `Class` 本身数组 (异步)。

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

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

 你需要设置 `async` 后此方法才会被回调，否则请使用 [all](#all-method) 方法。

--- a/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/members/ConstructorFinder.md
+++ b/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/members/ConstructorFinder.md
@@ -291,7 +291,7 @@ inner class Result internal constructor()
 #### onFind <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun onFind(initiate: HashSet<Constructor<*>>.() -> Unit)
+fun onFind(initiate: MutableList<Constructor<*>>.() -> Unit)
 ```

 **Change Records**
@@ -302,6 +302,10 @@ fun onFind(initiate: HashSet<Constructor<*>>.() -> Unit)

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

+`v1.2.0` `modified`
+
+`initiate` 类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 当在 `RemedyPlan` 中找到结果时。
@@ -543,13 +547,17 @@ constructor {
 ### all <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun all(): ArrayList<Instance>
+fun all(): MutableList<Instance>
 ```

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `ArrayList` 修改为 `MutableList`
+
 **Function Illustrate**

 > 获得 `Constructor` 实例处理类数组。
@@ -591,20 +599,24 @@ fun give(): Constructor<*>?
 ### giveAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun giveAll(): HashSet<Constructor<*>>
+fun giveAll(): MutableList<Constructor<*>>
 ```

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 得到 `Constructor` 本身数组。

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

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

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

@@ -633,13 +645,17 @@ fun wait(initiate: Instance.() -> Unit)
 ### waitAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun waitAll(initiate: ArrayList<Instance>.() -> Unit)
+fun waitAll(initiate: MutableList<Instance>.() -> Unit)
 ```

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+`initiate` 类型由 `ArrayList` 修改为 `MutableList`
+
 **Function Illustrate**

 > 获得 `Constructor` 实例处理类数组，配合 `RemedyPlan` 使用。
--- a/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/members/FieldFinder.md
+++ b/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/members/FieldFinder.md
@@ -44,7 +44,7 @@ class FieldFinder internal constructor(override val classSet: Class<*>?) : Membe

 `v1.0` `first`

-`v1.0.2` `removed`
+`v1.0.2` `移除`

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

@@ -289,22 +289,26 @@ inner class Result internal constructor()
 #### onFind <span class="symbol">- method</span>

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

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+`initiate` 类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

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

-**Function Example**
+**功能示例**

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

-> The following example
+> 示例如下

 ```kotlin
 field {
@@ -350,11 +354,11 @@ inline fun result(initiate: Result.() -> Unit): Result

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

-**Function Example**
+**功能示例**

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

-> The following example
+> 示例如下

 ```kotlin
 field {
@@ -387,11 +391,11 @@ fun get(instance: Any?): Instance

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

-**Function Example**
+**功能示例**

 你可以轻松地得到 `Field` 的实例以及使用它进行设置实例。

-> The following example
+> 示例如下

 ```kotlin
 field {
@@ -401,7 +405,7 @@ field {

 如果你取到的是静态 `Field`，可以不需要设置实例。

-> The following example
+> 示例如下

 ```kotlin
 field {
@@ -412,24 +416,28 @@ field {
 ### all <span class="symbol">- method</span>

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

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `ArrayList` 修改为 `MutableList`
+
 **Function Illustrate**

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

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

-**Function Example**
+**功能示例**

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

-> The following example
+> 示例如下

 ```kotlin
 field {
@@ -460,20 +468,24 @@ fun give(): Field?
 ### giveAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun giveAll(): HashSet<Field>
+fun giveAll(): MutableList<Field>
 ```

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 得到 `Field` 本身数组。

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

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

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

@@ -502,13 +514,17 @@ fun wait(instance: Any?, initiate: Instance.() -> Unit)
 ### waitAll <span class="symbol">- method</span>

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

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+`initiate` 类型由 `ArrayList` 修改为 `MutableList`
+
 **Function Illustrate**

 > 获得 `Field` 实例处理类数组，配合 `RemedyPlan` 使用。
@@ -537,13 +553,13 @@ inline fun remedys(initiate: RemedyPlan.() -> Unit): Result

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

-**Function Example**
+**功能示例**

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

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

-> The following example
+> 示例如下

 ```kotlin
 field {
@@ -630,7 +646,7 @@ inner class Instance internal constructor(private val instance: Any?, private va

 `v1.0` `first`

-`v1.1.0` `removed`
+`v1.1.0` `移除`

 请直接使用 `any` 方法得到 `Field` 自身的实例化对象

--- a/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/members/MethodFinder.md
+++ b/docs-source/src/en/api/public/com/highcapable/yukihookapi/hook/core/finder/members/MethodFinder.md
@@ -435,7 +435,7 @@ inner class Result internal constructor()
 #### onFind <span class="symbol">- method</span>

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

 **Change Records**
@@ -446,6 +446,10 @@ fun onFind(initiate: HashSet<Method>.() -> Unit)

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

+`v1.2.0` `modified`
+
+`initiate` 类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 当在 `RemedyPlan` 中找到结果时。
@@ -673,13 +677,17 @@ method {
 ### all <span class="symbol">- method</span>

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

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `ArrayList` 修改为 `MutableList`
+
 **Function Illustrate**

 > 获得 `Method` 实例处理类数组。
@@ -721,20 +729,24 @@ fun give(): Method?
 ### giveAll <span class="symbol">- method</span>

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

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **Function Illustrate**

 > 得到 `Method` 本身数组。

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

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

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

@@ -763,13 +775,17 @@ fun wait(instance: Any?, initiate: Instance.() -> Unit)
 ### waitAll <span class="symbol">- method</span>

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

 **Change Records**

 `v1.1.0` `added`

+`v1.2.0` `modified`
+
+`initiate` 类型由 `ArrayList` 修改为 `MutableList`
+
 **Function Illustrate**

 > 获得 `Method` 实例处理类数组，配合 `RemedyPlan` 使用。
--- a/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/classes/DexClassFinder.md
+++ b/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/classes/DexClassFinder.md
@@ -617,20 +617,24 @@ fun get(): Class<*>?
 ### all <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun all(): HashSet<Class<*>>
+fun all(): MutableList<Class<*>>
 ```

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 得到 `Class` 本身数组。

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

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

 若你设置了 `async` 请使用 [waitAll](#waitall-method) 方法。

@@ -677,20 +681,24 @@ fun wait(result: (Class<*>?) -> Unit): Result
 ### waitAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun waitAll(result: (HashSet<Class<*>>) -> Unit): Result
+fun waitAll(result: (MutableList<Class<*>>) -> Unit): Result
 ```

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+`result` 类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 得到 `Class` 本身数组 (异步)。

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

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

 你需要设置 `async` 后此方法才会被回调，否则请使用 [all](#all-method) 方法。

--- a/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/members/ConstructorFinder.md
+++ b/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/members/ConstructorFinder.md
@@ -283,7 +283,7 @@ inner class Result internal constructor()
 #### onFind <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun onFind(initiate: HashSet<Constructor<*>>.() -> Unit)
+fun onFind(initiate: MutableList<Constructor<*>>.() -> Unit)
 ```

 **变更记录**
@@ -294,6 +294,10 @@ fun onFind(initiate: HashSet<Constructor<*>>.() -> Unit)

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

+`v1.2.0` `修改`
+
+`initiate` 类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 当在 `RemedyPlan` 中找到结果时。
@@ -535,13 +539,17 @@ constructor {
 ### all <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun all(): ArrayList<Instance>
+fun all(): MutableList<Instance>
 ```

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `ArrayList` 修改为 `MutableList`
+
 **功能描述**

 > 获得 `Constructor` 实例处理类数组。
@@ -583,20 +591,24 @@ fun give(): Constructor<*>?
 ### giveAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun giveAll(): HashSet<Constructor<*>>
+fun giveAll(): MutableList<Constructor<*>>
 ```

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 得到 `Constructor` 本身数组。

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

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

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

@@ -625,13 +637,17 @@ fun wait(initiate: Instance.() -> Unit)
 ### waitAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun waitAll(initiate: ArrayList<Instance>.() -> Unit)
+fun waitAll(initiate: MutableList<Instance>.() -> Unit)
 ```

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+`initiate` 类型由 `ArrayList` 修改为 `MutableList`
+
 **功能描述**

 > 获得 `Constructor` 实例处理类数组，配合 `RemedyPlan` 使用。
--- a/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/members/FieldFinder.md
+++ b/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/members/FieldFinder.md
@@ -281,13 +281,17 @@ inner class Result internal constructor()
 #### onFind <span class="symbol">- method</span>

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

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+`initiate` 类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 当在 `RemedyPlan` 中找到结果时。
@@ -404,13 +408,17 @@ field {
 ### all <span class="symbol">- method</span>

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

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `ArrayList` 修改为 `MutableList`
+
 **功能描述**

 > 获得 `Field` 实例处理类数组。
@@ -452,20 +460,24 @@ fun give(): Field?
 ### giveAll <span class="symbol">- method</span>

 ```kotlin:no-line-numbers
-fun giveAll(): HashSet<Field>
+fun giveAll(): MutableList<Field>
 ```

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 得到 `Field` 本身数组。

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

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

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

@@ -494,13 +506,17 @@ fun wait(instance: Any?, initiate: Instance.() -> Unit)
 ### waitAll <span class="symbol">- method</span>

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

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+`initiate` 类型由 `ArrayList` 修改为 `MutableList`
+
 **功能描述**

 > 获得 `Field` 实例处理类数组，配合 `RemedyPlan` 使用。
--- a/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/members/MethodFinder.md
+++ b/docs-source/src/zh-cn/api/public/com/highcapable/yukihookapi/hook/core/finder/members/MethodFinder.md
@@ -427,7 +427,7 @@ inner class Result internal constructor()
 #### onFind <span class="symbol">- method</span>

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

 **变更记录**
@@ -438,6 +438,10 @@ fun onFind(initiate: HashSet<Method>.() -> Unit)

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

+`v1.2.0` `修改`
+
+`initiate` 类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 当在 `RemedyPlan` 中找到结果时。
@@ -665,13 +669,17 @@ method {
 ### all <span class="symbol">- method</span>

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

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `ArrayList` 修改为 `MutableList`
+
 **功能描述**

 > 获得 `Method` 实例处理类数组。
@@ -713,20 +721,24 @@ fun give(): Method?
 ### giveAll <span class="symbol">- method</span>

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

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+返回值类型由 `HashSet` 修改为 `MutableList`
+
 **功能描述**

 > 得到 `Method` 本身数组。

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

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

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

@@ -755,13 +767,17 @@ fun wait(instance: Any?, initiate: Instance.() -> Unit)
 ### waitAll <span class="symbol">- method</span>

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

 **变更记录**

 `v1.1.0` `新增`

+`v1.2.0` `修改`
+
+`initiate` 类型由 `ArrayList` 修改为 `MutableList`
+
 **功能描述**

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