游戏引擎 / 系统课时
包体过大怎样定位来源
包体过大怎样定位来源
同一款 Cocos Creator 游戏在 Web、微信小游戏、Android 和 iOS 上都可能出现体积异常,但来源未必相同。本课从最终构建产物取证,区分资源、脚本和原生依赖的贡献,再用可重复的清单确认优化是否有效。
学习目标
- 区分目录体积、压缩包大小、首次下载量和安装后占用。
- 用脚本找出大文件与主要文件类型,并追溯到工程资源。
- 为不同平台选择压缩、拆包或依赖治理方案,并进行回归。
先把四个平台的体积口径分开
在 Cocos Creator 3.8 的构建面板中,先固定 Git 提交、引擎版本、平台、构建选项和资源版本,然后保留未经手工修改的产物。Web 和小游戏重点测主包及远程资源的分布;Android APK、iOS IPA 则先测最终安装归档的字节数。不要拿 assets 源目录直接与 APK 文件大小比较。
- Web Mobile:记录发布目录总量、首次访问实际传输量和 CDN 上的远程 Bundle;传输量还受 HTTP 压缩及浏览器缓存影响。
- 微信小游戏:分开记录主包、分包和远程 Bundle,平台限制以验收当日的渠道规则为准;把资源移到远端并不等于消除了下载成本。
- Android:记录最终 APK 的文件大小及压缩包内条目,另核对是否包含多套 ABI 的
.so库。 - iOS:记录由 Xcode 导出的 IPA、应用内资源和原生框架;IPA 文件大小不等于安装后的磁盘占用。

从产物生成可重复的体积清单
把下面的完整脚本保存为 size_audit.py。它只使用 Python 标准库,可以扫描构建目录,也可以读取 APK、IPA 这类 ZIP 格式归档;按扩展名粗分类,再列出体积最大的五个文件。分类结果是定位线索,不是精确的引擎、业务或第三方代码占比。
from collections import defaultdict
from pathlib import Path
from zipfile import ZipFile, is_zipfile
import sys
GROUPS = {
"纹理": {".png", ".jpg", ".jpeg", ".webp", ".ktx", ".ktx2", ".pvr", ".astc"},
"音频": {".mp3", ".ogg", ".wav", ".m4a"},
"脚本与WASM": {".js", ".jsc", ".wasm"},
"原生库": {".so", ".dylib", ".a"},
}
# 原始字节用于归因,压缩字节只在归档条目上有意义。
def scan(target):
if target.is_dir():
return [(p.relative_to(target).as_posix(), p.stat().st_size, None)
for p in target.rglob("*") if p.is_file()]
# APK、IPA 是 ZIP 结构,但目录层级与 Web 不同。
if is_zipfile(target):
with ZipFile(target) as archive:
return [(item.filename, item.file_size, item.compress_size)
for item in archive.infolist() if not item.is_dir()]
raise SystemExit("请传入构建目录、APK 或 IPA")
def category(name):
extension = Path(name).suffix.lower()
return next((key for key, values in GROUPS.items()
if extension in values), "其他")
if len(sys.argv) != 2:
raise SystemExit("用法: python3 size_audit.py <PATH>")
rows = scan(Path(sys.argv[1]))
if not rows:
raise SystemExit("产物为空")
# 按扩展名粗分组,不把未知扩展名强行归入资源类。
totals = defaultdict(int)
for name, size, _ in rows:
totals[category(name)] += size
print(f"文件数: {len(rows)}")
print(f"未压缩合计: {sum(row[1] for row in rows)} B")
if all(row[2] is not None for row in rows):
print(f"ZIP条目压缩合计: {sum(row[2] for row in rows)} B")
print("按扩展名分类:")
for label, size in sorted(totals.items(), key=lambda item: -item[1]):
print(f" {label}: {size} B")
print("最大 5 个文件:")
for name, size, _ in sorted(rows, key=lambda row: -row[1])[:5]:
print(f" {size} B {name}")在装有 Python 3 的机器上运行,<PATH> 替换为实际构建目录或最终 APK、IPA 路径;路径包含空格时保留引号。
python3 size_audit.py "<PATH>"预期输出(以目录为例,数值和类别随项目变化):
文件数: <COUNT>
未压缩合计: <BYTES> B
按扩展名分类:
<TYPE>: <BYTES> B
最大 5 个文件:
<BYTES> B <FILE>传入 APK 或 IPA 时还会出现 ZIP条目压缩合计。这只是条目压缩字节之和,与整个归档文件大小可能略有差异;排查商店包大小时,以最终 APK、IPA 文件的实际字节数为准。
从大文件追溯到具体引用
先查看最大的五个文件,再看按类型汇总的前两类。Cocos 构建的 Asset Bundle 通常把资源组织到 import、native 等目录,配置由 config.json 描述;资源名称被 UUID 或哈希替代时,需要结合 Bundle 配置、编辑器中的资源依赖与源文件重新定位,不能只凭文件名猜测。
- 纹理、图集占比高:核对分辨率、透明通道、压缩格式、重复贴图及是否进入启动场景依赖;调整后检查真机画质。
- 音频占比高:识别未经压缩的长音频、重复音轨和不必要的声道或采样率;避免以明显失真换取很小的节省。
- 脚本或 WASM 占比高:核对调试产物、脚本依赖、引擎功能裁剪与第三方模块;不要直接删除输出目录中的脚本。
- APK、IPA 中原生项占比高:检查 SDK、动态库、架构切片及符号文件是否被正确纳入最终包;原生可执行文件可能没有扩展名,因此还要人工检查归档的大文件列表。
用同一基线判断优化是否成立
按“最大且可安全处理”的来源排序,每次只改一类:先删无引用资源与错误包含的场景,再评估纹理、音频编码;需要降低首包时,把后续关卡做成按需加载的 Asset Bundle,按平台选择本地、分包或远程方式。远程 Bundle 必须同步校验部署路径、版本缓存及弱网加载。
每轮都保存改动前后的原始清单、最终包字节数、首次传输量和真机首屏耗时,并运行完整启动及资源加载回归。若包变小但启动资源丢失、安装失败或加载明显变慢,该优化不能验收。Asset Bundle 的配置和发布差异可对照 Cocos Creator 3.8 官方文档。