游戏引擎 / 系统课时

检查首包体积与资源冗余

检查首包体积与资源冗余

Unity 项目的首包突然增大时,不能只凭 Assets 文件夹大小判断原因。本课通过构建报告定位体积较大的资源,再检查场景、Resources 和 Addressables 的依赖关系,找出不必要的打包内容,并用相同构建条件验证优化效果。

学习目标

  • 区分工程资源大小、构建输出大小和用户实际下载体积。
  • 使用 Unity BuildReport 定位占用空间较大的打包资源。
  • 识别重复依赖与多余资源,选择正确的优化方法并验证结果。

建立可比较的首包基线

首包是用户首次安装或启动游戏时必须获得的内容。它不一定等于整个项目资源目录,也不一定等于所有未来可下载内容的总和。

例如,Windows 桌面发布可能包含可执行文件、运行时组件和资源数据;Android 商店分发可能使用 AAB,并根据设备生成安装内容。远程 Addressables 资源则可能在首次运行之后单独下载。

因此,进行体积优化前,必须先固定统计口径。

统计对象 含义 注意事项
Assets 目录 工程中的源资源 包含未引用资源,不等于发布体积
BuildReport 构建结果与打包资源信息 适合定位构建贡献来源
实际构建产物 平台输出文件 包含引擎、代码和资源等内容
用户下载包 分发平台实际提供的内容 可能经过压缩、拆分或设备定制
远程资源 首包之外的下载内容 需要单独衡量下载与缓存成本

建议首先完成一次正式构建,记录 Unity 版本、目标平台、构建配置、资源压缩策略、脚本裁剪设置、构建结果大小和资源下载方式。

后续每次优化都使用相同条件重新构建。不要把 Development Build 与正式发布版直接比较,也不要把未压缩目录大小与商店下载大小当作同一指标。

从 BuildReport 找出体积热点

Unity 的 BuildReport 能提供构建结果和打包资源信息。其中 summary.totalSize 是构建输出大小的统计值,packedAssets 包含资源在打包文件中的记录。

先通过 Unity 正常完成一次 Player 构建,再创建 Assets/Editor/BuildSizeAudit.cs。下面的脚本读取最近一次构建报告,按资源源路径汇总体积,并显示占用较大的十项资源。

csharp
using System;
using System.Linq;
using UnityEditor;
using UnityEditor.Build.Reporting;
using UnityEngine;

public static class BuildSizeAudit
{
    [MenuItem("Tools/Build/Inspect Last Build Size")]
    private static void Inspect()
    {
        var report = BuildReport.GetLatestReport();

        // 只分析成功构建的报告,避免误读失败构建的数据。
        if (report == null || report.summary.result != BuildResult.Succeeded)
        {
            Debug.LogWarning("No successful build report.");
            return;
        }

        Debug.Log($"Build total: {report.summary.totalSize} bytes");

        // 同一源资源可能出现在多个打包文件中,因此同时统计文件数量。
        var largest = report.packedAssets
            .SelectMany(pack => pack.contents.Select(asset => new
            {
                pack.shortPath,
                asset.sourceAssetPath,
                asset.packedSize
            }))
            .Where(item => !string.IsNullOrEmpty(item.sourceAssetPath))
            .GroupBy(item => item.sourceAssetPath)
            .Select(group => new
            {
                Path = group.Key,
                Bytes = group.Sum(item => (decimal)item.packedSize),
                PackedFiles = group.Select(item => item.shortPath).Distinct().Count()
            })
            .OrderByDescending(item => item.Bytes)
            .Take(10);

        foreach (var item in largest)
        {
            Debug.Log($"{item.Bytes} bytes | {item.PackedFiles} files | {item.Path}");
        }
    }
}

在完成 Player 构建之后执行 Tools > Build > Inspect Last Build Size。

预期输出格式如下,实际字节数、打包文件数量和资源路径取决于工程内容:

text
Build total: <BYTES> bytes
<BYTES> bytes | <COUNT> files | Assets/<PATH>

脚本最多输出十项资源。如果没有可分析的源资源条目,则只显示构建总大小。没有成功的最近构建报告时会输出:

text
No successful build report.

GetLatestReport() 读取最近一次 Player 或 AssetBundle 构建报告,因此应先完成本次需要分析的 Player 构建,避免分析到其他构建任务的结果。

这里的资源体积是打包记录的汇总值,不能简单等同于压缩后安装包大小。一个资源出现在多个打包文件中也只能作为重复候选,不能据此直接认定存在可以安全删除的重复数据。

找出资源为什么被打进首包

大型资源是否需要优化,首先取决于它为什么进入构建产物。

通常需要检查三类来源:

  • 场景依赖:构建场景直接或间接引用了资源,即使资源只被某个不常访问的对象使用,也可能进入内置场景数据。
  • Resources 目录:资源被放入特殊的 Resources 目录后,可能作为内置资源纳入 Player 构建,即使当前代码没有实际加载它。
  • Addressables 或 AssetBundle 依赖:资源可能被打入独立 Bundle;若多个 Bundle 隐式引用同一依赖,可能产生重复副本。

典型情况是两个 Addressables Group 分别包含不同的角色 Prefab,但两个角色引用同一材质。如果该材质未被明确作为共享 Addressable 依赖组织,打包系统可能把材质分别放进两个 Bundle。

Addressables 隐式重复依赖与共享资源打包对比

如果项目安装了 Addressables,可通过对应版本提供的 Analyze 工具或 Build Layout 报告检查资源打包关系。部分版本提供 Check Duplicate Bundle Dependencies、Check Resources to Addressable Duplicate Dependencies 和 Check Scene to Addressable Duplicate Dependencies 等规则;实际入口和可用规则应以当前安装版本为准。

对于跨 Group 的共享资源,可以根据访问方式将其作为显式共享依赖组织;但这可能增加 Bundle 依赖和额外下载请求。若资源同时被内置场景直接引用和 Addressables 引用,还需要调整场景引用或加载方式,不能指望单纯移动 Group 自动解决所有重复问题。

按资源类型精准缩减体积

确认大资源的用途之后,再进行有针对性的调整。不同资源的主要成本来源并不相同。

资源类型 优先检查 处理方向
Texture 分辨率、格式、Mip Map 使用适合目标平台的纹理压缩和尺寸
AudioClip 长度、声道、压缩格式 选择合适的压缩方式,移除无用音频
Mesh 顶点数量、附加数据 精简不需要的模型属性与细节
Animation 动画片段与导入设置 删除未使用片段,评估动画压缩
Scene 是否属于首次安装必需内容 排除测试场景,按需拆分内容
Video 编码格式与分辨率 压缩视频或按需下载

以纹理为例,在 Inspector 的 Texture Import Settings 中启用目标平台覆盖设置后,可以分别控制桌面和移动平台的最大尺寸与压缩格式。改变导入设置后必须重新构建,观察实际体积和画质变化。

对比优化前后结果并验收

体积优化需要同时满足资源完整、运行正常和交付大小下降三个条件。建议一次只修改一类资源或一组依赖,保证出现问题时能够定位具体原因。

可以按以下流程完成一次验收:

  1. 保存优化前的 BuildReport 和实际构建产物大小。
  2. 确认目标资源进入首包的依赖路径,记录修改原因。
  3. 修改资源导入设置、场景引用或 Addressables Group 布局。
  4. 在相同目标平台和构建选项下重新完成正式构建。
  5. 对比输出文件大小和打包资源条目,检查是否出现新的重复依赖。
  6. 在目标设备上测试资源加载、场景切换、声音播放和离线功能。

如果构建报告中的某张纹理体积下降,但最终下载包大小变化不明显,应进一步检查代码与引擎运行时开销、其他资源占比、压缩差异和平台封装方式。

如果把资源移到远程 Bundle 后首包明显变小,还应记录首次进入相关场景的额外下载量。首包缩减并不代表总下载成本一定下降。

可以使用以下记录格式比较同口径的构建结果:

指标 优化前 优化后
构建目标 相同平台 相同平台
构建模式 Release Release
构建输出大小 实测记录 实测记录
最大资源体积 实测记录 实测记录
重复依赖候选 检查记录 复查记录
功能验证 通过 必须通过

真正有效的体积优化,是在不破坏游戏内容和资源加载行为的前提下,减少不必要的首次交付数据。坚持先通过报告定位,再依据依赖关系修改,最后用相同构建条件复测,才能确认优化是否具有实际价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查首包体积与资源冗余

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

登录哪都通