Il2CppDumper/README.md

42 lines
2.6 KiB
Markdown
Raw Normal View History

2016-12-30 15:29:45 -03:00
# Il2CppDumper
2017-04-11 03:37:13 -03:00
[![Build status](https://ci.appveyor.com/api/projects/status/anhqw33vcpmp8ofa?svg=true)](https://ci.appveyor.com/project/Perfare/il2cppdumper/branch/master/artifacts)
2017-10-25 18:30:24 -03:00
从il2cpp中获取types, methods, fields等等数据
基础逻辑代码来源于[Il2CppDumper](https://github.com/Jumboperson/Il2CppDumper)
2017-04-11 03:37:13 -03:00
2017-10-25 18:30:24 -03:00
## 功能
* 支持ELF(arm, x86), Mach-O(32bit, 64bit)
* 支持Metadata版本16, 20, 21, 22, 23, 24
* 导出包括types, parent, fields, properties, methods, attributes
* 自动生成IDA脚本(重命名methodName和添加stringLiteral注释)
2017-04-14 22:18:02 -03:00
2017-10-25 18:30:24 -03:00
## 使用说明
运行Il2CppDumper.exe并依次选择il2cpp的可执行文件ELF或者Mach-O文件和global-metadata.dat文件然后选择运行的模式将生成dump.cs文件和script.py脚本
### 关于模式
#### Manual
你需要手动输入CodeRegistration和MetadataRegistration的指针地址一般需要依靠反汇编工具来获取地址
#### Auto
原理是通过函数的特征字节找到il2cpp_codegen_register函数并获取传入il2cpp::vm::MetadataCache::Register中的参数1CodeRegistration和参数2MetadataRegistration。不过由于不同编译器编译出来的结果有差异对于不常见的形式将无法正常工作。
#### Auto(Advanced)
支持Metadata 20及以后的版本在16版本下只能获取到CodeRegistration地址能够处理几乎所有包括Auto模式不能处理的文件不过仍然会有无法处理的文件。
### 关于dump.cs
作为文本文件打开即可
### 关于script.py
2017-11-03 06:14:59 -03:00
需要安装IDA所需的python。在IDA中File-Script file选择script.py运行即可会重命名methodName和添加stringLiteral注释
2017-10-25 18:30:24 -03:00
### 关于config.json
2017-11-03 06:14:59 -03:00
`dumpmethod``dumpfield``dumpproperty``dumpattribute``dumpfieldoffset`
2017-10-25 18:30:24 -03:00
控制程序是否在dump.cs输出相应的内容  
2017-11-03 06:14:59 -03:00
`forceil2cppversion``forceversion`
当forceil2cppversion为true时程序将根据forceversion指定的版本读取il2cpp的可执行文件Metadata仍然使用header里的版本这在部分低版本的il2cpp中将会有用比如安卓20版本下你可能需要设置forceversion为16程序才能正常工作
## 常见问题
#### `ERROR: Metadata file supplied is not valid metadata file.`
正如它所显示的你选择的global-metadata.dat不是一个有效的metadata文件通常是因为游戏加密了global-metadata.dat文件。关于解密的问题最好去破解论坛寻求帮助请不要在issues提问
#### `ERROR: Unable to process file automatically, try to use other mode.`  
当所有自动模式都无法运行时你可以在issue提问提问时请一并上传文件!