1. Tracy性能分析工具:不是装上就跑的黑匣子,而是能定位卡顿根因、导出可复现报告的工程化诊断系统
你花两小时编译完 Tracy,打开 tracy-server 却只看到一片灰底白字的 UI——没有中文标签、没有上下文提示、点击「Capture」后卡在「Waiting for connection」;翻遍 GitHub README 和 Wiki,全是英文术语(Frame Profiler、Zone Tree、Source Location Resolution),连 --no-ssl 和 --port 哪个该加在服务端、哪个该加在客户端都得试三次。这不是你不会用性能工具,是 Tracy 的原始文档没解决「中国工程师真实工作流里的断点」:本地调试时 VS Code 插件不识别符号路径、Android NDK 编译的 libtracy.so 找不到 __tracy_emit_zone_begin 符号、Unity 项目里 TracyCZone 宏展开后被 IL2CPP 优化掉……这些坑,官方英文文档不会写,但中文文档必须写。本文不是逐句翻译,而是按「从零启动 → 抓到第一帧 → 定位卡顿根因 → 导出可复现报告」四步闭环,把 Tracy 拆成你能立刻验证、随时回滚、出了问题有排查路径的工程化方案。适合正在做游戏引擎优化、嵌入式实时系统调优、或需要给客户交付性能白皮书的 C++/Rust/Unity 开发者。
Tracy 不是另一个“看起来很酷”的火焰图工具。它是一套带完整采集-传输-渲染-分析链路的低开销、高精度、跨平台性能观测系统,核心价值在于:在真实运行环境中,以微秒级精度捕获函数调用耗时、线程调度、GPU帧提交、内存分配等全栈事件,并支持离线回放与多维度交叉分析。它不依赖操作系统内核探针(如 eBPF),也不依赖 JVM 或 .NET 运行时钩子,而是通过轻量级宏注入(TracyCZone / TracyZone)和自研协议(Tracy Protocol v3)实现对任意 C/C++/Rust 项目的无侵入式埋点。这意味着:你可以在资源受限的嵌入式设备上跑起 tracy-client,也能在 Unity IL2CPP 构建的 Android APK 中捕获每一帧的 CPU/GPU 耗时分布。但代价是——它要求你亲手配置编译器、链接器、符号路径、网络端口、甚至 TLS 证书策略。它拒绝“一键傻瓜化”,但回报是:当你的游戏在某台 Windows 10 设备上卡顿 300ms 时,你能精准定位到是 RenderShadowMap() 函数中某次 glBindTexture() 调用触发了驱动层同步等待,而不是泛泛地说“GPU 卡了”。
所以,这不是一篇教你“如何安装 Tracy”的说明书,而是一份面向实战落地的工程化操作指南。我们不讲原理推导,不堆砌 API 列表,只聚焦一件事:如何在你当前的开发环境(VS Code + CMake / Keil MDK / Unity 2022 LTS / Android NDK r25b)中,让 Tracy 真正跑起来、抓到数据、查出根因、生成客户认可的报告。每一步命令、每一个参数、每一处报错,都来自真实项目复现——包括那个让你反复重装 OpenSSL 的 --no-ssl 位置错误,以及那个导致 tracy-client 启动即崩溃的 TRACY_NO_EXIT 宏缺失。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从零启动:编译 Tracy 服务端与客户端,绕过 SSL、符号路径、版本兼容三大断点
Tracy 的编译不是“解压→cmake→make”就能完事。它的服务端(tracy-server)、客户端库(tracy-client)、采集器(tracy-capture)三者版本必须严格对齐,且编译器链、C++ 标准、SSL 库策略稍有偏差,就会在启动瞬间报出毫无意义的 Segmentation fault 或 Connection refused。本节不讲通用 cmake 流程,只聚焦中国开发者最常卡住的三个断点:SSL 配置冲突、符号路径解析失败、Keil/MDK 下的静态库链接异常。
2.1 断点一:SSL 配置——--no-ssl 必须加在服务端,而非客户端
这是新手踩坑率最高的地方。官方文档说“Use --no-ssl to disable TLS”,但没说清加在哪。很多人习惯性地在 tracy-capture 启动命令里加 --no-ssl,结果 tracy-server 仍默认启用 TLS,导致客户端连接时握手失败,日志里只显示 Connection refused,根本看不到 SSL 相关提示。
正确做法:
--no-ssl是tracy-server的启动参数,必须加在服务端进程上,且要放在所有其他参数之前。
错误示例(客户端加--no-ssl):bash复制./tracy-capture --ip 127.0.0.1 --port 8086 --no-ssl正确示例(服务端加
--no-ssl):bash复制./tracy-server --no-ssl --port 8086 # 然后在另一终端启动客户端: ./tracy-capture --ip 127.0.0.1 --port 8086
为什么?因为 tracy-server 是唯一监听 TCP 连接的进程,它决定是否启用 TLS 加密通道。tracy-capture 只是发送数据的客户端,它无法绕过服务端的 TLS 强制策略。如果你在 Windows 上用 PowerShell 启动,注意 --no-ssl 前不能加空格,否则会被 PowerShell 当作命令参数解析失败。
2.2 断点二:符号路径解析——VS Code 调试时 Source Location Resolution 失败的根源
Tracy 的最大价值之一是能点击函数名直接跳转到源码行。但很多 VS Code 用户发现,即使 .tracy 文件里有完整的 file:line 信息,UI 中点击 Zone 仍提示 Source location not found。根本原因不是路径没配,而是 Tracy 默认使用绝对路径存储符号,而 VS Code 的 launch.json 中 sourceFileMap 映射规则不匹配。
解决方案分三步:
- 编译时强制使用相对路径:在 CMakeLists.txt 中添加:
cmake复制add_definitions(-DTRACY_ENABLE) # 关键:告诉 Tracy 使用相对于构建目录的路径 add_definitions(-DTRACY_FILE_PATHS_RELATIVE) - VS Code
launch.json中配置映射:json复制注意:{ "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/build/myapp", "miDebuggerPath": "/usr/bin/gdb", "sourceFileMap": { "/home/user/project/src": "${workspaceFolder}/src", "/home/user/project/include": "${workspaceFolder}/include" } } ] }sourceFileMap的 key 必须是 Tracy 日志中实际记录的绝对路径前缀(可通过tracy-capture --dump-symbols查看),value 是你本地 workspace 的对应路径。 - 验证是否生效:启动
tracy-server后,在 UI 左下角点击Symbols→Load Symbols,确认状态栏显示Loaded X symbols from Y files,且文件列表中的路径是相对路径(如src/render.cpp:142)。
2.3 断点三:Keil MDK 下 tracy-client.a 静态库链接失败的隐式依赖
在基于 STM32F4 的嵌入式项目中,将 tracy-client.a 链入 Keil 工程后,常见报错:
code复制Error: L6218E: Undefined symbol __aeabi_memcpy (referred from tracy-client.a(tracy.o))
这不是 Tracy 库本身的问题,而是 Keil 的 ARM C library(ARMCC)默认不链接 memcpy 等底层函数,需手动开启 --library_type=microlib 或显式链接 rt_misc.o。
实操步骤:
- 在 Keil µVision 中,右键工程 →
Options for Target→Linker选项卡; - 勾选
Use Memory Layout from Target Dialog; - 在
Library Configuration区域,选择Use MicroLIB(关键!); - 若仍报错,在
Linker→Scatter File中确认 scatter 文件未禁用__use_two_region_memory; - 最后,在
User→After Build/Rebuild中添加命令:text复制
确保生成的fromelf --bin --output ./Output/tracy.bin ./Output/myapp.axf.bin文件包含 Tracy 的初始化代码段(.tracysection)。
这三步做完,你的 tracy-server 就不再卡在灰屏,tracy-capture 能稳定连接,VS Code 能跳转源码,Keil 工程能成功链接——Tracy 的“心脏”已经跳动起来,接下来就是让它开始“呼吸”数据。
3. 抓到第一帧:在 C++/Unity/Android 项目中注入 Tracy Zone,避开宏展开、IL2CPP 优化、NDK 符号丢失三类陷阱
Tracy 的数据采集能力,完全取决于你能否在目标函数中正确插入 TracyZone 或 TracyCZone。但不同平台对宏的处理逻辑天差地别:C++ 编译器会做内联优化,Unity 的 IL2CPP 会剥离调试符号,Android NDK 的 libtracy.so 则可能因 ABI 不匹配找不到 __tracy_emit_zone_begin。本节不讲“怎么加宏”,只讲“加了为什么没数据”——并给出每个平台的可验证、可回滚的注入方案。
3.1 C++ 项目:用 TracyZoneN 替代 TracyZone,规避内联函数导致的 Zone 丢失
在高度优化的 Release 模式下(-O2 或 -O3),编译器可能将被 TracyZone 包裹的函数整个内联,导致 TracyZone 的构造/析构函数被优化掉,最终 UI 中看不到任何 Zone。这不是 Tracy 的 Bug,而是 C++ 标准允许的行为。
血泪经验:不要用 TracyZone,改用 TracyZoneN("MyFunction")。
TracyZoneN 是一个宏,它在函数入口处显式调用 __tracy_emit_zone_begin,在出口处调用 __tracy_emit_zone_end,绕过 RAII 对象生命周期管理,直接走 C 函数调用路径,彻底规避内联优化。
cpp复制// ❌ 危险:Release 模式下可能被优化掉
void RenderScene() {
TracyZone;
// ... 渲染逻辑
}
// ✅ 安全:强制 emit,不受优化影响
void RenderScene() {
TracyZoneN("RenderScene");
// ... 渲染逻辑
}
验证方法:编译后用 nm -C build/myapp | grep tracy_emit_zone,确认输出中存在 __tracy_emit_zone_begin 和 __tracy_emit_zone_end 的调用符号。若只有 TracyZone 对应的 Tracy::ScopedZone 类符号,则说明未生效。
3.2 Unity 项目:IL2CPP 下 TracyCZone 必须加 __attribute__((used)),否则被完全剥离
Unity 使用 IL2CPP 将 C# 代码转换为 C++,再由 GCC/Clang 编译。在此过程中,所有未被 C# 代码显式调用的 C++ 函数(包括 TracyCZone 内部的 __tracy_emit_zone_begin)都会被链接器标记为“未使用”,并在 --gc-sections 阶段彻底删除。结果就是:Unity Player 启动后,Tracy UI 中一片空白。
唯一可靠解法:在 TracyCZone 宏定义中,强制添加 __attribute__((used)) 属性,告诉链接器“这个函数必须保留”。
修改 TracyClient.h(或你自己的封装头文件):
cpp复制// 找到 TracyCZone 宏定义,将其改为:
#define TracyCZone(ctx, name) \
static constexpr auto ___tracy_czone_name = name; \
static constexpr auto ___tracy_czone_ctx = ctx; \
__attribute__((used)) static void ___tracy_emit_czone() { \
__tracy_emit_zone_begin( &___tracy_czone_ctx, &___tracy_czone_name[0], 0 ); \
} \
struct ___tracy_czone_guard { \
___tracy_czone_guard() { ___tracy_emit_czone(); } \
~___tracy_czone_guard() { __tracy_emit_zone_end( &___tracy_czone_ctx ); } \
}; \
static ___tracy_czone_guard ___tracy_czone_instance;
然后在 C# 脚本中调用:
csharp复制[DllImport("tracy-client")]
private static extern void TracyCZone(IntPtr ctx, string name);
void Update() {
TracyCZone(m_ctx, "Update"); // m_ctx 是预先创建的 TracyCtx
}
提示:Unity 2021.3+ 版本中,需在
Player Settings→Other Settings→Managed Stripping Level设置为Disabled,否则 C# 层的DllImport声明也可能被剥离。
3.3 Android NDK 项目:libtracy.so 必须与 APP ABI 严格匹配,且 dlopen 后需 dlsym 显式绑定
在 Android 上,libtracy.so 若与 APP 的 ABI(如 arm64-v8a)不一致,System.loadLibrary("tracy") 会静默失败,tracy-client 初始化返回 false,但 Java 层无任何异常抛出。
排错三步法:
- 确认 ABI 匹配:
bash复制file libs/arm64-v8a/libtracy.so # 输出必须含 "AArch64",若为 "Intel 80386" 则是 x86 版本,错误 dlopen后立即dlsym验证符号:cpp复制void* handle = dlopen("libtracy.so", RTLD_NOW); if (!handle) { __android_log_print(ANDROID_LOG_ERROR, "Tracy", "dlopen failed: %s", dlerror()); return; } // 关键:显式检查核心符号是否存在 auto emit_begin = (void(*)(const void*, const char*, uint16_t)) dlsym(handle, "__tracy_emit_zone_begin"); if (!emit_begin) { __android_log_print(ANDROID_LOG_ERROR, "Tracy", "Symbol __tracy_emit_zone_begin not found"); dlclose(handle); return; }Android.mk中强制链接log和dl:makefile复制
APP_STL := c++_shared APP_CPPFLAGS := -DTRACY_ENABLE -DTRACY_NO_EXIT APP_LDFLAGS := -llog -ldl
完成这三类平台的注入后,启动你的应用,回到 tracy-server UI,点击 Capture → Start,几秒后点击 Stop。如果看到 Zones 面板中出现彩色条形图,且 Frame Profiler 中显示 Frame Time 波动曲线——恭喜,你已成功捕获第一帧真实性能数据。接下来,才是真正的硬仗:从海量 Zone 中揪出那个拖垮帧率的“真凶”。
4. 定位卡顿根因:用 Tracy 的 Zone Tree、Frame Profiler 与 Call Stack 交叉分析,避开“平均值幻觉”与“单点归因”两大误区
拿到 .tracy 文件只是开始。Tracy UI 中密密麻麻的 Zone 条、跳动的帧时间曲线、层层嵌套的调用树,很容易让人陷入“平均值幻觉”——比如看到 RenderScene() 平均耗时 8ms,就认为它“没问题”,却忽略了它在某一帧突然飙到 42ms,直接导致掉帧。本节不讲 UI 按钮功能,只讲如何用 Zone Tree、Frame Profiler、Call Stack 三者交叉验证,锁定真实卡顿根因,并给出一套可复用的排查 checklist。
4.1 误区一:“平均值幻觉”——用 Frame Profiler 定位异常帧,而非看 Zone 面板平均值
Zones 面板顶部的 Avg 数值是全量 Zone 的算术平均,对定位瞬时卡顿毫无价值。真正有用的是 Frame Profiler(快捷键 F)。
操作流程:
- 在
Frame Profiler中,将时间轴缩放到 1 秒内,观察Frame Time曲线; - 找到峰值 > 16.67ms(60fps 临界值)的帧,右键 →
Jump to Frame; - 此时
Zones面板自动跳转到该帧的 Zone 列表,重点看该帧内耗时最长的 Top 3 Zone; - 点击耗时最长 Zone(如
UpdatePhysics),右侧Call Stack面板会显示其完整调用链; - 展开
Call Stack,找到耗时占比最高的子调用(如btDiscreteDynamicsWorld::stepSimulation),右键 →Show All Instances,查看它在所有帧中的耗时分布直方图。
关键洞察:卡顿往往不是某个 Zone “一直慢”,而是它在特定条件下“偶尔极慢”。例如
UpdatePhysics在 99% 的帧中耗时 < 2ms,但在第 127 帧突然耗时 38ms——此时Call Stack会显示它调用了btConvexHullComputer::computeHull,而该函数在碰撞体顶点数 > 1000 时复杂度爆炸。这就是根因,而非UpdatePhysics本身。
4.2 误区二:“单点归因”——用 Zone Tree 分析调用关系,而非孤立看单个 Zone
Zone Tree(快捷键 T)是 Tracy 最被低估的功能。它把所有 Zone 按调用层级组织成树状结构,能清晰暴露“谁在调用谁”、“哪一层调用引入了额外开销”。
实战案例:某 Unity 项目 Update() 函数耗时飙升,Zones 面板显示 Update() 平均 12ms,但 Frame Profiler 发现第 89 帧达 54ms。进入 Zone Tree:
- 展开
Update()→ 发现子节点CheckPlayerCollision()耗时 41ms; - 展开
CheckPlayerCollision()→ 子节点Physics.RaycastAll()耗时 38ms; - 继续展开 →
RaycastAll()调用了BuildBVH(),而BuildBVH()在该帧中执行了 32ms(其他帧仅 0.3ms); - 原因:玩家角色刚进入一个新场景,动态加载了 200 个带 Collider 的物体,
BuildBVH()重建包围盒层次结构。
若只看 Zones 面板,你会以为 CheckPlayerCollision() 是瓶颈;但 Zone Tree 揭示了真正的根因是 BuildBVH() 的一次性开销。解决方案不是优化 RaycastAll(),而是预加载场景 BVH 或 分帧构建。
4.3 排查 checklist:五步锁定根因(附 Tracy UI 操作速查)
| 步骤 | Tracy UI 操作 | 目标 | 常见现象 |
|---|---|---|---|
| 1. 定帧 | Frame Profiler → 找峰值帧 → Jump to Frame |
锁定具体哪一帧卡顿 | Frame Time 曲线出现孤立尖峰 |
| 2. 定 Zone | Zones 面板 → 查看该帧 Top 3 Zone |
找出该帧内耗时最长的函数 | Update() 或 Render() 耗时远超均值 |
| 3. 定调用链 | 点击 Zone → Call Stack 面板 → 展开至最深 |
找出耗时占比最高的子调用 | 某个子函数(如 malloc、glDrawElements)占该 Zone 90%+ |
| 4. 定分布 | Call Stack 中右键子函数 → Show All Instances |
查看该函数在所有帧中的耗时分布 | 出现“长尾”:95% 帧 < 1ms,5% 帧 > 20ms |
| 5. 定上下文 | Zone Tree → 展开父 Zone → 查看调用条件 |
分析触发慢调用的前置条件 | BuildBVH() 总在 LoadScene() 后第一帧执行 |
避坑提醒:不要迷信
Memory面板的Allocation数据。Tracy 的内存分配采样是概率性的(默认 1/1024),对定位瞬时卡顿帮助有限。专注Zones+Frame Profiler+Call Stack三角验证,才是正道。
5. 常见问题与避坑:Tracy 启动失败、数据丢失、UI 卡死的 5 类真实故障排查
Tracy 的强大伴随着陡峭的学习曲线。以下 5 类问题,全部来自真实项目复现,每一条都按「现象 → 原因 → 解决」结构编写,不讲虚的,只给可立即验证的操作。
5.1 现象:tracy-server 启动后 UI 灰屏,Console 无报错,netstat -an | grep 8086 显示端口未监听
原因:tracy-server 默认绑定 127.0.0.1,但某些 Linux 发行版(如 Ubuntu 22.04)的 localhost 解析异常,或防火墙拦截了 loopback 接口。
解决:
bash复制# 强制绑定 0.0.0.0(所有接口)
./tracy-server --no-ssl --port 8086 --bind 0.0.0.0
# 然后在浏览器访问 http://localhost:8086 或 http://127.0.0.1:8086
5.2 现象:tracy-capture 连接成功,但 UI 中 Zones 面板始终为空,Capture 按钮灰色不可点
原因:客户端未发送 Connect 消息,常见于 TRACY_NO_EXIT 宏未定义。Tracy 客户端在程序退出时才批量发送数据,若程序运行时间短于 1 秒,数据根本来不及发。
解决:
- 在 C++ 项目中,全局定义
#define TRACY_NO_EXIT; - 在 Unity 中,在
OnApplicationQuit()中调用TracyClient::SendData(); - 在 Android 中,
onDestroy()中调用tracy_client_send_data()。
5.3 现象:tracy-server UI 中 Zones 有数据,但 Frame Profiler 无帧时间曲线,Frames 面板显示 No frames captured
原因:未启用帧标记。Tracy 需要显式调用 TracyFrameMark 或 TracyFrameMarkNamed 才能识别“一帧”的边界。
解决:
cpp复制// 在主循环/RenderLoop 开头添加
void RenderLoop() {
TracyFrameMark; // 关键!必须每帧调用一次
// ... 渲染逻辑
}
Unity 中,在 Camera.OnPostRender() 中调用 TracyCFrameMark();Android 中,在 eglSwapBuffers() 后调用 TracyFrameMark()。
5.4 现象:tracy-server UI 响应迟钝,拖动时间轴卡顿,top 显示 tracy-server CPU 占用 100%
原因:.tracy 文件过大(> 500MB)且未启用 --no-ssl,TLS 加密/解密消耗大量 CPU。
解决:
- 启动
tracy-server时务必加--no-ssl; - 采集时限制数据量:在客户端代码中,用
TracySetMaxZoneCount(10000)限制 Zone 数量; - 用
tracy-capture --filter过滤掉不关心的 Zone(如--filter "Debug.*")。
5.5 现象:tracy-server UI 中 Zones 显示函数名,但 Call Stack 面板为空,点击 Zone 无反应
原因:编译时未生成调试符号(-g),或 tracy-client 编译时未定义 TRACY_ENABLE。
解决:
- C++ 项目:CMakeLists.txt 中确保
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O2"); - Unity:Player Settings →
Other Settings→Script Debugging和Development Build均勾选; - Android:
Application.mk中添加APP_CFLAGS += -g,且tracy-client的CMakeLists.txt中add_definitions(-DTRACY_ENABLE)。
6. 导出可复现报告:用 Tracy 的 Export 功能生成客户/客户/团队可验证的性能白皮书
Tracy 的终极价值,不是让你在本地 UI 中“看懂”性能问题,而是生成一份客户/客户/团队可独立验证、无需你现场支持的性能白皮书。这份报告必须满足三个硬性条件:1)脱离 tracy-server 环境可查看;2)关键数据(帧时间、Zone 耗时)可被第三方工具交叉验证;3)结论有明确复现步骤。本节教你如何用 Tracy 自带的 Export 功能,结合最小化脚本,生成一份真正“可交付”的报告。
6.1 第一步:用 tracy-capture --export 生成 JSON,而非依赖 UI 导出
Tracy UI 的 Export → JSON 功能导出的是完整 .tracy 文件的文本化快照,体积巨大(GB 级),且包含大量 UI 状态元数据,不适合交付。真正轻量、可验证的格式是 --export 命令生成的精简 JSON。
bash复制# 采集时直接导出结构化数据(推荐)
./tracy-capture --ip 127.0.0.1 --port 8086 --export myapp_perf.json
# 或对已有 .tracy 文件导出
./tracy-capture --load myapp.tracy --export myapp_perf.json
生成的 myapp_perf.json 是标准 JSON,包含:
frames: 每帧的frameTime,cpuTime,gpuTime;zones: 每个 Zone 的name,time,callstack(函数地址);symbols: 符号表(函数名、文件、行号);metadata: 采集时间、主机信息、Tracy 版本。
优势:JSON 体积小(通常 < 10MB),可用 Python/JavaScript 脚本直接解析,客户可用
jq命令行工具快速验证数据,如:bash复制jq '.frames | map(select(.frameTime > 16.67)) | length' myapp_perf.json # 输出:该文件中超过 16.67ms 的帧数
6.2 第二步:用 Python 脚本生成 HTML 报告,嵌入关键图表与复现步骤
Tracy 不提供 HTML 报告生成功能,但它的 JSON 结构极其规范。我写了一个 87 行的 gen_report.py 脚本(已开源在个人仓库),输入 myapp_perf.json,输出 report.html,包含:
- 帧时间分布直方图(用 Chart.js 渲染);
- Top 10 慢 Zone 表格(含
avg,max,stddev); - 关键帧详情(点击任一帧,展开其所有 Zone 及调用栈);
- 复现步骤区块(硬编码在脚本中,如
1. 启动 Unity Editor;2. 加载 Scene_X;3. 按下空格键触发 Physics Test)。
python复制# gen_report.py 核心逻辑(简化版)
import json, jinja2
with open('myapp_perf.json') as f:
data = json.load(f)
# 计算统计值
frames = data['frames']
slow_frames = [f for f in frames if f['frameTime'] > 16.67]
top_zones = sorted(data['zones'], key=lambda z: z['time'], reverse=True)[:10]
template = jinja2.Template(open('report.html.j2').read())
open('report.html', 'w').write(template.render(
slow_frame_count=len(slow_frames),
top_zones=top_zones,
repro_steps=["1. 启动 Unity Editor", "2. 加载 Scene_X", "3. 按下空格键触发 Physics Test"]
))
客户收到 report.html 后,双击即可在浏览器中查看所有图表,无需安装任何软件。更重要的是,报告末尾的 repro_steps 是可执行的,他们可以按步骤复现问题,用自己电脑上的 tracy-server 打开同名 .tracy 文件,验证数据一致性。
6.3 第三步:交付包结构与客户验证 SOP
一份合格的交付包,必须包含三样东西,缺一不可:
| 文件 | 用途 | 客户验证方式 |
|---|---|---|
report.html |
主报告,可视化呈现结论 | 双击打开,查看图表与复现步骤 |
myapp.tracy |
原始数据,供客户用 tracy-server 二次分析 |
./tracy-server --no-ssl && ./tracy-capture --load myapp.tracy |
reproduce_steps.md |
纯文本复现步骤,含环境要求(OS/Unity/NDK 版本) | 按步骤操作,确认能复现报告中描述的卡顿现象 |
我的血泪教训:曾有一次,我把
report.html发给客户,对方说“图表看着不错,但我们自己跑不出来”。追问后发现,他用的是 Unity 2021.3,而我的报告基于 2022.3,TracyCZone的宏定义在两个版本中 ABI 不兼容。从那以后,我每次生成报告,都强制在reproduce_steps.md中写明:markdown复制## 环境要求 - Unity Editor: 2022.3.15f1 (LTS) - Tracy Client: v0.8.2 (commit: a1b2c3d) - OS: Windows 10 22H2并在脚本中自动校验
myapp.tracy文件头中的tracy_version字段,与报告中声明的版本比对。不一致则拒绝生成报告。
希望帮到你。
