github.com/axhlzy/Il2CppHookScripts @V2.0

Il2cppHook

基于 frida 的 libil2cpp.so 运行时解析脚本

特性

• 解析 Unity 的方法 / 类 / 字段
• 解析 运行时 方法参数
• 常用函数的 （批量）断点（参数值 / 返回值 查看）

使用

$ git clone https://github.com/axhlzy/Il2CppHookScripts.git
$ cd Il2cppHook/
$ npm install
$ frida -U --no-pause -f com.xxx.xxx -l  ../_Ufunc.js

API

目录

1. 获取基本信息
   • i() == list_images : 列出所有的 Images
   • c() == list_classes : 列出所有的 Classes
   • m() == list_methods : 列出所有的 Methods
   • f() == list_fields : 列出所有的 Fields
   • findClass(className) : 查找类,一般配合 m() 使用 , m(findClass('className')) === m('className')
   • findMethod / find_method : 根据类名查找相关的函数
   • printExp : 查找名称为参数的函数,比较慢，但是方便
   • getApkInfo : 获取 apk 信息
2. 断点函数
   • B : breakPoint 断点函数类 / b : 断点指定的一个函数
   • n/nn : nop 指定的一个函数
   • breakInline : InlineHook
   • breakWithArgs : 带参数断点
   • breakWithStack : 带堆栈断点
   • watch/watchDisabled : MemoryAccessMonitor的简单封装（arm32易崩）
3. 常用函数Hook的封装
   • HookOnPointerClick ：Hook 点击事件
   • HookDebugLog : Hook Debug.Log
   • HookSetActive : Hook SetActive

...

• i() == list_images 列出所有的 Images

  

• c() == list_classes 列出所有的 Classes

  

• m() == list_methods 列出所有的 Methods

  

• f() == list_fields 列出所有的 Fields

  

• findClass(className) 查找类,一般配合 m() 使用 , m(findClass('className')) === m('className')

  

• findMethod 新版 / find_method 旧版

  

• printExp 作为findMethod的补充版，方便查找函数

  • 第一个参数是查找的函数名
  • 第二个参数标识是否全局查找（默认在常用的函数中查找，因为是遍历嘛，这样可以有效提高查找速度）

• getApkInfo 获取 apk 信息

  

• B breakPoint 断点函数类

• B ('ClassName') === B(findClass('ClassName')),不会重复添加已添加的Method,不带参数即断点所有常用的方法

  

• b ('Method_Pointer') / b('MethodInfo_Pointer')

  

• d / D : d === detachAll and d(ptr) === detach(ptr) / D() === detachAll + clear list cache

• n/nn nop Function

• n / nn : n(ptr) === nop function and nn() === cancel nop function

  

• breakInline InlineHook

  

• breakWithArgs 带参数断点

  

• breakWithStack 带堆栈断点

  

• watch/watchDisabled MemoryAccessMonitor的简单封装（arm32易崩）

  

• HookOnPointerClick ：Hook 点击事件

  

• HookDebugLog : Hook Debug.Log

  

• HookSetActive : Hook SetActive

  

...

Commit

• 文件结构按照Unity类继承关系实现
• 文件命名规则以及结构
• 一个类文件夹下一个include.ts包含当前类文件以及该类子类文件夹的include
• api.ts
  • 用作解析常用函数 (exp: ptr(Il2Cpp.Api.Application._Quit) )
  • 函数的命名使用 '_' + 具体的函数名，多参数使用后缀 '_x' 结尾i (exp: Il2Cpp.Api.Application._Quit_1)
  • api class 命名为 类名 + 'API'
• class.ts
  • NativePointer转换为Class的实现 (把ptr当成class来解析)
  • 包含一些（静态）字段，（静态）方法，以及方便调用的一些函数封装
  • this.handle 存贮当前 ptr，可以是 实例指针也可以是类指针 （多数情况使用实例指针）
• export.ts
  • 主要用作拓展类的一些导出方法
• TODO 按照这个文件结构可以拓展到整个UnityAPI