从入门到精通：Il2CppAssemblyUnhollower逆向工程工具全解析

Il2CppAssemblyUnhollower是一款专注于Unity游戏逆向工程的开源工具，通过解析Il2Cpp生成的程序集，实现Managed到IL2CPP的代理程序集转换，为Unity程序集解析和Il2Cpp反汇编提供强大支持。本文将从核心架构、操作流程到高级应用，全面揭秘这款工具的技术原理与实战技巧。

核心模块探秘：工具架构深度解析 📁

1. 主程序模块：AssemblyUnhollower

作为工具的核心驱动模块，AssemblyUnhollower包含了整个转换流程的控制逻辑。其核心组件包括：

• 上下文管理：Contexts目录下的AssemblyRewriteContext.cs、TypeRewriteContext.cs等文件，负责维护转换过程中的类型、方法和字段上下文信息。

• 元数据访问：MetadataAccess模块通过CecilMetadataAccess.cs等实现对程序集元数据的读取与处理，为后续转换提供数据基础。

• 转换流程控制：Passes目录下的系列Pass文件（如Pass10CreateTypedefs.cs、Pass50GenerateMethods.cs）构成了完整的转换流水线，每个Pass负责特定阶段的处理任务。

2. 基础支持库：UnhollowerBaseLib

UnhollowerBaseLib提供了工具运行所需的基础类型和运行时支持，包括：

• 运行时类型系统：Il2CppObjectBase.cs、Il2CppClassPointerStore.cs等文件定义了与IL2CPP运行时交互的基础类型。

• 版本适配层：Runtime/VersionSpecific目录下针对不同Unity版本的实现（如Class_24_1_A.cs、MethodInfo_27_3.cs），确保工具在各版本Unity环境中的兼容性。

• 跨平台支持：StructHandlerInterfaces.cs和NativeStructUtils.cs提供了与原生结构交互的抽象层，支持多平台架构。

3. 辅助工具集

• 调试支持：UnhollowerPdbGen模块通过MsPdbCore.cs实现PDB文件生成，辅助调试过程。

• 运行时转发：UnhollowerRuntimeLib提供了Forwarders.cs等运行时转发逻辑，确保生成的代理程序集正确对接IL2CPP运行时。

实战操作指南：从环境搭建到结果输出 ⚙️

1. 环境准备

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/il/Il2CppAssemblyUnhollower
cd Il2CppAssemblyUnhollower

# 使用Visual Studio打开解决方案
start AssemblyUnhollower.sln

2. 核心转换流程解析

Il2CppAssemblyUnhollower的工作流程可分为三个主要阶段：

1. 元数据收集：通过CecilMetadataAccess读取原始程序集信息，建立类型、方法和字段的元数据模型。

2. 转换处理：通过Pass系列按顺序执行类型定义创建、方法参数复制、字段访问器生成等操作，逐步构建代理程序集结构。

3. 代码生成：最终通过Pass90WriteToDisk.cs将转换结果写入磁盘，生成可用于逆向分析的代理程序集。

3. 关键配置项

工具配置主要通过UnhollowerOptions.cs进行管理，核心配置项包括：

• 输出路径：控制生成文件的存储位置
• 日志级别：调整日志输出详细程度
• 类型过滤：设置需要处理的特定命名空间或类型
• 反混淆选项：配置名称修复和反混淆策略

高级应用场景：解锁工具全部潜力 🔍

1. 自定义转换规则

通过扩展Passes目录下的转换逻辑，可以实现自定义的代码生成规则。例如修改Pass50GenerateMethods.cs可定制方法体生成策略，满足特定逆向分析需求。

2. 版本适配开发

对于特定Unity版本的适配，可参考Runtime/VersionSpecific目录下的现有实现，添加新的版本支持类，扩展工具的兼容性范围。

3. 批量处理脚本

结合工具的命令行接口，可以编写批量处理脚本，实现多个程序集的自动化转换。典型的命令行使用方式如下：

# 基本转换命令示例
AssemblyUnhollower --input=original_assembly.dll --output=output_directory

常见问题解决方案

1. 类型转换错误

当遇到类型转换异常时，可检查TypeRewriteContext.cs中的类型映射逻辑，确保目标类型与IL2CPP运行时类型正确对应。

2. 方法签名不匹配

方法签名问题通常源于元数据解析错误，可通过Pass16ScanMethodRefs.cs中的引用扫描逻辑进行调试，确认方法引用的正确性。

3. 生成代码无法编译

编译错误多由代码生成逻辑不完善导致，可重点检查Pass50GenerateMethods.cs和Pass70GenerateProperties.cs中的代码生成模板，修正语法错误。

总结

Il2CppAssemblyUnhollower作为Unity逆向工程的利器，通过模块化的架构设计和灵活的转换流程，为开发者提供了强大的IL2CPP程序集解析能力。无论是游戏分析、插件开发还是逆向研究，掌握这款工具都将极大提升工作效率。通过本文介绍的核心模块解析和实战指南，相信你已对工具的使用有了全面了解，接下来就可以开始探索Unity程序集的奥秘了。

附录：项目结构速览

Il2CppAssemblyUnhollower/
├── AssemblyUnhollower/        # 主程序模块
├── UnhollowerBaseLib/         # 基础支持库
├── UnhollowerPdbGen/          # PDB生成工具
├── UnhollowerRuntimeLib/      # 运行时转发库
└── Documentation/             # 项目文档