IL2CPP 与打包:编译流程、AOT 限制、代码裁剪与自动化构建

2004 字
10 分钟
IL2CPP 与打包:编译流程、AOT 限制、代码裁剪与自动化构建

一、Mono 与 IL2CPP#

C# 代码首先被编译成 IL(中间语言),存放在 dll 中。运行时怎么执行 IL,Unity 提供了两种脚本后端:

MonoIL2CPP
执行方式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#(见 反射与生成代码)。

保留的方法:

Assets/link.xml
<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 ConfigurationDebug / Release / Master。Master 优化最充分、构建最慢,用于正式发布
IL2CPP Code Generation优化运行速度,或者优化构建时间和包体(使用更多的泛型共享)
Script Debugging允许连接调试器,会降低性能,正式包关闭

崩溃排查:IL2CPP 包崩溃时,调用栈是原生代码的地址。需要保留打包时生成的符号文件,上传到崩溃收集平台,才能把地址还原成 C# 的方法名和行号。

六、自动化打包#

手动在编辑器中打包,步骤多、容易出错、占用开发者的机器。项目通常会搭建自动化打包。

命令行打包#

Assets/Editor/BuildScript.cs
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 知道构建失败
}
}
Terminal window
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 并固定环境。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

IL2CPP 与打包:编译流程、AOT 限制、代码裁剪与自动化构建
https://xslab.cloud/posts/unity/il2cpp-and-build/
作者
LuxFire
发布于
2026-10-14
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
ECS 与 DOTS:面向数据的设计、Archetype 与 Chunk、Job System 与 Burst
Unity底层/引擎进阶 传统 GameObject 和 MonoBehaviour 在大量对象时的性能瓶颈;ECS 的实体、组件、系统;为什么面向数据的内存布局对 CPU 缓存友好;Unity Entities 的 Archetype、Chunk 与结构性改变;Job System 的并行与安全检查;Burst 编译器;以及 ECS 的适用场景、代价,与其他 ECS 框架的区别。
2
Unity 与原生交互:Android(Java/Kotlin)与 iOS(Objective-C)的双向调用
Unity底层/引擎进阶 什么时候需要和原生代码交互;Android 上 AndroidJavaClass、AndroidJavaObject 调用 Java,Java 通过 UnitySendMessage 或 AndroidJavaProxy 回调 C#;iOS 上用 DllImport 调用 Objective-C,用函数指针或 UnitySendMessage 回调;字符串的传递与内存;线程问题;平台条件编译;以及 SDK 封装的实践。
3
UGUI 性能优化:Canvas 重建、合批与过度绘制
Unity性能优化 UGUI 的性能问题来自哪里:Canvas 的 Rebuild 与 Rebatch、UI 合批规则、过度绘制和射线检测。以及动静分离、图集、Mask 选择、显隐方式、长列表等常用优化手段。
4
AssetBundle 原理与打包策略:文件结构、压缩、加载、依赖与冗余
Unity底层/资源与内存 AssetBundle 的文件里有什么;LZMA、LZ4、不压缩三种方式在大小、速度、内存上的差异;LoadFromFile、LoadFromMemory、LoadFromStream 等加载方式的区别;依赖的加载顺序与卸载;打包粒度、公共资源、Shader 与图集的打包策略和冗余检测;构建管线与哈希变化;以及常见面试题。
5
Unity 粒子系统与特效优化:模块、渲染模式、VFX Graph 与性能
Unity底层/渲染 粒子系统(Shuriken)的工作方式与常用模块;渲染模式与排序;模拟空间、预热与对象池化;粒子系统与 VFX Graph 的区别;特效的主要性能问题(过度绘制、粒子数、模块开销、批次)与优化方法;以及特效制作规范。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录