Unity HybirdCLR 简单了解 笔记

1、关于 IL2CPP

① 字面意思:

IL2CPP 的字面意思很直白:

IL (Intermediate Language,中间语言) to (到) CPP (C++ 语言)

就是:"将中间语言转换为 C++ 代码"


② 大致流程:

你写的 C# 代码(.cs 文件)先被编译成 IL (.dll 程序集),然后在项目构建(Build) 时,IL2CPP 会读取这些 IL 代码,把它转换成庞大的 C++ 源文件,最后再用平台自带的 C++ 编译器(如 MSVC、Clang、GCC)生成原生的机器码(.exe、.so、.a 或 .app)。


③ 实现的主要目的:

覆盖苹果IOS、WebGL平台:iOS 平台禁止 JIT 编译,只允许运行原生机器码。IL2CPP 提前生成原生二进制的方式(AOT编译),契合 iOS 的要求。同时,它也适用于 WebGL 等无法使用 JIT 的平台。


实现一个 IL 到 C++ 转换器,难度极高;IL2CPP 也并不是基于某个现成的开源项目改出来的,而是 Unity 官方从零开始、投入大量顶尖工程师自主设计和实现的。


2、关于 HybirdCLR

大致实现思路:

HybridCLR 是在 IL2CPP的 "IL 转 C++ " 这个步骤里,向C++ 代码里注入了一套解释器的实现代码 。让 IL2CPP 运行时接纳热更新代码。它是对IL2CPP的魔改。


3、 在Unity打包时,HybirdCLR具体是如何 "劫持" IL2CPP 的?

先了解 Unity 用 IL2CPP 打包时的 具体步骤:

  1. Unity 先启动一个 Mono 环境mono.exe)。

  2. 在这个环境里,运行我们的主角 il2cpp.exe

  3. 把编译好的 C# 代码(.dll 文件) 作为"原料"喂给它。

  4. il2cpp.exe 经过一系列复杂的分析和转换,最终在指定的输出文件夹里,生成海量的 .cpp.h 文件

  5. 最后,Unity 再调用平台自带的 C++ 编译器(比如 MSVC 或 Clang),把这些 .cpp 文件编译成最终的机器码,也就是你能玩到的游戏程序

关键在第2步上,这个il2cpp.exe(IL-C++)的转换器,就藏在你的 Unity 安装目录里。

具体路径如下:

  • WindowsUnity安装目录\Editor\Data\il2cpp\

  • macOSUnity安装目录\Contents\Frameworks\il2cpp\build\

HybridCLR 的具体步骤是:

具体操作是:

  1. 拿到源码 :拿到了 il2cpp.exe 的源代码。

  2. 植入代码:在源码的关键位置(比如处理类型、方法的函数里),插入大量的"拦截"判断。

  3. 重新编译 :把修改后的源码,编译成一个全新的、定制版的 il2cpp.exe

  4. 放回原位 :用这个定制版,替换掉 Unity 目录里那个官方的 il2cpp.exe


4、HybridCLR 直接改了Unity安装目录的 il2cpp.exe ??

那不想用``了怎么办?怎么改回来?

注意:

HybridCLR 并没有 直接改动 你电脑上 Unity 安装目录里的 il2cpp.exe

它的工作方式很简单:(在你 HybridCLR - Installer 时)把Unity官方的 il2cpp 文件夹复制一份到你项目的 HybridCLRData 目录里,然后在这个副本上做手脚。 打包时,通过 Unity 开放的环境变量接口让编译器去读项目里的这个"魔改版"。

Unity完全支持 IL2CPP路径指向自己的exe: 在手册中明确提到了这个环境变量:IL2CPP_ADDITIONAL_ARGS 。这说明 Unity 在设计 IL2CPP 时,刻意保留了让外部程序可以干预编译流程的接口

注意的是,不是改动全局变量,而仅仅是 Unity 进程内的变量,这样能保证即使另开一个Unity项目,没有安装HybridCLR,也不会调用HybridCLR魔改后的il2cpp.exe

全局变量

  • 作用范围:整个操作系统。所有正在运行和将来会运行的程序都能读到它。

  • 修改方式:通常需要管理员权限,通过系统的"环境变量"设置界面修改。

  • 持久性 :修改后永久生效,直到你再次手动修改。重启电脑都还在。

  • 潜在风险 :如果你用这种方式把 UNITY_IL2CPP_PATH 指向了魔改版,那么你电脑上所有 Unity 项目、所有版本的 Unity 编辑器 ,在打包时都会去用那个魔改版。这会严重扰乱其他项目的正常打包。

进程内变量 (HybridCLR 使用的方式):

  • 作用范围只影响当前正在运行的、安装了 HybridCLR 的这个 Unity 编辑器进程

  • 修改方式 :不需要任何管理员权限,HybridCLR 的脚本在 Unity 内部直接调用 System.Environment.SetEnvironmentVariable 完成。

  • 持久性不持久 。只要这个 Unity 编辑器进程关闭(你关掉 Unity 软件),这个修改就彻底消失,仿佛从未存在过。

  • 安全性 :非常安全。它完全不会干扰你同时打开的其他 Unity 项目,也不会干扰你电脑上的任何其他程序,包括其他版本的 Unity 编辑器

相关推荐
LinXunFeng6 天前
Obsidian - 使用 Share Note 分享笔记并自部署
前端·笔记·github
闪闪发亮的小星星10 天前
高斯光以及高斯光公式解释
笔记
cqbzcsq11 天前
CellFlow虚拟细胞论文阅读
论文阅读·人工智能·笔记·学习·生物信息
阿米亚波11 天前
【Windows】QEMU 启动 openEuler aarch64/arm64 架构系统 + 离线软件源
linux·windows·经验分享·笔记·架构·arm
自传.11 天前
尚硅谷 Vibe Coding|第三章(1) Claude Code深度使用与进阶技巧 学习笔记
笔记·学习·尚硅谷·vibecoding
.千余11 天前
【C++】模板进阶全解:非类型参数|全特化|偏特化|分离编译完全指南
开发语言·c++·笔记·学习·其他
自传.11 天前
尚硅谷 Vibe Coding|第二章 AI编程工具生态 学习笔记
笔记·学习·ai编程·尚硅谷·vibe coding
秋波。未央11 天前
Java Agent 开发 · Day 1 学习笔记(含作业完整标准答案)
java·笔记·学习
中屹指纹浏览器11 天前
2026指纹浏览器字体指纹、字体渲染偏差检测与全维度虚拟字体池搭建方案
经验分享·笔记