IL2CPP 与打包:编译流程、AOT 限制、代码裁剪与自动化构建
一、Mono 与 IL2CPP
C# 代码首先被编译成 IL(中间语言),存放在 dll 中。运行时怎么执行 IL,Unity 提供了两种脚本后端:
| Mono | IL2CPP | |
|---|---|---|
| 执行方式 | JIT:运行时把 IL 即时编译成机器码(iOS 等平台上使用解释执行或 AOT) | AOT:打包时把 IL 转换成 C++,再编译成机器码 |
| 构建速度 | 快 | 慢(要生成和编译大量 C++ 代码) |
| 运行性能 | 一般 | 更好 |
| 包体 | 较小 | 较大 |
| iOS | — | 必须使用(iOS 不允许 JIT) |
| Android 64 位 | 不支持 ARM64 | 支持(Google Play 要求 64 位) |
| 反编译难度 | dll 很容易被反编译成源码 | 更难,但元数据仍可以被工具导出类型和方法信息 |
| 动态加载代码 | 可以 Assembly.Load | 不可以(热更新需要特殊方案,见 热更新) |
移动端正式发布基本都使用 IL2CPP。开发阶段可以用 Mono 加快构建。
二、IL2CPP 的编译流程
C# 源码 │ C# 编译器 ▼IL(dll) │ UnityLinker:托管代码裁剪,删除没有用到的代码 ▼裁剪后的 IL │ il2cpp:把 IL 转换成 C++ 代码 ▼C++ 源码 + 元数据(global-metadata.dat) │ 平台的 C++ 编译器(Android NDK 的 clang、Xcode) ▼原生二进制(.so、iOS 静态库)运行时还有一个 libil2cpp 库,负责 GC(Boehm)、类型元数据、反射、线程等托管运行时的功能(见 Unity 的 GC)。
三、AOT 的限制
所有代码在打包时就必须确定,所以运行时不能生成新的代码:
| 限制 | 说明 |
|---|---|
不支持 System.Reflection.Emit | 依赖动态生成代码的库(某些序列化库、表达式树编译、动态代理)不能直接使用,需要预编译的版本 |
| 值类型的泛型实例 | 每个值类型参数的泛型实例都需要单独的代码。代码中从未出现过的组合(比如只通过反射构造的 List<MyStruct>)在运行时就没有实现 |
| 反射 | 反射可以用,但通过反射访问的类型和方法,可能被裁剪掉(见下文) |
dynamic 关键字 | 依赖运行时代码生成,基本不可用 |
引用类型的泛型共享:所有引用类型参数的泛型实例(List<string>、List<Enemy>)共享同一份以 object 为参数的实现,所以引用类型不受影响。新版本的 IL2CPP 支持完全泛型共享,值类型的泛型实例也可以退回到共享实现上运行,缓解了上面的问题,代价是这部分代码会稍慢。
四、代码裁剪
为什么要裁剪
项目引用的程序集(.NET 类库、第三方插件)中有大量从未用到的代码。不裁剪会让包体和 C++ 编译时间都大幅增加。UnityLinker 从入口点出发分析调用关系,删除没有被引用的类型和方法。
裁剪级别
Player Settings → Managed Stripping Level:
| 级别 | 行为 |
|---|---|
| Disabled / Minimal | 几乎不裁剪,最安全,包体最大 |
| Low | 保守地裁剪 |
| Medium | 更积极 |
| High | 最积极,包体最小,最容易误删 |
另外,Strip Engine Code 会裁剪掉项目中没有用到的 Unity 引擎模块。
误删问题
UnityLinker 只能分析静态的引用关系。通过反射才使用的类型和方法,它看不到,就会被删掉,运行时报找不到类型或方法的错误。常见场景:
- 序列化库通过反射创建对象、读写字段;
- 依赖注入框架通过反射构造对象;
- 按字符串名字反射调用的代码;
- Lua 等脚本语言通过反射调用 C#(见 反射与生成代码)。
保留的方法:
<linker> <assembly fullname="MyGame.Runtime"> <type fullname="MyGame.Config.*" preserve="all" /> <!-- 保留整个命名空间 --> </assembly> <assembly fullname="Newtonsoft.Json" preserve="all" /> <!-- 保留整个程序集 --></linker>[UnityEngine.Scripting.Preserve] // 在代码上标记public class SaveData { ... }排查方法:裁剪级别调低后问题消失,基本就可以确定是误删;再根据报错信息找到被删的类型,加入 link.xml。
五、IL2CPP 构建选项
| 选项 | 说明 |
|---|---|
| C++ Compiler Configuration | Debug / Release / Master。Master 优化最充分、构建最慢,用于正式发布 |
| IL2CPP Code Generation | 优化运行速度,或者优化构建时间和包体(使用更多的泛型共享) |
| Script Debugging | 允许连接调试器,会降低性能,正式包关闭 |
崩溃排查:IL2CPP 包崩溃时,调用栈是原生代码的地址。需要保留打包时生成的符号文件,上传到崩溃收集平台,才能把地址还原成 C# 的方法名和行号。
六、自动化打包
手动在编辑器中打包,步骤多、容易出错、占用开发者的机器。项目通常会搭建自动化打包。
命令行打包
public static class BuildScript{ public static void BuildAndroid() { var options = new BuildPlayerOptions { scenes = EditorBuildSettings.scenes.Where(s => s.enabled).Select(s => s.path).ToArray(), locationPathName = "Builds/Android/game.apk", target = BuildTarget.Android, options = BuildOptions.None, }; var report = BuildPipeline.BuildPlayer(options); if (report.summary.result != BuildResult.Succeeded) EditorApplication.Exit(1); // 返回非 0,让 CI 知道构建失败 }}Unity -batchmode -quit -projectPath ./MyGame -executeMethod BuildScript.BuildAndroid -buildTarget Android -logFile build.log-batchmode 表示不打开编辑器界面,-executeMethod 指定执行的静态方法。
CI 流水线
使用 Jenkins、GitLab CI、GitHub Actions 等工具,把打包串成一条流水线:
1. 拉取代码,确定版本号(比如根据提交记录自动生成构建号)2. 导出配置表(见 [配置表工具链](/posts/design/config-pipeline/))3. 生成热更新相关的代码(如 HybridCLR 的 Generate)4. 打包资源(AssetBundle / YooAsset)5. 打包安装包6. 上传:安装包上传到分发平台,热更新资源上传到 CDN,符号文件上传到崩溃平台7. 通知:把结果、下载地址发到团队的聊天群要点:
- 缓存 Library 文件夹:每次从零导入资源非常慢,打包机应该保留 Library 目录;
- 打包机专用,固定 Unity 版本和 SDK 版本,保证构建环境一致(这也影响资源包的哈希,见 AssetBundle 的构建);
- 区分开发包和正式包的参数:调试开关、日志级别、服务器地址、是否开启 Development Build。
Android 要点
- 签名:正式包使用发布用的密钥库(keystore),妥善保管,丢失后无法更新已上架的应用;
- Google Play 要求上传 AAB(Android App Bundle)格式,而不是 APK;
- 可以导出 Gradle 工程,接入原生 SDK 时再自定义 Gradle 配置(见 原生交互)。
iOS 要点
- Unity 只生成 Xcode 工程,还需要用 Xcode 编译、签名、导出 ipa;
- 自动化时用
xcodebuild命令完成归档和导出,签名证书和描述文件需要配置在打包机上; - 可以用
PostProcessBuild回调,在 Unity 生成 Xcode 工程后自动修改工程设置、添加系统库和权限描述。
常见追问
Mono 和 IL2CPP 有什么区别? Mono 运行时 JIT 编译 IL,构建快;IL2CPP 打包时把 IL 转成 C++ 再编译成原生代码,运行更快、支持 iOS 和 64 位、更难反编译,但构建慢、包体大、不能动态加载代码。
IL2CPP 的编译流程是怎样的? C# 编译成 IL,UnityLinker 裁剪,il2cpp 转换成 C++ 和元数据,再由平台的 C++ 编译器编译成原生二进制,运行时由 libil2cpp 提供 GC、反射等功能。
IL2CPP 有哪些限制? 不能使用 Reflection.Emit 等运行时代码生成;值类型的泛型实例需要在编译期出现过;通过反射使用的代码可能被裁剪。
代码裁剪会导致什么问题?怎么解决? 通过反射才使用的类型和方法会被误删,运行时报错。用 link.xml 或 Preserve 特性保留,或者降低裁剪级别。
IL2CPP 包崩溃了怎么定位? 保留打包生成的符号文件,上传到崩溃收集平台,把原生地址还原成方法名和行号。
怎么做自动化打包? 编写静态的打包方法,用 Unity 命令行的 batchmode 和 executeMethod 调用;在 CI 中串联导表、生成代码、打资源、打安装包、上传、通知等步骤,打包机缓存 Library 并固定环境。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!