01-03-认知篇-基础-Unity原生AssetBundle全面解析

Unity 原生 AssetBundle 全面解析

篇章 ：01-认知篇 · 基础 阅读时间 ：约 30 分钟 前置知识：了解 Unity 基本资源加载方式

---

一、引言

在 Unity 游戏开发中，AssetBundle（简称 AB 包）是资源管理的基石。它是 Unity 官方提供的资源打包格式，允许开发者将资源打包成独立的文件，实现按需加载、热更新和增量更新。

本章将深入解析 AssetBundle 的核心概念、打包流程、加载机制、内存管理以及最佳实践。理解这些底层知识，是掌握后续所有资源管理方案（包括 Addressables 和 YooAsset）的基础。

---

二、AssetBundle 核心概念

2.1 什么是 AssetBundle？

AssetBundle 是 Unity 提供的一种资源打包格式。简单来说，它就是一个包含一个或多个资源的容器文件，扩展名为 .assetbundle（或 .assets）。每个 AssetBundle 文件可以包含任意类型的 Unity 资源：模型、贴图、材质、音频、视频、预制体、场景等。

AssetBundle 的核心价值在于它将资源从游戏主包中分离出来，使得资源可以独立于游戏代码进行分发、加载和更新。这种分离带来了三个关键能力：

1. 按需加载：游戏启动时只加载核心资源，其他资源在需要时再加载，大幅缩短启动时间
2. 热更新：运行时可以下载新的 AssetBundle 替换旧资源，实现不停机更新
3. 增量更新：只更新发生变化的资源文件，减少用户下载量

2.2 Bundle 与 Asset 的关系

理解 AssetBundle 的关键在于理解 Bundle 和 Asset 这两个核心概念的关系：

Asset（资源） ：是具体的资源文件，如一个 .fbx 模型文件、一个 .png 贴图文件、一个 .prefab 预制体等。每个 Asset 在 Unity 编辑器中都有唯一的 GUID（全局唯一标识符）。

Bundle（包）：是 Asset 的容器。一个 Bundle 可以包含一个或多个 Asset。Bundle 本身不包含任何业务逻辑，它只是一个资源容器。

一个 Bundle 中的 Asset 可以分为两类：

• 主资源（Main Asset） ：Bundle 中第一个被列出的资源，可以通过 AssetBundle.mainAsset 直接访问
• 子资源（Sub Asset） ：Bundle 中除主资源外的其他资源，需要通过 AssetBundle.LoadAsset() 按名称或类型加载

2.3 AssetBundle 的文件结构

一个 AssetBundle 文件在磁盘上的结构如下：

AssetBundle 文件结构
├── 文件头（File Header）
│   ├── 签名标识（Signature）：标识文件类型和版本
│   ├── 文件版本（Version）：AssetBundle 格式版本
│   ├── 压缩方式（Compression）：LZMA / LZ4 / 无压缩
│   └── 文件大小（File Size）：整个文件的字节数
├── 资源数据块（Asset Data Blocks）
│   ├── Asset 1 数据：资源原始数据 + 序列化信息
│   ├── Asset 2 数据
│   └── ...
├── 依赖信息（Dependency Information）
│   ├── 依赖 Bundle 列表
│   └── 依赖 Bundle 的 CRC 校验值
└── 资源清单（Asset Manifest）
    ├── 资源名称列表
    ├── 资源偏移量
    └── 资源类型信息

压缩方式详解：

• LZMA 压缩：压缩率最高（通常可减少 60-80% 体积），但解压速度慢，适合网络传输场景
• LZ4 压缩：压缩率适中（约 40-60%），解压速度极快，适合运行时加载场景
• 无压缩：体积最大，但加载速度最快，适合本地存储且对加载速度要求极高的场景

---

三、AssetBundle 打包流程

3.1 资源准备

在打包之前，需要为每个资源设置 AssetBundle 标签。这是原生 AB 包打包的第一步，也是最容易出错的一步。

在 Unity 编辑器中，选中一个资源，在 Inspector 面板底部可以找到 AssetBundle 设置项：

• Bundle Name ：指定该资源所属的 Bundle 名称。例如 ui、characters、audio 等
• Variant：可选的变体标签，用于同一 Bundle 的不同变体（如高清/标清版本）

最佳实践：

• 为每个 Bundle 名称添加前缀，避免命名冲突，如 ui/sprite、ui/prefab
• 使用统一的命名规范，如 模块名/资源类型
• 避免单个 Bundle 包含过多资源，建议每个 Bundle 不超过 100 个资源

3.2 依赖分析

AssetBundle 打包时，Unity 会自动分析资源之间的依赖关系。例如，一个 Prefab 可能引用了多个纹理和材质，这些被引用的资源也需要被打入 Bundle 中。

Unity 提供了 BuildPipeline.CollectDependencies() 方法来获取某个资源的完整依赖树。在打包时，Unity 会自动处理这些依赖，但开发者需要确保依赖关系正确。

常见的依赖问题：

• 共享资源：多个 Bundle 中的资源引用了同一个纹理。如果这个纹理没有被正确共享，会导致重复打包，增加安装包体积
• 循环依赖：Bundle A 引用 Bundle B，Bundle B 又引用 Bundle A。这会导致打包失败或运行时加载异常
• 隐式依赖：某些资源之间的依赖关系不是通过 Unity 的引用系统建立的，而是通过代码动态加载的。这些隐式依赖需要开发者手动处理

3.3 执行打包

Unity 提供了 BuildPipeline.BuildAssetBundles() 方法来执行打包。这是 AB 包打包的核心 API：

using UnityEditor;
using UnityEngine;

public class AssetBundleBuilder
{
    [MenuItem("Tools/Build All AssetBundles")]
    public static void BuildAllAssetBundles()
    {
        string buildPath = "Assets/AssetBundles";
        string manifestPath = buildPath + "/AssetBundles";

        // 确保输出目录存在
        if (!System.IO.Directory.Exists(buildPath))
        {
            System.IO.Directory.CreateDirectory(buildPath);
        }

        // 执行打包
        AssetBundleManifest manifest = BuildPipeline.BuildAssetBundles(
            buildPath,
            BuildAssetBundleOptions.None,       // 打包选项
            BuildTarget.StandaloneWindows64     // 目标平台
        );

        if (manifest != null)
        {
            Debug.Log("AssetBundle 打包完成！");
            Debug.Log("生成了 " + manifest.assetBundleNames.Length + " 个 Bundle");
        }
    }
}

BuildAssetBundleOptions 常用选项：

• None：默认选项，使用 LZMA 压缩
• UncompressedAssetBundle：不压缩，体积最大但加载最快
• EnableLZ4Compress：使用 LZ4 压缩，适合运行时加载
• ForceRebuildAssetBundle：强制重新打包，忽略缓存
• StrictMode：严格模式，遇到错误时打包失败
• DeterministicAssetBundle：使用资源 GUID 作为文件名，确保跨平台一致性

3.4 打包产物

打包完成后，输出目录会包含以下文件：

• ui.bundle：UI 资源包
• characters.bundle：角色资源包
• audio.bundle：音频资源包
• AssetBundles：Manifest 文件，包含所有 Bundle 的元数据

Manifest 文件是 AssetBundle 系统的核心元数据文件，它记录了：

• 所有 Bundle 的名称和依赖关系
• 每个 Bundle 的 CRC 校验值
• 每个 Bundle 包含的资源列表

---

四、AssetBundle 加载机制

4.1 加载方式概览

Unity 提供了多种加载 AssetBundle 的方式，每种方式适用于不同的场景：

加载方式	适用场景	优点	缺点
LoadFromFile	本地文件加载	简单直接	仅适用于本地
LoadFromCacheOrDownload	网络下载加载	自动缓存	API 已废弃
UnityWebRequestAssetBundle	网络下载加载	功能强大	代码较复杂
AssetBundle.LoadFromMemory	内存中加载	灵活	需要手动管理内存

4.2 本地加载

从本地文件系统加载 AssetBundle 是最简单的方式：

// 方式一：从文件路径直接加载
AssetBundle bundle = AssetBundle.LoadFromFile("Assets/StreamingAssets/ui.bundle");

// 方式二：从 StreamingAssets 目录加载（跨平台兼容）
string path = Application.streamingAssetsPath + "/ui.bundle";
#if UNITY_ANDROID
path = "jar:file://" + Application.dataPath + "!/assets/" + "ui.bundle";
#endif
AssetBundle bundle = AssetBundle.LoadFromFile(path);

// 加载 Bundle 中的资源
GameObject prefab = bundle.LoadAsset<GameObject>("Player");
Instantiate(prefab);

// 卸载 Bundle（注意：这会卸载 Bundle 中的所有资源）
bundle.Unload(false); // false = 保留已加载的资源对象

4.3 网络加载

从网络加载 AssetBundle 需要使用 UnityWebRequest（旧版 WWW API 已被废弃）：

using UnityEngine.Networking;

IEnumerator LoadFromServer(string bundleUrl, string assetName)
{
    string manifestUrl = bundleUrl + "/AssetBundles";
    using (var manifestRequest = UnityWebRequestAssetBundle.GetAssetBundle(manifestUrl))
    {
        yield return manifestRequest.SendWebRequest();

        // 加载 Manifest
        AssetBundleManifest manifest = DownloadHandlerAssetBundle.GetContent(manifestRequest);

        string[] dependencies = manifest.GetAllDependencies("ui");

        // 加载所有依赖 Bundle
        foreach (string dep in dependencies)
        {
            using (var depRequest = UnityWebRequestAssetBundle.GetAssetBundle(bundleUrl + "/" + dep))
            {
                yield return depRequest.SendWebRequest();
            }
        }

        using (var bundleRequest = UnityWebRequestAssetBundle.GetAssetBundle(bundleUrl + "/ui"))
        {
            yield return bundleRequest.SendWebRequest();

            AssetBundle bundle = DownloadHandlerAssetBundle.GetContent(bundleRequest);
            GameObject prefab = bundle.LoadAsset<GameObject>("Player");
            Instantiate(prefab);
        }
    }
}

4.4 依赖加载流程

加载 AssetBundle 时，依赖关系的管理是最复杂的部分。正确的加载流程应该是：

1. 加载 Manifest Bundle（AssetBundles 文件）
2. 解析 Manifest，获取目标 Bundle 的依赖列表
3. 按依赖顺序依次加载所有依赖 Bundle
4. 加载目标 Bundle
5. 从目标 Bundle 中加载具体资源
6. 使用资源
7. 卸载不再需要的 Bundle

依赖加载的关键点：

• 必须先加载依赖 Bundle，再加载目标 Bundle，否则资源加载会失败
• 使用 manifest.GetAllDependencies(bundleName) 获取完整依赖链
• 使用 manifest.GetDirectDependencies(bundleName) 获取直接依赖
• 使用 manifest.GetAllDependencies(bundleName, true) 获取完整依赖树（包括间接依赖）

---

五、AssetBundle 内存管理

5.1 内存模型

理解 AssetBundle 的内存模型是避免内存泄漏的关键。AssetBundle 在内存中有两个层次：

Bundle 元数据层：包含 Bundle 的文件头、资源清单、依赖信息等。这部分数据占用内存较小。

资源数据层：包含 Bundle 中所有实际资源的数据（模型网格、纹理像素、音频样本等）。这部分数据占用内存较大。

5.2 Unload 方法详解

AssetBundle.Unload(bool) 方法有一个关键参数：

• Unload(false)：只卸载 Bundle 的元数据层，已加载的资源对象保留在内存中。这是安全的卸载方式，但 Bundle 中的资源无法再通过 AssetBundle 对象访问。
• Unload(true)：卸载 Bundle 的元数据层和资源数据层。如果 Bundle 中的资源仍有引用，这些资源对象会被标记为"已卸载"，访问它们会导致 Missing Reference 错误。

// 安全卸载示例
AssetBundle bundle = AssetBundle.LoadFromFile(path);
GameObject prefab = bundle.LoadAsset<GameObject>("Player");
GameObject instance = Instantiate(prefab);

// 先卸载 Bundle（保留资源对象）
bundle.Unload(false);

// 之后如果需要卸载资源对象，单独处理
Destroy(instance);
Resources.UnloadAsset(prefab); // 卸载预制体引用

5.3 引用计数

Unity 内部使用引用计数来管理 AssetBundle 的内存。每次调用 AssetBundle.LoadFromFile() 或 UnityWebRequestAssetBundle.GetAssetBundle() 时，引用计数加 1。每次调用 AssetBundle.Unload() 时，引用计数减 1。当引用计数为 0 时，Bundle 才会被真正卸载。

引用计数的陷阱：

• 同一个 Bundle 被多次加载时，引用计数会累加
• 即使 Bundle 对象被 GC 回收，引用计数也不会减少
• 必须确保每次 Load 都有对应的 Unload，否则会导致内存泄漏

---

六、AssetBundle 最佳实践

6.1 资源分包策略

合理的资源分包策略是 AssetBundle 使用的核心。以下是一些常见的分包策略：

策略	说明	适用场景
按模块分包	每个功能模块一个 Bundle	大型项目，模块间耦合度低
按类型分包	所有纹理一个 Bundle，所有音频一个 Bundle	小型项目，资源类型少
按场景分包	每个场景的资源一个 Bundle	关卡制游戏
按更新频率分包	频繁更新的资源单独分包	需要频繁热更新的项目
共享资源提取	共享资源单独打包，避免重复	大型项目，资源复用率高

6.2 压缩策略

不同场景下应选择不同的压缩方式：

• 网络传输：使用 LZMA 压缩，减小下载体积
• 本地加载：使用 LZ4 压缩，平衡体积和加载速度
• 首包资源：使用无压缩，确保启动速度

6.3 缓存策略

AssetBundle 加载后应该被缓存，避免重复加载：

• 使用 Caching.LoadFromCacheOrDownload()（旧版）或手动管理缓存
• 缓存键可以使用 Bundle 的 CRC 值或版本号
• 定期清理过期缓存，避免占用过多磁盘空间

6.4 错误处理

AssetBundle 加载过程中可能出现的错误：

• 文件不存在：检查路径是否正确，Bundle 是否已打包
• 依赖缺失：确保依赖 Bundle 已正确加载
• 资源不存在：检查资源名称是否正确，Bundle 中是否包含该资源
• 内存不足：监控内存使用，及时卸载不需要的 Bundle
• 网络超时：设置合理的超时时间，实现重试机制

---

七、AssetBundle 的局限性

尽管 AssetBundle 功能强大，但它存在以下固有局限性：

1. 依赖管理复杂：需要手动处理 Bundle 之间的依赖关系，容易出错
2. 内存管理困难：Unload 操作需要精确控制引用计数，否则会导致 Missing Reference 或内存泄漏
3. 开发成本高：需要编写大量工具代码来处理打包、下载、缓存、版本管理等
4. 调试困难：缺乏可视化的调试工具，排查问题需要手动分析
5. 跨平台差异：不同平台的文件路径和访问方式存在差异，需要额外适配

这些局限性正是 Addressables 和 YooAsset 等高级资源管理方案试图解决的问题。

---

八、总结

本章我们深入解析了 Unity 原生 AssetBundle 的核心概念、打包流程、加载机制和内存管理。AssetBundle 是 Unity 资源管理的基石，理解它的底层原理对于使用任何上层资源管理方案都至关重要。

要点回顾：

• AssetBundle 是 Unity 的资源容器格式，支持按需加载和热更新
• 打包流程包括资源准备、依赖分析、执行打包和产物管理
• 加载方式包括本地加载和网络加载，依赖加载需要按顺序处理
• 内存管理需要精确控制 Unload 操作，避免内存泄漏
• AssetBundle 存在依赖管理复杂、内存管理困难等固有局限性

在下一章中，我们将探讨 Unity 官方推出的 Addressable Assets 方案，了解它如何在 AssetBundle 的基础上提供更高级的抽象。

---

上一篇 ：Unity 资源管理发展史 下一篇：Unity Addressable Assets 全面解析(./01-04-认知篇-基础-Unity Addressable Assets全面解析.md)