Jadx项目中的自定义重命名功能实现指南

在Android逆向工程领域，Jadx作为一款强大的反编译工具，提供了灵活的脚本扩展功能。本文将详细介绍如何利用Jadx脚本实现类名、方法名和字段名的自定义重命名功能，帮助开发者更好地进行代码反混淆工作。

脚本功能概述

Jadx脚本系统允许用户通过编写简单的Kotlin代码来扩展工具功能。本文介绍的脚本实现了以下核心功能：

1. 从外部文本文件读取自定义名称列表
2. 自动为反编译后的类、方法和字段应用这些名称
3. 支持名称循环使用机制，避免名称冲突

脚本实现原理

初始化设置

脚本首先禁用Jadx内置的反混淆功能，并清空默认的重命名标志，确保完全由脚本控制重命名过程：

jadx.args.isDeobfuscationOn = false
jadx.args.renameFlags = emptySet()

名称提供器配置

脚本提供了灵活的配置选项，允许用户指定包含名称列表的目录：

val namesDirOpt = jadx.options.registerString(
    "Names dir",
    "Dir with name lists",
    defaultValue = ".",
)

名称列表加载

脚本使用三个独立的NamesProvider实例分别管理类名、字段名和方法名：

val clsNames = NamesProvider(namesDir, "class.txt")
val fldNames = NamesProvider(namesDir, "field.txt")
val mthNames = NamesProvider(namesDir, "method.txt")

重命名逻辑

核心重命名逻辑通过实现jadx.rename.all回调函数完成：

jadx.rename.all { name, node ->
    when (node) {
        is ClassNode -> clsNames.nextName()
        is FieldNode -> fldNames.nextName()
        is MethodNode -> mthNames.nextName()
        else -> null
    }
}

NamesProvider实现细节

NamesProvider类是脚本的核心组件，负责管理名称列表和分配策略：

class NamesProvider(dir: String, fileName: String) {
    private val names = Files.readAllLines(Paths.get(dir, fileName))
    private var pos = 0
    private var cycle = 0

    fun nextName(): String {
        pos++
        if (pos >= names.size) {
            pos = 0
            cycle++
        }
        return if (cycle == 0) names[pos] else names[pos] + 'C' + cycle
    }
}

该实现具有以下特点：

1. 名称列表加载：从指定目录读取文本文件，每行作为一个名称
2. 循环分配机制：当名称列表用尽时，自动从头开始并添加循环标记
3. 唯一性保证：通过添加循环计数器后缀确保名称唯一性

实际应用建议

1. 名称列表准备：

   • 为不同用途准备有意义的名称列表
   • 可以按功能分类准备多个名称列表文件

2. 脚本优化方向：

   • 添加名称列表验证逻辑，确保符合Java标识符规范
   • 实现名称分配策略配置，如随机分配或顺序分配
   • 添加名称使用统计功能，跟踪哪些名称已被使用

3. 高级应用场景：

   • 结合代码特征分析，为特定模式的方法分配特定名称
   • 实现基于调用关系的智能命名策略
   • 与代码注释系统集成，为重要元素添加说明性名称

总结

通过Jadx脚本系统实现自定义重命名功能，为Android逆向工程提供了高度灵活的反混淆解决方案。这种方法的优势在于：

1. 完全控制重命名过程，不受内置算法的限制
2. 可以根据项目需求准备专门的名称词典
3. 脚本易于修改和扩展，适应各种复杂场景

掌握这项技术后，开发者可以显著提升反编译代码的可读性，为后续的分析和修改工作奠定良好基础。