Titan-Dex字节码操作框架
描述
Titan-Dex是面向Android Dalvik(ART)字节码(bytecode)格式的操纵框架,可以在二进制格式下实现修改已有的类,或者动态生成新的类。
功能类似于著名的针对JVM字节码格式的ASM框架,在Android平台上从JVM Class格式到Dex格式要经过dx、d8等工具的转换,
有些情况下会造成期望结果的失真,而Titan-Dex针对Dalvik(ART)字节码格式,可以所操纵就所得的效果,在有些场景下更加适合,比如在Titan-Hotfix,还有classes.dex体积分析与优化等项目中就使用了Titan-Dex。
基于Titan-Dex最基础的操纵框架能力,还包含了一系列的字节码转换、代码流图分析、multi-dex分包等工具集合。
特性
- 支持Dex最新格式,提供Node和Visitor两种模式,方便操纵Dex元素
- 支持读取和输出smali格式
- 支持字节码指令流图分析功能,可以校验字节码类型安全性,以及获取pc偏移出的寄存器类型集合
- 支持基于Titan-Dex的多种扩展,比如multi-dex分包能力等。
快速开始
使用上非常类似于ASM框架,如果需要修改或者新增Dalvki(ART)字节码,请同时参考Android官方文档
最新版本已经发布到jcenter上
implementation("com.baidu.titan.dex:dex-core:1.0.9")
implementation("com.baidu.titan.dex:dex-io:1.0.9")
使用示例
DexItemFactory dexFactory = new DexItemFactory();
MultiDexFileBytes mdfb = MultiDexFileBytes.createFromZipFile(new File("test.apk"));
// dex reader
MultiDexFileReader mdReader = new MultiDexFileReader(dexFactory);
mdfb.forEach((dexId, dexBytes) -> {
mdReader.addDexContent(dexId, dexBytes.getDexFileBytes());
});
mdReader.accept(new MultiDexFileVisitor() {
@Override
public DexFileVisitor visitDexFile(int dexId) {
return new DexFileVisitor() {
@Override
public DexClassVisitor visitClass(DexClassVisitorInfo classInfo) {
return new DexClassVisitor() {
@Override
public void visitBegin() {
}
@Override
public void visitSourceFile(DexString sourceFile) {
}
@Override
public DexAnnotationVisitor visitAnnotation(DexAnnotationVisitorInfo annotationInfo) {
return super.visitAnnotation(annotationInfo);
}
@Override
public DexFieldVisitor visitField(DexFieldVisitorInfo fieldInfo) {
return super.visitField(fieldInfo);
}
@Override
public DexMethodVisitor visitMethod(DexMethodVisitorInfo methodInfo) {
return super.visitMethod(methodInfo);
}
@Override
public void visitEnd() {
}
};
}
};
}
});
// dex node
MultiDexFileNode mdfn = new MultiDexFileNode();
mdReader.accept(mdfn.asVisitor());
Map<Integer, DexFileNode> dexFiles = mdfn.getDexNodes();
dexFiles.forEach((dexId, dexFileNode) -> {
List<DexClassNode> classes = dexFileNode.getClassesList();
// ...
});
测试
在dex-test/src/test目录下编写了多个测试用例,可以通过命令行,或者在android studio中执行测试
如何贡献
欢迎一起参与改进Titan-Dex!
提交的代码需通过code style检查,完成自测,有相应的单元测试用例。
License
This project is licensed under the Apache-2.0 license - see the LICENSE file for details