游戏引擎 / 系统课时

检查首包体积与启动耗时

检查首包体积与启动耗时

游戏能够上线不代表首次打开足够快。首包文件过大、首屏资源被提前下载或解码、脚本初始化占用主线程,都会延长玩家看到可操作画面的时间。本课以 Cocos Creator 3.8 Web 构建为例,分别测量产物大小、冷启动传输量和启动阶段耗时,再选择真正有效的优化点。

学习目标

  • 区分构建产物体积、首次网络传输量与平台定义的安装包或主包大小。
  • 统计各 Asset Bundle 的文件大小并定位冷启动请求和耗时阶段。
  • 制定一次只改变一个因素的优化方案,用同条件复测验证收益。

先统一统计口径

构建产物总大小是发布目录内所有文件的大小,不等于用户首次下载量。Web 冷启动传输量是空缓存下,进入可操作画面前实际请求并传输的数据;浏览器缓存、压缩编码和懒加载都会改变它。小游戏的主包、分包限制以及原生 APK/IPA 大小,则必须在各自平台工具中另行检查,不能用 Web 目录大小冒充。

将启动终点定义为「首个可见且能响应操作的画面」,而不是 DOMContentLoaded 或页面出现背景色。固定同一发布版本、设备、浏览器、网络条件和缓存策略,连续测量至少三次并比较中位数,同时保留异常慢的一次用于排查。

汇总构建目录的体积

在 Creator「项目 → 构建发布」完成 Web 构建后,通过构建任务的文件夹按钮确认实际输出目录。下面使用 Node.js 内置 API 递归统计文件大小,并按 assets/<Bundle 名> 汇总;没有识别为 Bundle 的文件计入 entry/other。这份报告衡量磁盘上的构建文件大小,不衡量 HTTP 压缩后的传输字节数。

将代码保存为 audit-package.mjs,使用 Node.js 18 或更新版本运行:

js
import { readdir, stat } from 'node:fs/promises';
import { join, relative, resolve, sep } from 'node:path';

const target = process.argv[2];
if (!target) {
    console.error('Usage: node audit-package.mjs <PATH>');
    process.exit(1);
}
const root = resolve(target);
const sizes = new Map();

// 只统计最终发布目录,不把源资源误算为首包。
async function scan(folder) {
    for (const item of await readdir(folder, { withFileTypes: true })) {
        const full = join(folder, item.name);
        if (item.isDirectory()) {
            await scan(full);
            continue;
        }
        // 不沿符号链接递归,避免重复计算外部文件。
        if (!item.isFile()) continue;
        const parts = relative(root, full).split(sep);
        // Bundle 的构建产物通常位于 assets/<名称>/ 下。
        const group = parts[0] === 'assets' && parts.length > 2
            ? `assets/${parts[1]}` : 'entry/other';
        const bytes = (await stat(full)).size;
        sizes.set(group, (sizes.get(group) ?? 0) + bytes);
    }
}

await scan(root);
// 以磁盘字节排序;网络传输大小应在浏览器中单独测量。
const total = [...sizes.values()].reduce((sum, n) => sum + n, 0);
for (const [name, bytes] of [...sizes].sort((a, b) => b[1] - a[1])) {
    console.log(`${name}: ${(bytes / 1048576).toFixed(2)} MiB`);
}
console.log(`TOTAL: ${(total / 1048576).toFixed(2)} MiB`);

在项目目录执行(示例路径需换成实际构建任务生成的目录):

bash
node audit-package.mjs ./build/web-mobile

预期输出格式如下;Bundle 名、行数和体积取决于工程,<SIZE> 表示实际统计值:

text
assets/<BUNDLE>: <SIZE> MiB
entry/other: <SIZE> MiB
TOTAL: <SIZE> MiB

若 assets/main 或 assets/resources 异常大,进一步检查 Included Scenes 的多余场景、resources 内未按需拆分的素材,以及被多个 Bundle 依赖的纹理、音频。不要直接删除构建目录中的文件,应回到资源引用和构建配置修改后重新构建。

还原冷启动的实际耗时

在 Chrome DevTools 的 Network 勾选 Disable cache,保留请求日志后刷新已部署的 Web 包;读取首个可操作画面之前的请求瀑布、传输字节数及等待时间。再用 Performance 录制重新加载,配合截图或帧轨迹识别游戏首屏可见的时刻,并检查主线程是否长时间用于脚本执行、资源解析或场景创建。

首包文件体积、冷启动下载与初始化时间的对应关系

按顺序判断瓶颈:请求瀑布很长,先看文件数、资源体积与服务端压缩和缓存配置;下载已结束但画面迟迟不出现,检查 JSON/纹理解析、脚本执行及大量节点初始化;首屏很快出现但无法点击,说明业务初始化或交互门槛仍未完成。把这三种时间混成一个「加载慢」,往往会优化错位置。

根据瓶颈调整加载范围

优先减少真正位于启动关键路径上的工作。可从 Included Scenes 排除不参与发布的测试场景;只把首屏必须使用的资源放在首批 Bundle 中,将关卡、高清贴图、长音频移到后续 Bundle,进入对应玩法前再加载。注意 resources 会作为内置 Bundle 参与打包,但不意味着其中每个资源都会在启动时立即下载,详见 Asset Bundle 说明。

若成本主要来自纹理传输,按平台评估 WebP 或受支持的 GPU 压缩纹理,检查设备兼容与清晰度;如果主要耗在主线程,则应减少启动时批量实例化、同步计算和一次性初始化。裁剪未使用的引擎功能可能缩小脚本,但调整后必须覆盖受影响的设备和功能,不应为缩包牺牲运行正确性。

复测时同时记录发布目录总 MiB、首屏前 Network 传输量、从导航开始到可交互的耗时,以及慢任务所在阶段。对照优化前后相同条件的三次中位数,确认下降来自被调整的环节,同时检查首屏画质、交互和后续关卡加载没有回退。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查首包体积与启动耗时

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

登录哪都通