diff --git a/docs/api/public/ConstructorFinder.md b/docs/api/public/ConstructorFinder.md index 8b4c5438..01f0e534 100644 --- a/docs/api/public/ConstructorFinder.md +++ b/docs/api/public/ConstructorFinder.md @@ -496,21 +496,33 @@ inline fun onNoSuchConstructor(result: (Throwable) -> Unit): Result 只会返回第一次的错误信息,不会返回 `RemedyPlan` 的错误信息。 -#### ignoredError [method] +#### ignored [method] ```kotlin -fun ignoredError(): Result +fun ignored(): Result ``` **变更记录** +`v1.0.93` `新增` + +**功能描述** + +> 忽略异常并停止打印任何错误日志。 + +若 `isNotIgnoredHookingFailure` 为 `false` 则自动忽略。 + +!> 此时若要监听异常结果,你需要手动实现 `onNoSuchConstructor` 方法。 + +#### ~~ignoredError [method]~~ + +**变更记录** + `v1.0.3` `新增` -**功能描述** +`v1.0.93` `作废` -> 忽略任何错误发出的警告。 - -若 `isNotIgnoredHookingFailure` 为 `false` 则自动忽略。 +请转移到新方法 `ignored()` #### Instance [class] diff --git a/docs/api/public/FieldFinder.md b/docs/api/public/FieldFinder.md index 76a20ea3..d4438d14 100644 --- a/docs/api/public/FieldFinder.md +++ b/docs/api/public/FieldFinder.md @@ -490,21 +490,33 @@ fun onNoSuchField(result: (Throwable) -> Unit): Result > 监听找不到 `Field` 时。 -#### ignoredError [method] +#### ignored [method] ```kotlin -fun ignoredError(): Result +fun ignored(): Result ``` **变更记录** +`v1.0.93` `新增` + +**功能描述** + +> 忽略异常并停止打印任何错误日志。 + +若 `isNotIgnoredHookingFailure` 为 `false` 则自动忽略。 + +!> 此时若要监听异常结果,你需要手动实现 `onNoSuchField` 方法。 + +#### ~~ignoredError [method]~~ + +**变更记录** + `v1.0.3` `新增` -**功能描述** +`v1.0.93` `作废` -> 忽略任何错误发出的警告。 - -若 `isNotIgnoredHookingFailure` 为 `false` 则自动忽略。 +请转移到新方法 `ignored()` #### Instance [class] diff --git a/docs/api/public/MethodFinder.md b/docs/api/public/MethodFinder.md index 64fbc57d..f262aea1 100644 --- a/docs/api/public/MethodFinder.md +++ b/docs/api/public/MethodFinder.md @@ -588,21 +588,33 @@ inline fun onNoSuchMethod(result: (Throwable) -> Unit): Result 只会返回第一次的错误信息,不会返回 `RemedyPlan` 的错误信息。 -#### ignoredError [method] +#### ignored [method] ```kotlin -fun ignoredError(): Result +fun ignored(): Result ``` **变更记录** +`v1.0.93` `新增` + +**功能描述** + +> 忽略异常并停止打印任何错误日志。 + +若 `isNotIgnoredHookingFailure` 为 `false` 则自动忽略。 + +!> 此时若要监听异常结果,你需要手动实现 `onNoSuchMethod` 方法。 + +#### ~~ignoredError [method]~~ + +**变更记录** + `v1.0.3` `新增` -**功能描述** +`v1.0.93` `作废` -> 忽略任何错误发出的警告。 - -若 `isNotIgnoredHookingFailure` 为 `false` 则自动忽略。 +请转移到新方法 `ignored()` #### Instance [class] diff --git a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/ConstructorFinder.kt b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/ConstructorFinder.kt index 9382c852..8eb59a33 100644 --- a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/ConstructorFinder.kt +++ b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/ConstructorFinder.kt @@ -430,16 +430,29 @@ class ConstructorFinder @PublishedApi internal constructor( } /** - * 忽略任何错误发出的警告 + * 忽略异常并停止打印任何错误日志 * * - 若 [isNotIgnoredNoSuchMemberFailure] 为 false 则自动忽略 + * + * - ❗此时若要监听异常结果 - 你需要手动实现 [onNoSuchConstructor] 方法 * @return [Result] 可继续向下监听 */ - fun ignoredError(): Result { + fun ignored(): Result { isShutErrorPrinting = true return this } + /** + * 忽略异常并停止打印任何错误日志 + * + * - ❗此方法已弃用 - 在之后的版本中将直接被删除 + * + * - ❗请现在转移到 [ignored] + * @return [Result] 可继续向下监听 + */ + @Deprecated(message = "请使用新的命名方法", ReplaceWith(expression = "ignored()")) + fun ignoredError() = ignored() + /** * [Constructor] 实例处理类 * diff --git a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/FieldFinder.kt b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/FieldFinder.kt index 55461768..91fa5957 100644 --- a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/FieldFinder.kt +++ b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/FieldFinder.kt @@ -432,16 +432,29 @@ class FieldFinder @PublishedApi internal constructor( } /** - * 忽略任何错误发出的警告 + * 忽略异常并停止打印任何错误日志 * * - 若 [isNotIgnoredNoSuchMemberFailure] 为 false 则自动忽略 + * + * - ❗此时若要监听异常结果 - 你需要手动实现 [onNoSuchField] 方法 * @return [Result] 可继续向下监听 */ - fun ignoredError(): Result { + fun ignored(): Result { isShutErrorPrinting = true return this } + /** + * 忽略异常并停止打印任何错误日志 + * + * - ❗此方法已弃用 - 在之后的版本中将直接被删除 + * + * - ❗请现在转移到 [ignored] + * @return [Result] 可继续向下监听 + */ + @Deprecated(message = "请使用新的命名方法", ReplaceWith(expression = "ignored()")) + fun ignoredError() = ignored() + /** * [Field] 实例处理类 * diff --git a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/MethodFinder.kt b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/MethodFinder.kt index 92b43e75..48858954 100644 --- a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/MethodFinder.kt +++ b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/core/finder/MethodFinder.kt @@ -504,16 +504,29 @@ class MethodFinder @PublishedApi internal constructor( } /** - * 忽略任何错误发出的警告 + * 忽略异常并停止打印任何错误日志 * * - 若 [isNotIgnoredNoSuchMemberFailure] 为 false 则自动忽略 + * + * - ❗此时若要监听异常结果 - 你需要手动实现 [onNoSuchMethod] 方法 * @return [Result] 可继续向下监听 */ - fun ignoredError(): Result { + fun ignored(): Result { isShutErrorPrinting = true return this } + /** + * 忽略异常并停止打印任何错误日志 + * + * - ❗此方法已弃用 - 在之后的版本中将直接被删除 + * + * - ❗请现在转移到 [ignored] + * @return [Result] 可继续向下监听 + */ + @Deprecated(message = "请使用新的命名方法", ReplaceWith(expression = "ignored()")) + fun ignoredError() = ignored() + /** * [Method] 实例处理类 * diff --git a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/factory/ReflectionFactory.kt b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/factory/ReflectionFactory.kt index ac462559..1fff2805 100644 --- a/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/factory/ReflectionFactory.kt +++ b/yukihookapi/src/api/kotlin/com/highcapable/yukihookapi/hook/factory/ReflectionFactory.kt @@ -96,22 +96,21 @@ fun String.hasClass(loader: ClassLoader? = null) = try { * @param initiate 方法体 * @return [Boolean] 是否存在 */ -inline fun Class<*>.hasField(initiate: FieldFinder.() -> Unit) = field(initiate).ignoredError().isNoSuch.not() +inline fun Class<*>.hasField(initiate: FieldFinder.() -> Unit) = field(initiate).ignored().isNoSuch.not() /** * 查找方法是否存在 * @param initiate 方法体 * @return [Boolean] 是否存在 */ -inline fun Class<*>.hasMethod(initiate: MethodFinder.() -> Unit) = method(initiate).ignoredError().isNoSuch.not() +inline fun Class<*>.hasMethod(initiate: MethodFinder.() -> Unit) = method(initiate).ignored().isNoSuch.not() /** * 查找构造方法是否存在 * @param initiate 方法体 * @return [Boolean] 是否存在 */ -inline fun Class<*>.hasConstructor(initiate: ConstructorFinder.() -> Unit = { emptyParam() }) = - constructor(initiate).ignoredError().isNoSuch.not() +inline fun Class<*>.hasConstructor(initiate: ConstructorFinder.() -> Unit = { emptyParam() }) = constructor(initiate).ignored().isNoSuch.not() /** * 查询 [Member] 中匹配的描述符