游戏引擎 / 系统课时
AssetBundle 查重复依赖
AssetBundle 查重复依赖
两个不同 AssetBundle 引用同一份未显式归包的资源时,Unity 可能把它复制进两个包,增加下载体积;若两个包同时加载,还可能增加驻留内存。本课通过编辑器依赖扫描定位疑点,再用实际构建报告确认,并判断把资源拆成共享包是否值得。
学习目标
- 区分正常的跨包依赖与隐式资源重复打包。
- 在 Unity 6 中运行脚本,列出被多个 AssetBundle 隐式引用的资源。
- 用构建体积和内存数据验证分包调整的收益。
复现重复依赖
以 Unity 6(6000.x)的原生 AssetBundle 工作流为例:准备两个含 MeshRenderer 的预制体 Hero.prefab、Enemy.prefab,都使用 Assets/Game/Shared/Body.mat;将 Assets/Game/Shared/Base.png 设为该材质的纹理(URP Lit 的 Base Map,或 Built-in Standard 的 Albedo)。在 Inspector 底部的 AssetBundle 下拉框中,将两个预制体分别归入 character-hero、character-enemy,材质和贴图保持 None。
构建时,两个预制体各自的依赖会被收集。由于材质和贴图没有归包,它们可能分别进入 character-hero 与 character-enemy。这不是两个包都依赖同一个共享包,而是相同源资源被构建成两份内容。

扫描未归包的公共资源
将下列完整编辑器脚本保存为 Assets/Editor/AssetBundleDuplicateAudit.cs。它对每个显式归包的资源逐层遍历依赖,遇到已显式归入其他 Bundle 的资源就停止向下遍历,避免把正常跨包依赖误判为隐式打包;再找出被两个及以上包引用的未归包资源。
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using UnityEditor;
using UnityEngine;
public static class AssetBundleDuplicateAudit
{
[MenuItem("Tools/AssetBundles/Scan Implicit Dependencies")]
private static void Scan()
{
var owners = new SortedDictionary<string, HashSet<string>>(StringComparer.OrdinalIgnoreCase);
foreach (var bundle in AssetDatabase.GetAllAssetBundleNames())
{
var visited = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
foreach (var root in AssetDatabase.GetAssetPathsFromAssetBundle(bundle))
{
var pending = new Stack<string>(AssetDatabase.GetDependencies(root, false));
while (pending.Count > 0)
{
var path = pending.Pop();
if (!visited.Add(path) ||
!path.StartsWith("Assets/", StringComparison.OrdinalIgnoreCase))
continue;
var importer = AssetImporter.GetAtPath(path);
// 显式归包的资源由其所属 Bundle 收集,不能继续按当前包展开。
if (importer == null || !string.IsNullOrEmpty(importer.assetBundleName))
continue;
if (path.EndsWith(".cs", StringComparison.OrdinalIgnoreCase) ||
path.EndsWith(".asmdef", StringComparison.OrdinalIgnoreCase))
continue;
if (!owners.TryGetValue(path, out var bundles))
owners[path] = bundles = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
bundles.Add(bundle);
foreach (var dep in AssetDatabase.GetDependencies(path, false))
pending.Push(dep);
}
}
}
var repeated = owners.Where(x => x.Value.Count > 1).ToArray();
foreach (var item in repeated)
Debug.Log($"{item.Key} <= {string.Join(", ", item.Value.OrderBy(x => x))}");
Debug.Log($"Implicit dependency candidates: {repeated.Length}");
}
[MenuItem("Tools/AssetBundles/Build For Audit")]
private static void Build()
{
const string output = "AssetBundles/Audit";
Directory.CreateDirectory(output);
// 使用当前编辑器的目标平台和 LZ4 分块压缩构建。
var manifest = BuildPipeline.BuildAssetBundles(
output, BuildAssetBundleOptions.ChunkBasedCompression,
EditorUserBuildSettings.activeBuildTarget);
if (manifest == null)
{
Debug.LogError("AssetBundle build failed");
return;
}
Debug.Log($"AssetBundles built: {manifest.GetAllAssetBundles().Length}");
}
}在 Tools > AssetBundles > Scan Implicit Dependencies 执行扫描。只有上面的两个角色包、两个共享资源时,Console 预期输出为:
Assets/Game/Shared/Base.png <= character-enemy, character-hero
Assets/Game/Shared/Body.mat <= character-enemy, character-hero
Implicit dependency candidates: 2这份扫描基于 AssetImporter.assetBundleName 的归包设置,适用于 Inspector 分包;若工程改用 AssetBundleBuild[] 动态构建映射,需要按构建映射改写输入。它只覆盖 Assets/ 下的项目资源,且依赖引用不一定全部进入最终包,因此输出是疑似重复清单,不是已占用字节数。
用构建报告确认实际内容
- 执行
Tools > AssetBundles > Build For Audit,生成AssetBundles/Audit下当前目标平台的文件。仅有两个角色包时,Console 预期还会显示AssetBundles built: 2。 - 从 Unity Build Report Inspector 仓库 获取工具,在
Window > Package Manager中通过 Add package from disk 选择其com.unity.build-report-inspector/package.json。安装后打开Window > Open Last Build Report,进入 Duplicated Assets 页签并点击 Calculate,核对同一源资源是否出现在两个 AssetBundle 中。 - 记录报告显示的重复资源、所属包和重复内容大小,并分别记录构建前后输出目录中实际 Bundle 文件的字节数。报告里的重复资源大小通常是压缩前统计,不能直接当成 CDN 下载量。
Library/LastBuild.buildreport 对应最近一次构建,连续对比时应保存修复前报告。AssetBundleManifest.GetAllDependencies() 查询的是包与包之间的依赖,并不会列出没有显式归包、已被复制进各包的材质或贴图,不能代替重复内容检查。
拆共享包并衡量代价
把 Body.mat 与 Base.png 都通过 Inspector 的 AssetBundle 字段归入 character-shared,重新构建。此时 character-hero 和 character-enemy 应依赖 character-shared;加载任一角色预制体前,先加载依赖包,且在仍被引用时不要提前卸载它。重新扫描应不再报告这两个隐式重复候选,构建报告的重复量也应下降。
对下载体积,比较同一目标平台、相同压缩选项下的所有需要分发的 Bundle 总和,而不是只看角色包缩小了多少。例如:
| 对照 | 角色 A | 角色 B | 共享包 | 合计 |
|---|---|---|---|---|
| 调整前(假设值) | 12 MiB | 10 MiB | 无 | 22 MiB |
| 调整后(假设值) | 9 MiB | 7 MiB | 3 MiB | 19 MiB |
若玩家最终下载两个角色包,示例节省 3 MiB,约 13.6%;若只需角色 A,拆包前后都下载约 12 MiB,还可能多一次请求。小资源不一定值得单独拆包,需同时考虑请求数、缓存复用和更新粒度。
对内存,假设同一张 1024×1024、RGBA32、无 mipmap 的贴图在目标平台保持该格式,单份像素数据约为 4 MiB。两个角色包各持有独立副本并同时加载时约占 8 MiB;共享后只需一份,约为 4 MiB。这只是纹理像素的估算,不含其他内存开销;应在同一设备上加载两个角色,用 Memory Profiler 快照确认实际驻留和引用链。
修复验收至少满足三项:重复清单与构建报告不再出现目标资源的双份拷贝、累计实际下载字节下降或拆包代价可接受、两个角色同时加载及卸载时没有丢失材质引用。