企业官网建设流程全解析

• 游戏开发
• 移动开发
• WebAssembly

导读

本文面向使用 minigame-unity-webgl-transform 适配器将 Unity WebGL 游戏转换为微信小游戏的开发者，完整讲解如何利用 Android CPU Profiler 在小游戏真机环境中录制、导出并分析 CPU 性能数据，定位 C# 逻辑与引擎运行时的热点函数。读完本文，你将掌握「Profiling-funcs 导出选项的正确使用与发布红线」「真机录制 → 文件导出 → Chrome/Edge 加载分析」的完整闭环，以及在不开启 Profiling-funcs 时借助 symbols 映射脚本解读数字函数 ID 的进阶方案。

一、为什么推荐用 Android CPU Profiler 分析小游戏性能

Unity WebGL 在微信小游戏中的运行形态是 WebAssembly 代码，无法直接套用 Android 原生应用的性能分析手段。在适配器的性能优化总览文档 PerfOptimization.md 中明确将「尽量使用 Android CPU Profiler 在小游戏真机环境 Profile 计算瓶颈」列为降低 CPU 消耗的首选实践，并强调该工具「无论是启动耗时或运行时流畅分析都非常有用」。

Android CPU Profiler 的核心优势在于：它直接作用在微信小游戏运行所依赖的 V8 JavaScript/WASM 虚拟机层面，能真实反映小游戏运行时的每一帧函数耗时，尤其适合分析：

• 首场景启动（CallMain / PlayerLoadFirstScene）阶段的耗时分布；
• 运行时帧率波动、卡帧时的热点函数定位；
• MonoBehaviour 逻辑、Lua/xLua 等脚本层的计算瓶颈（参考 PerformanceMonitor.md 中「卡帧问题均需要使用 cpuprofile 定位」的说明）。

二、前置准备：正确配置 Profiling-funcs 导出选项

在进行性能录制前，必须先保证导出代码包中带有可读的函数名，否则得到的 Profile 中函数将显示为数字 ID，无法直接解读。

2.1 推荐配置与发布红线

• 导出时勾选 "Profiling-funcs"：转换导出插件勾选该选项后，导出的代码包中将包含可读函数名（详见 DebugAndException.md）。
• 请勿勾选 Development Build：该模式会「极大降低性能」，分析结果不具代表性，无法反映线上真实表现。
• 发布上线版本务必关闭 Profiling-funcs：它会使代码包显著膨胀。这一点是硬性要求，正式上线包必须关闭该选项。

从源码层面看，该选项实际是通过 Unity Player Settings 的 Emscripten 附加参数注入的。以仓库内的 LaunchOpera 示例工程 为例，其ProjectSettings.asset中webGLEmscriptenArgs字段包含：

-s EXPORTED_FUNCTIONS=_sbrk,_emscripten_stack_get_base,_emscripten_stack_get_end -s TOTAL_MEMORY=256MB --profiling-funcs

其中的--profiling-funcs即 Emscripten 编译参数，等价于在导出面板勾选 Profiling-funcs。同一目录下的 API_V2 示例工程 与 particlebudget 示例工程 也保留了该参数，可以作为参考模板。

2.2 可读函数名的前提

注意：仅当导出勾选 Profiling-funcs（推荐）或 Development 时，才能在函数堆栈中看到可读函数名。两者的取舍在于：

三、完整操作流程：真机录制 → PC 分析

步骤 1：在 Android 微信小游戏中打开调试进行录制

在 Android 真机上运行已导出的小游戏，点击右上角菜单进入「开发调试」，选择Start CPU Profile开始录制：

若希望从游戏启动的第一刻就开始录制，请参考本文第五节「从启动即抓取 Profile」的 game.js 改造方案。

步骤 2：停止性能数据录制

与步骤 1 相似，在相同的菜单中选择Stop CPU Profile停止录制，随后系统会生成一份.cpuprofile文件。

步骤 3：传输录制文件到 PC

录制结束后，Android 会生成一份xxx.cpuprofile，该文件格式可以使用 Chrome 解析，因此需要将录制文件传输到 PC。文件路径通常为：

Android/data/com.tencent.mm/MicroMsg/appbrand/trace

可通过 USB 连接电脑或第三方文件管理器将文件取出：

步骤 4：利用 PC（Windows/Mac）的 Edge/Chrome 加载数据

以 Edge 为例，浏览器菜单打开更多工具 → 开发人员工具 → 右上角 … → 更多工具 → JavaScript 探测器，然后点击「加载」按钮导入前面导出的 cpuprofile 文件即可：

加载成功后的视图界面如下：

提示：最新版本的 Chrome/Edge 已将 JavaScript Profiler 默认隐藏。若找不到入口，可使用微信开发者工具直接查看.cpuprofile文件，或通过浏览器的「更多工具」菜单手动启用该面板。

步骤 5：使用 JavaScript Profile 进行数据分析

加载完成后，视图有多种呈现方式，可选择「图表（Chart）」模式分析每一帧游戏函数的耗时情况：

分析时重点关注：

• 单帧内耗时占比最高的函数：往往是 C# 业务逻辑或引擎调用热点；
• 耗时函数的调用来源（Callers）：判断热点是由 MonoBehaviour 的 Update、协程，还是引擎生命周期回调引发；
• 周期性出现的尖峰：通常对应 GC、资源加载或物理/渲染相关开销。

四、无 Profiling-funcs 时：数字函数 ID 的两种解读方案

特殊情况下，如果勾选 Profiling-funcs 会导致代码包过大，则不要使用此选项。此时得到的 Profile 中函数为数字 ID，有两种做法进行解读。

方案 2.1：通过 symbols 文件对照映射

webgl 导出目录下的symbols文件（即 DataCDN.md 中提到的webgl.wasm.symbols.unityweb）保存了函数 ID 与函数名的映射关系。以文本方式打开webgl/Build/xxx.symbols，通过日志或 Profile 中的函数 ID 找到对应的原始函数名，手动分析调用堆栈。该文件默认不会上传到线上（见 DevelopmentQAList.md 第 12 条说明），仅用于本地排查。

方案 2.2：使用替换脚本自动映射到真实函数

仓库提供了自动化替换脚本 tools/update_v8_wasm_profile.py，可对 cpuprofile 进行自动映射。

基础用法（对应原文档）：

python update_v8_wasm_profile.py xxx.cpuprofile xxx.symbols

完整用法（含 WASM 代码分包场景）：从脚本源码（if __name__ == '__main__'分支）可以看到实际签名是三个参数：

usage: python update_v8_wasm_profile.py xxx.cpuprofile xxx.symbols is_wasmsplit(0/1)

• 第三个参数is_wasmsplit：非分包传0；使用 WASM 代码分包时传1。因为分包场景下函数 ID 以jxxx的数字形式出现（见 DebugAndException.md 中「在 WASM 代码分包情况下，应该使用 jxxx 的数字作为函数 id」的说明），脚本需要据此生成"j<id>"的映射键。

脚本的核心处理逻辑（tools/update_v8_wasm_profile.py）可以概括为：

1. 解析 symbols 文件：用正则"(\d+)": "(.*)"提取数字 ID → 函数名的映射表，同时将符号文件中的\28、\29、\20、\2c等转义还原为(、)、空格、,；
2. 按键替换：非分包模式把wasm-function[N]替换为真实函数名；分包模式把"jN"替换为函数名；
3. 剔除 MD5 后缀：函数名中长度为 41 的片段会被视为 IL2CPP 生成的 MD5 哈希并移除，让函数名更可读；
4. 输出新文件：在xxx.cpuprofile同目录下生成xxx_out.cpuprofile，再将该文件导入 Chrome/Edge 即可看到真实函数名。

补充：若需要替换的是异常日志中的函数 ID（而非 Profile 文件），可参考 Symbol.md 中配套的node tools/rewrite_exception_symbol.js exception.txt webgl.wasm.symbols.unityweb用法，原理一致。

五、进阶技巧：从游戏启动立即抓取 Profile

Android 采集 Profile 需要手动控制起止，而游戏启动逻辑（gameManager.startGame()）会在代码包下载编译完成和首包资源下载完成后立即执行。为了能录制到启动阶段的完整 Profile，需要保证录制开始之后才真正执行游戏启动逻辑。

在game.js末尾将代码稍作修改：

const gl = GameGlobal.canvas.getContext('webgl') gl.clear(gl.COLOR_BUFFER_BIT); setTimeout(() => { gameManager.startGame(); GameGlobal.manager = gameManager; }, 10000);

修改后，游戏启动将会有10 秒黑屏，开发者可在此期间打开调试并点击 Start CPU Profile，待录制就绪后再真正拉起游戏逻辑。

更精细的启动期改造参考 FirstSceneOptimization.md：可配合loadingPageConfig.visible: false隐藏加载页，并把gameManager.startGame()移入wx.onTouchStart回调，实现「Start CPU Profile → 点击屏幕触发真正的开始游戏逻辑 → 看到游戏界面后 Stop Profile」的录制节奏。

六、相关文档指引

Android CPU Profiler 是启动耗时与运行时流畅度分析的核心工具，可与以下文档配合使用形成完整调优链路：

• PerfOptimization.md：性能优化总览，明确 CPU Profiler 在整体优化体系中的位置；
• FirstSceneOptimization.md：首场景启动优化的完整 Profile 分析流程与 CallMain/PlayerLoadFirstScene 拆解；
• DebugAndException.md：Profiling-funcs、Debug Symbols、Development Build 等导出选项对函数名可读性的影响详解；
• Symbol.md：异常堆栈函数 ID 替换小工具的使用说明；
• UnityProfiler.md：配合在 Unity 编辑器侧定位问题的对照工具；
• PerformanceMonitor.md：卡帧问题定位时 cpuprofile 的使用场景。

七、关键要点速查

1. 分析用包：勾选Profiling-funcs；严禁使用 Development Build 录制；上线包务必关闭 Profiling-funcs；
2. 录制入口：小游戏右上角菜单 → 开发调试 → Start CPU Profile / Stop CPU Profile；
3. 文件位置：Android/data/com.tencent.mm/MicroMsg/appbrand/trace，格式为.cpuprofile；
4. 分析入口：Chrome/Edge 开发人员工具 → 更多工具 → JavaScript 探测器，Chart 视图可逐帧分析；
5. 无函数名时：用xxx.symbols手动对照，或执行python update_v8_wasm_profile.py xxx.cpuprofile xxx.symbols 0/1（分包传 1）自动映射；
6. 抓启动期数据：在game.js末尾用setTimeout延迟调用gameManager.startGame()，换取 10 秒录制窗口。

• 游戏开发
• 移动开发
• WebAssembly