JarJar 开源项目教程

1. 项目目录结构及介绍

JarJar 是一个 Java 类重组工具，它可以帮助你在编译时重命名或移动类，以支持代码混淆或者合并多个库。以下是项目的目录结构及其主要组成部分：

.
├── build.xml        # Ant 构建脚本，用于执行构建任务
├── COPYING           # 许可证文件，描述该项目的授权条款
├── jarjar            # 主要源代码目录，包含核心处理逻辑
│   ├── Main.java     # JarJar 应用的主入口点
│   └── ...           # 其他源代码文件和辅助类
├── lib               # 依赖的第三方库，如 Ant 的扩展库
└── README.md         # 项目说明文档

2. 项目启动文件介绍

启动 JarJar 通常通过 Ant 脚本 build.xml 进行。这个脚本定义了如何运行 JarJar 并提供了多个目标（tasks）供用户调用。例如，你可以执行以下命令来运行 JarJar：

ant run -Dinput.jar=path/to/input.jar -Doutput.jar=path/to/output.jar \
    -Drules.file=path/to/rules.txt

在上述命令中：

• run 是 Ant 目标，执行 JarJar。
• -Dinput.jar 指定输入的 JAR 文件路径。
• -Doutput.jar 设置输出的重打包后的 JAR 文件路径。
• -Drules.file 定义了操作规则的文本文件。

3. 项目的配置文件介绍

JarJar 的关键在于 规则文件 （默认是 rules.txt），它定义了如何处理类之间的关系。规则文件是纯文本格式，每行表示一条规则，基本语法如下：

rule <source class> <target class>

• <source class>: 需要被处理的原始类全名。
• <target class>: 处理后的类全名，可以包含新的包名和类名。

例如，如果你想要将 com.example.OldClass 重命名为 com.newpackage.NewClass，规则文件的一条记录可能是：

rule com.example.OldClass com.newpackage.NewClass

除了简单的重命名，规则文件还可以指定类间的依赖关系，比如将一个类中的方法移到另一个类中，或者删除不需要的类：

move com.example.OldClass#oldMethod() com.newpackage.NewClass

这条规则会把 OldClass 中名为 oldMethod() 的方法移到 NewClass 中。

了解了这些基本信息后，你应该能够开始使用 JarJar 对 Java 类进行重组了。记得自定义 rules.txt 文件以满足你的特定需求。更多详细的配置选项和高级用法，建议参考项目 Readme 或者相关的文档说明。