新增自定义数据功能｜UWA Gears V1.0.7
UWA Gears 是UWA最新发布的无SDK性能分析工具。针对移动平台，提供了实时监测和截帧分析功能，帮助您精准定位性能热点，提升应用的整体表现。
本次版本更新新增了自定义数据功能，支持灵活定义和捕获关键性能指标，满足特殊场景的分析需求。同时，导出数据新增卡顿率以及CPU、GPU和电池的平均温度和最大温度参数，为安卓应用性能优化提供更加全面的数据支持。
以下是本次版本更新的主要功能介绍：
自定义数据功能
新增的自定义数据功能，旨在帮助大家更灵活地记录和分析项目中关键的性能指标。通过将Gears提供的SDK集成到项目中，您可以在代码的关键位置调用自定义打点函数，记录指定的性能数据（例如资源加载时间、逻辑执行耗时、怪物数量等）。在使用Gears进行测试时，这些自定义数据可实时同步至Gears进行展示，方便研发团队直观分析性能情况，快速定位问题根源。
支持范围
目前，自定义数据功能现已支持所有的主流引擎平台，包括Unity、Unreal（UE）、Cocos 等。大家可以根据项目需求选择适合的SDK进行集成，并实现性能数据的自定义捕获与分析。以下将以Unity引擎作为示例进行说明。
SDK获取位置
首先需要将Gears更新至最新版本，在Gears的安装目录下的bin\sdk文件夹中可以找到以下文件：
1. Android Native
在AndroidNative文件夹中，包含arm64-v8a和armeabi-v7a两种架构的动态链接库以及头文件AndroidTrace.h。
2. Unity SDK
在Unity文件夹中获取GearsSDK_Android.unitypackage文件，适用于Unity项目的性能测试。
集成SDK
将GearsSDK_Android.unitypackage拖动至Unity项目中，并点击“import”进行导入。
导入之后，SDK的全部文件位于Assets\Plugins文件夹内，便于管理。
SDK接口介绍
1. 记录整型值
- 方法名：UWAGears.Sample
- 用途：记录指定事件的整型数据
- 调用格式：
UWAGears.Sample(string eventName, int val);
- 参数说明：
- eventName：事件名称，长度不超过100个字符
- val：整型数据值
- 展示格式：(I)<eventName>
2. 记录浮点值
- 方法名：UWAGears.Sample
- 用途：记录指定事件的浮点数据
- 调用格式：
UWAGears.Sample(string eventName, double val);
- 参数说明：
- eventName：事件名称，长度不超过100个字符
- val：浮点数据值
- 展示格式：(D)<eventName>
3. 开始采样
- 方法名：UWAGears.BeginSample
- 用途：开始对指定代码段的性能采样
- 调用格式：
UWAGears.BeginSample(string eventName);
- 参数说明：
- eventName：自定义标签名称，长度不超过100个字符
- 展示格式：(S)<eventName>
- 注意事项：需要配合UWAGears.EndSample使用
- 示例代码：
4. 结束采样
- 方法名：UWAGears.EndSample
- 用途：结束当前代码段的性能采样
- 调用格式：
UWAGears.EndSample();
- 注意事项：必须在与UWAGears.BeginSample相同的线程中调用
5. 添加书签
- 方法名：UWAGears.AddTag
- 用途：为指定事件添加书签
- 调用格式：
UWAGears.AddTag(string tagName);
- 参数说明：
- tagName：书签名称，长度不超过100个字符
- 注意事项：确保当前书签名称与前一个不同
Gears中自定义数据参数位置
自定义数据参数默认位于Gears参数面板的底部。大家可以通过排序按钮调整其上下位置，双击自定义数据参数即可在数据显示区域快速定位对应的参数位置。同时，点击 “+” 按钮可以展开所有自定义数据事件，方便进行更详细的分析。
导出数据新增卡顿率和温度参数
新版本中，在导出的CSV表格数据中新增了卡顿率（Stutter %）、CPU、GPU及电池的平均温度和最大温度参数，帮助开发者更直观地了解应用运行时的性能表现。
新用户可以通过访问UWA官网Gears产品介绍页进行下载体验，老用户可以在软件内点击主界面右上角的【检查更新】更新至最新版本。
如果您在使用过程中遇到任何问题，可以通过UWA官方QQ群找到我们，或者前往问答社区进行提问，我们将竭诚为您提供支持。
问答社区链接：https://answer.uwa4d.com