Il2CppAssemblyUnhollower 新手入门指南：从功能解析到配置实践

Il2CppAssemblyUnhollower 是一款专为 Unity 游戏逆向工程设计的开源工具，核心功能是解析 IL2CPP 生成的程序集并生成托管代码与 IL2CPP 之间的代理程序集，帮助开发者更友好地分析和调试 Unity 游戏的底层逻辑。本文将从功能解析、核心模块定位到配置指南，带您快速掌握该工具的使用方法。

功能解析：工具核心价值与应用场景

该工具的核心价值在于解决 IL2CPP 编译后的代码难以直接分析的问题。通过生成代理程序集，它将原本晦涩的原生代码转换为可阅读的 C# 代码结构，主要应用于以下场景：

• Unity 游戏逆向工程与代码分析
• 游戏 mod 开发时的 API 适配
• 理解 IL2CPP 编译后的类型转换逻辑
• 修复或优化 IL2CPP 相关的兼容性问题

核心模块定位方法

1. 主程序入口定位

工具的启动入口位于 AssemblyUnhollower/Program.cs，该文件包含程序的主方法（Main），负责解析命令行参数并协调各处理流程的执行。通过查看此文件，可了解工具的整体执行逻辑和参数处理方式。

2. 关键处理流程模块

核心处理逻辑集中在 AssemblyUnhollower/Passes/ 目录下，包含从类型定义到代码生成的完整流程：

• 类型处理：Pass10CreateTypedefs.cs 负责创建类型定义
• 方法生成：Pass50GenerateMethods.cs 处理方法体生成
• 字段访问：Pass40GenerateFieldAccessors.cs 生成字段访问器
• 最终输出：Pass90WriteToDisk.cs 负责将生成的代码写入磁盘

3. 运行时支持组件

UnhollowerBaseLib/ 目录提供了运行时必要的基础结构，包括：

• 类型映射与转换工具
• IL2CPP 原生结构封装
• 跨版本 Unity 支持适配
• 反射与元数据访问接口

配置指南：基础参数与使用方法

1. 获取项目源码

首先通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/il/Il2CppAssemblyUnhollower

2. 解决方案结构

项目主解决方案为 AssemblyUnhollower.sln，包含四个主要项目：

• AssemblyUnhollower：核心转换逻辑实现
• UnhollowerBaseLib：基础类型与运行时支持
• UnhollowerPdbGen：PDB 文件生成工具
• UnhollowerRuntimeLib：运行时转发器实现

3. 基础配置选项

配置主要通过命令行参数进行，关键参数包括：

• --input：指定 IL2CPP 程序集输入目录
• --output：设置生成代码的输出路径
• --game-assembly：指定游戏主程序集路径
• --mscorlib：指定 IL2CPP 运行时库路径

详细参数说明可参考项目文档 Documentation/Command-Line-Usage.md。

常见问题解决：新手入门避坑指南

1. 版本兼容性问题

不同 Unity 版本生成的 IL2CPP 结构存在差异，工具通过 UnhollowerBaseLib/Runtime/VersionSpecific/ 目录下的版本适配代码解决此问题。使用时需确保选择与目标游戏 Unity 版本匹配的处理逻辑。

2. 类型转换错误

若遇到类型转换相关错误，可检查 AssemblyUnhollower/Contexts/TypeRewriteContext.cs 中的类型映射逻辑，该文件负责处理 IL2CPP 类型到托管类型的转换规则。

3. 输出代码异常

当生成的代码出现异常时，可查看 Pass90WriteToDisk.cs 中的输出处理逻辑，或通过 --log-level debug 参数启用详细日志定位问题。

总结与进阶学习路径

Il2CppAssemblyUnhollower 为 Unity 逆向工程提供了强大的代码转换能力，通过本文介绍的核心模块定位和基础配置方法，您已具备初步使用能力。进阶学习建议：

1. 阅读 Documentation/Common-Problems.md 了解常见问题处理方案
2. 研究 AssemblyUnhollower/Passes/ 目录下的各处理阶段实现
3. 通过 UnhollowerBaseLib/Il2CppApi.cs 了解 IL2CPP 原生 API 封装逻辑

掌握这些内容后，您将能更灵活地应用该工具进行 Unity 游戏的底层分析与二次开发。