AssetBundle 原理与打包策略:文件结构、压缩、加载、依赖与冗余
AssetBundle 在热更新中的使用,以及基于它的 YooAsset、Addressables,见 热更新;内存与卸载见 Unity 内存构成;加载策略见 资源加载与管理。本文讲 AssetBundle 本身的机制。
一、AssetBundle 是什么
AssetBundle(下文简称 AB)是 Unity 的资源打包格式:把一组资源(Prefab、贴图、材质、音频、场景等)序列化成一个文件,运行时可以从本地或网络加载,再从中取出资源。
它解决的问题:
- 资源可以不放在安装包里,按需下载,减小包体;
- 资源可以热更新,不用重新发包;
- 按需加载和卸载,控制内存。
AB 是平台相关的:为 Android 打的包不能在 iOS 上使用,每个平台要单独构建。
二、文件结构
AssetBundle 文件├── 文件头 格式标识、版本号、构建它的 Unity 版本、文件大小├── 块信息与目录 数据被分成哪些块、每块如何压缩;包里有哪些文件(可能本身被压缩)└── 数据块 ├── 序列化文件(CAB-xxxx) 资源对象本身:GameObject、组件、材质参数等,以及类型信息(TypeTree) ├── .resS 文件 大块的原始数据:贴图像素、网格顶点等 └── .resource 文件 音频、视频数据几个要点:
- 序列化文件中保存的是对象的数据。对象之间的引用记录为”哪个文件中的第几个对象”,跨 AB 的引用就是这样指向另一个包的。
- TypeTree 描述每种类型的字段结构,用于在不同 Unity 版本之间兼容地读取数据。可以通过构建选项不写入 TypeTree,让包更小、加载更快,但之后升级 Unity 版本时,旧的包可能无法读取,要谨慎使用。
- 贴图、网格的原始数据放在
.resS中,加载时可以直接从文件流式读取,不必全部先读进内存。
三、压缩方式
| LZMA | LZ4 | 不压缩 | |
|---|---|---|---|
| 构建选项 | 默认(None) | ChunkBasedCompression | UncompressedAssetBundle |
| 压缩方式 | 整个数据作为一个整体压缩 | 按块(chunk)分别压缩 | 不压缩 |
| 文件大小 | 最小 | 中等 | 最大 |
| 加载时 | 必须先解压整个包,才能读取其中任意资源 | 只解压需要读取的那几块 | 直接读取 |
| 加载速度 | 慢 | 快 | 最快 |
| 内存 | 解压时需要额外内存 | 低 | 低 |
| 适合 | 网络传输 | 本地存储、运行时加载 | 对速度要求极高且不在乎大小 |
为什么 LZ4 可以只解压一部分:LZMA 把整个数据流作为一个整体压缩,要读其中某个位置,必须从头解压到那里。LZ4 是分块独立压缩的,读取某个资源时只需要找到它所在的块,单独解压这些块即可。
常见做法:下载用 LZMA,本地存 LZ4
- 网络传输时,LZMA 体积小,下载快、省流量;
- 下载完成后,在本地重新压缩为 LZ4(
AssetBundle.RecompressAssetBundleAsync,或者使用UnityWebRequestAssetBundle配合 Unity 的缓存系统,它会自动转换),之后的每次加载都更快。
不想处理转换的项目,直接全部使用 LZ4 是最省心的选择,YooAsset 等框架默认也推荐 LZ4。
四、加载方式
加载 AB 本身
| API | 说明 | 内存与性能 |
|---|---|---|
AssetBundle.LoadFromFile(Async) | 从本地文件加载 | 最推荐。对 LZ4 和不压缩的包,只读取文件头和目录,资源数据在需要时再从磁盘读取。LZMA 包会被完整解压到内存中 |
AssetBundle.LoadFromMemory(Async) | 从内存中的 byte[] 加载 | 托管内存中的字节数组和 Unity 内部的副本同时存在,峰值内存约为包大小的两倍。仅在数据只能以字节数组形式拿到时使用 |
AssetBundle.LoadFromStream(Async) | 从自定义的 Stream 加载 | 按需从流中读取,内存友好。适合加密的包:在 Stream 中边读边解密 |
UnityWebRequestAssetBundle.GetAssetBundle | 从网络下载并加载 | 可以配合版本号或哈希使用 Unity 的缓存系统,下次直接从缓存加载 |
简单的加密:LoadFromFile(path, crc, offset) 支持跳过文件开头的若干字节。打包后在文件头部插入一段无用数据,可以让常见的解包工具无法直接识别;更强的加密需要用 LoadFromStream 配合自定义的解密流。YooAsset 的加密接口见 热更新。
从 AB 中加载资源
var bundle = AssetBundle.LoadFromFile(path);
var prefab = bundle.LoadAsset<GameObject>("Hero"); // 按名字加载单个资源var all = bundle.LoadAllAssets(); // 加载包中的所有资源var sprites = bundle.LoadAssetWithSubAssets<Sprite>("Icons"); // 加载一张图集贴图中的所有 Sprite
// 场景包:加载 AB 后,直接用场景名加载场景SceneManager.LoadSceneAsync("Level01");都有对应的异步版本,游戏运行中应该使用异步版本(见 同步与异步)。
两个开销要分清
1. 加载 AB: 打开文件、读取文件头和目录 → 内存中有一个 AssetBundle 对象2. 加载资源: 从 AB 中反序列化具体的资源对象 → 内存中有了 Texture、GameObject 等- 只加载 AB 不加载资源,占用的内存很小(LZ4 时)。
bundle.Unload(false)只释放第 1 部分,已经加载出来的资源仍然在内存中(见 Unload 的两个参数)。
五、依赖
依赖是怎么产生的
资源 A 引用了资源 B(比如 Prefab 引用了材质),而它们被打进了不同的包,A 所在的包就依赖 B 所在的包。
构建时 Unity 会生成一个总的 Manifest,记录每个包依赖了哪些包:
var manifestBundle = AssetBundle.LoadFromFile(Path.Combine(root, platformName));var manifest = manifestBundle.LoadAsset<AssetBundleManifest>("AssetBundleManifest");
string[] deps = manifest.GetAllDependencies("ui/shop"); // 所有依赖,包括依赖的依赖加载顺序
从一个包中加载资源之前,它依赖的所有包都必须已经加载。 否则资源中引用的材质、贴图会丢失(显示为紫色或空白)。
至于这些包之间谁先加载,顺序无所谓,只要在加载资源之前都加载完即可。
卸载与引用计数
一个公共的包(比如通用 UI 图集)会被很多包依赖。只有当所有依赖它的包都不再使用时,才能卸载它。这就需要给每个包维护引用计数:
加载 ui/shop: ui/shop +1,ui/common +1加载 ui/bag: ui/bag +1,ui/common +1 ← ui/common 计数为 2关闭商店: ui/shop -1 → 卸载;ui/common -1 → 还剩 1,不卸载关闭背包: ui/bag -1 → 卸载;ui/common -1 → 0,卸载这正是 YooAsset、Addressables 等框架帮我们做的事情。
循环依赖
包 A 依赖包 B,包 B 又依赖包 A。Unity 允许这种情况,但会让引用计数和卸载变得复杂:两个包互相持有,计数永远不会归零。应该通过调整打包规则消除,通常是把双方共同引用的资源抽到一个公共包中。
六、打包策略
打包粒度
| 包太小(比如每个资源一个包) | 包太大(比如一个模块一个包) | |
|---|---|---|
| 问题 | 包的数量多,每个包都有固定开销(文件句柄、文件头、目录、元数据),依赖关系复杂,加载时要打开很多文件 | 用到其中一个资源,就要加载整个包;更新一个资源,整个包都要重新下载 |
| 卸载 | 灵活 | 包中只要有一个资源还在用,整个包都不能卸载 |
没有统一的标准,原则是:一起使用的资源打在一起,独立使用的资源分开。常见经验是单个包控制在几百 KB 到几 MB 之间,并结合实际的加载和更新情况调整。
常见的分包方式
| 方式 | 做法 | 举例 |
|---|---|---|
| 按功能模块 | 一个界面或一个系统一个包 | 商店界面、背包界面各一个包 |
| 按场景 / 关卡 | 关卡专用的资源打在一起 | 第 1 关的地图、怪物 |
| 按类型 | 某类全局共享的资源打在一起 | 所有 Shader 一个包;字体一个包 |
| 按更新频率 | 经常变化的资源和稳定的资源分开 | 活动资源、配置表单独打包,更新时下载量小 |
| 公共资源单独打包 | 被多个模块引用的资源抽出来 | 通用按钮、通用图集、公共特效 |
冗余问题
冗余的产生:一个资源被多个包中的资源引用,但它自己没有被指定打进任何一个包,Unity 会把它复制进每一个引用它的包。
商店 Prefab ──引用──▶ 通用按钮贴图(未指定包)背包 Prefab ──引用──▶ 通用按钮贴图(未指定包)
结果:ui/shop 和 ui/bag 中各有一份按钮贴图后果:
- 包体变大;
- 两个界面同时打开时,内存中有两份相同的贴图;
- 两份贴图是两个不同的对象,不能合批。
解决:把被多个包引用的资源明确指定到一个公共包中。
检测:
- 使用 YooAsset、Addressables 自带的构建报告和分析工具,它们会列出被重复打包的资源;
- 自己写编辑器工具:遍历每个包包含的资源,用
AssetDatabase.GetDependencies找出所有依赖,统计哪些未指定包的资源被不止一个包引用; - 用解包工具查看最终的包内容,确认是否有重复。
Shader 与变体
- 所有 Shader 打进一个包,游戏启动时加载,不卸载。Shader 被几乎所有材质引用,分散打包很容易造成冗余。
- 变体问题:使用
shader_feature声明的关键字,只会为打包时能找到的材质实际用到的组合生成变体。Shader 单独打包时,其他包中材质用到的组合可能没有被生成,运行时就会显示异常。常用的做法是创建一个 ShaderVariantCollection,把需要的变体显式收集进去,和 Shader 打在同一个包中。 - 加载完成后可以用
ShaderVariantCollection.WarmUp预热,避免首次使用时编译卡顿(见 资源加载与管理)。
图集
- 图集和它包含的 Sprite 应该打在同一个包中。如果 Sprite 分散在不同的包里,每个包都可能带上一份图集贴图,造成冗余。
- 图集按界面或模块划分,避免一个界面只用了几个小图标,却要加载一整张大图集(见 Sprite Atlas)。
场景
场景只能单独打包:一个场景包中只能包含场景,不能同时包含其他资源。场景中引用的资源可以单独打包,作为场景包的依赖。
七、构建
两种构建管线
| 内置管线 | 可编程构建管线(SBP) | |
|---|---|---|
| 接口 | BuildPipeline.BuildAssetBundles | Scriptable Build Pipeline 包 |
| 特点 | 简单,可定制性低 | 构建过程可定制,增量构建更快更可靠 |
| 使用者 | 早期项目 | Addressables、YooAsset 都基于它 |
为什么资源没改,包的哈希却变了
热更新依靠哈希判断包是否变化。如果哈希无故改变,玩家就会重复下载没有变化的包。常见原因:
- 依赖的资源变了:一个材质改了,引用它的 Prefab 所在的包内容也可能变化。
- Unity 版本变化:序列化格式、TypeTree 有差异。
- Shader 编译结果变化:编译器版本、变体收集的结果不同。
- 构建过程不确定:比如资源的顺序、某些编辑器中自动生成的数据每次不同。
应对:
- 正式发布期间固定 Unity 版本和构建环境;
- 使用 SBP 等更确定的构建流程;
- 比较的是包的内容哈希,而不是文件的修改时间;
- 发布前对比新旧清单,检查哪些包变化了,确认变化是否合理。
CRC 校验
构建时会为每个包生成 CRC。下载后、加载时可以校验 CRC,发现文件损坏(下载不完整、被篡改)时删除重新下载。
八、常见问题
| 现象 | 可能的原因 |
|---|---|
| 资源显示为紫色 | 材质的 Shader 丢失:Shader 所在的包没加载;或者变体缺失;或者包是用错误的平台构建的 |
| 贴图、材质丢失 | 依赖的包没有在加载资源之前加载 |
| 内存中有两份同样的资源 | 冗余打包;或者 Unload(false) 后再次加载了同一个包 |
| 正在显示的资源突然丢失 | 调用了 Unload(true),或者依赖的包被提前卸载 |
| 报错”包已经加载” | 同一个包不能同时加载两次,需要先卸载,或者复用已经加载的实例 |
| 更新时下载量远大于改动量 | 打包粒度太大,或者哈希无故变化 |
常见追问
AssetBundle 的压缩方式有哪些?有什么区别? LZMA:整体压缩,体积最小,加载时必须整包解压,慢且耗内存。LZ4:分块压缩,加载时只解压需要的块,速度快、内存低。不压缩:最大但最快。常见做法是下载用 LZMA,本地转成 LZ4,或者直接全部用 LZ4。
LoadFromFile、LoadFromMemory、LoadFromStream 有什么区别? LoadFromFile 直接从文件读取,只读取需要的部分,最推荐;LoadFromMemory 需要先把整个包读进字节数组,内存中会同时存在两份;LoadFromStream 从自定义流中按需读取,适合边读边解密。
AB 的依赖怎么处理? 通过 Manifest 获取依赖列表,在从包中加载资源之前加载所有依赖的包。用引用计数管理,所有使用者都释放后才卸载被依赖的包。
什么是资源冗余?怎么解决? 被多个包引用、但没有指定打进任何包的资源,会被复制进每个引用它的包。导致包体变大、内存中存在多份、无法合批。解决办法是把公共资源指定到公共包中,并用分析工具检测。
AB 的打包粒度怎么把握? 包太小,数量多、固定开销大、依赖复杂;包太大,加载和更新都会带上不需要的资源。原则是一起使用的打在一起,按功能、场景、类型、更新频率划分,公共资源单独打包。
Shader 应该怎么打包? 所有 Shader 放在一个包里,启动时加载且不卸载;用 ShaderVariantCollection 收集需要的变体,避免变体缺失;加载后预热。
资源显示紫色是什么原因? Shader 丢失或变体缺失,或者使用了其他平台构建的包。
为什么资源没改,AB 的哈希也变了? 依赖资源变化、Unity 版本变化、Shader 编译结果变化、构建过程不确定等。要固定构建环境,使用更确定的构建管线,并在发布前对比清单。
Unload(true) 和 Unload(false) 的区别?
false 只卸载包本身,已加载的资源保留,但再次加载同一个包会产生重复的资源;true 连同加载出来的资源一起卸载,正在使用的资源会丢失。项目中用引用计数管理,确认无人使用后再 Unload(true)。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!