游戏引擎 / 系统课时

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 的资源就停止向下遍历,避免把正常跨包依赖误判为隐式打包;再找出被两个及以上包引用的未归包资源。

csharp
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 预期输出为:

text
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/ 下的项目资源,且依赖引用不一定全部进入最终包,因此输出是疑似重复清单,不是已占用字节数。

用构建报告确认实际内容

  1. 执行 Tools > AssetBundles > Build For Audit,生成 AssetBundles/Audit 下当前目标平台的文件。仅有两个角色包时,Console 预期还会显示 AssetBundles built: 2。
  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 中。
  3. 记录报告显示的重复资源、所属包和重复内容大小,并分别记录构建前后输出目录中实际 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 快照确认实际驻留和引用链。

修复验收至少满足三项:重复清单与构建报告不再出现目标资源的双份拷贝、累计实际下载字节下降或拆包代价可接受、两个角色同时加载及卸载时没有丢失材质引用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

AssetBundle 查重复依赖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通