Wasm Analysis工具

Wasm Analysis 是一款针对 WebAssembly (Wasm) 文件的分析工具，可以深入分析 Wasm 文件的构成与细节。通过这个工具，开发者可以详尽地查看 Wasm 文件中的各个模块和方法，以及它们包含的指令数量。帮助开发者精确定位需要剔除或精简的代码，从而减小 Wasm 大小。

开始使用 WebAssembly Analysis

在 File > Build Settings 界面的 Weixin MiniGame 平台的选项中，勾选 “Generate Wasm Analysis Report(?)” 选项。之后在构建项目成功后会自动弹出 Wasm Analysis 窗口。除此之外，您还可以从 Window > Analysis > Wasm Analysis 目录中手动打开此窗口。

WebAssembly Analysis 界面介绍

Wasm Analysis 工具的界面主要由 4 个部分组成。

• 最左边一栏的 “Files” 板块列举了每次勾选 “Generate Wasm Analysis Report(?)” 并打包成功后的 Wasm 文件信息。点击后可以在右侧三个栏位中看到详细信息。该信息文件被保存在 “Library\AutoStreamingCache\WasmAnalysisReport” 目录下，您也可以通过右键点击菜单中的 “Show In Explorer” 来找到该信息文件。您可以手动删除或通过右击菜单中的 “Delete” 选项删除该信息文件。
• 最右边一栏的 “Relevant Settings” 板块中记录着此次构建时有可能影响 Wasm 文件的部分设置。通过多次调整设置并构建，您可以对比观察这些设置如何影响 Wasm 文件。
• 中间一栏的上半部分详细列举了 Wasm 文件中 托管代码(Managed) 以及 原生代码(Native) 中的各个模块、方法的指令数量，并按照从大到小的顺序排列。您可以从中观察哪些模块、类或方法最为庞大，根据需要着手优化。
• 中间一栏的下半部分会列举出指令数最多的20个方法，您可以通过 “In All”, “In Managed”, “In Native” 这几个按钮来选择查找的范围。
• 左下角的折叠栏允许您手动导入 Wasm 文件并生成分析报告，为此您需要提供如下文件：
• Wasm 文件 (*.wasm) ：项目构建时生成的 WASM 文件
• 符号表文件 (*.symbols.json) ：项目构建时生成 WASM 文件的符号表。该文件会根据 “Project Settings > Player > Publishing Settings > Debug Symbols” 的设置决定是否生成。若该设置 “Debug Symbols” 为 “External”，则该文件会正常生成在构建目录中；若 “Debug Symbols” 为 “Embedded”，则符号表会内嵌在 wasm 文件中，当您导入 wasm 文件后会提示您无需额外提供该文件。若 “Debug Symbols” 为 “Off”，则无法进行分析。
• MethodMap 文件 (MethodMap.tsv) ：所在路径为 “Temp/EditorBuildOutput/MethodMap.tsv”，该文件会随项目的变化发生改变，因此请提供导入 wasm 文件生成时对应的 MethodMap 文件。若 MethodMap 和 wasm 不匹配可能会导致分析结果不准确。