当前位置：首页 > news >正文

DexKit API参考手册：从基础查询到高级匹配的完整指南

news 2026/6/10 16:20:48

DexKit API参考手册：从基础查询到高级匹配的完整指南

【免费下载链接】DexKitAn easy-to-use, high-performance dex deobfuscation library.项目地址: https://gitcode.com/gh_mirrors/de/DexKit

DexKit是一款简单易用、高性能的dex反混淆库，为开发者提供了强大的API工具集，帮助快速定位和分析Android应用中的类、方法和字段。本手册将系统介绍DexKit的核心API功能，从基础查询到高级匹配技巧，助你轻松掌握反混淆分析的关键技能。

一、核心API概览

DexKit的API设计遵循直观易用的原则，主要分为以下几大模块：

1.1 查询接口

DexKit提供了三类核心查询接口，覆盖Android应用分析的主要场景：

类查询：FindClass.kt
方法查询：FindMethod.kt
字段查询：FindField.kt

这些接口位于dexkit/src/main/java/org/luckypray/dexkit/query/目录下，构成了DexKit的基础查询能力。

1.2 批量查询

对于需要同时处理多个查询条件的场景，DexKit提供了高效的批量查询接口：

批量类查询：BatchFindClassUsingStrings.kt
批量方法查询：BatchFindMethodUsingStrings.kt

批量查询接口特别适合在大型应用中快速定位多个目标，显著提升分析效率。

二、基础查询使用指南

2.1 类查询基础

类查询是DexKit最常用的功能之一，通过FindClass接口可以轻松定位符合条件的类。基本使用步骤如下：

创建DexKitBridge实例，加载目标dex文件
使用FindClass构建查询条件
调用findClasses方法执行查询
处理返回的ClassData.kt结果集

val classes = dexKit.findClasses { className = "com.example.target.Class" }

2.2 方法查询基础

方法查询通过FindMethod接口实现，支持按方法名、参数类型、返回值类型等条件筛选：

val methods = dexKit.findMethods { methodName = "onCreate" returnType = "void" paramTypes = listOf("android.os.Bundle") }

查询结果将返回MethodData.kt对象列表，包含方法的完整信息。

2.3 字段查询基础

字段查询使用FindField接口，可以根据字段名、类型等条件查找目标字段：

val fields = dexKit.findFields { fieldName = "sInstance" type = "com.example.target.Singleton" }

查询结果为FieldData.kt对象列表，包含字段的详细描述。

三、高级匹配技巧

3.1 字符串匹配策略

DexKit提供多种字符串匹配方式，满足不同场景的需求：

精确匹配：完全匹配字符串内容
模糊匹配：使用通配符*和?进行模式匹配
正则匹配：支持正则表达式匹配

这些匹配策略通过StringMatcher.kt实现，可应用于类名、方法名、字段名等多种查询条件。

3.2 注解匹配

对于使用注解标记的代码元素，DexKit提供了强大的注解匹配能力：

val annotatedMethods = dexKit.findMethods { annotations { annotationClass = "com.example.annotation.Router" elements { name = "path" value = "/main" } } }

相关实现可参考AnnotationMatcher.kt和AnnotationsMatcher.kt。

3.3 操作码匹配

DexKit支持通过Dalvik操作码序列来匹配方法，这对于定位具有特定行为的代码非常有用：

val methodsWithOpCodes = dexKit.findMethods { opCodes { opCodes = listOf("const-string", "invoke-virtual") matchType = OpCodeMatchType.Contains } }

操作码匹配的实现位于OpCodesMatcher.kt。

四、查询优化与性能提升

4.1 使用缓存桥接器

为提高重复查询的效率，DexKit提供了缓存桥接器功能：

val cacheBridge = DexKitCacheBridge(dexKit) // 首次查询会缓存结果 val result1 = cacheBridge.findClasses { ... } // 后续查询将直接使用缓存 val result2 = cacheBridge.findClasses { ... }

相关实现可参考DexKitCacheBridge.kt。