UWA Gears使用指南｜常见问题汇总

是UWA最新发布的无SDK性能分析工具。针对移动平台，提供了实时监测和截帧分析功能，帮助您精准定位性能热点，提升应用的整体表现。

在使用Gears进行性能分析时，大家可能会遇到设备连接、参数不可用、截图内容不清楚等问题。为此，我们整理了部分使用过程中常见的问题以及详细的解决方案，帮助大家高效排查问题，优化性能。

登录闪退，该怎么处理？

A：历史问题，可在官网下载最新版本的Gears安装包安装即可。

最新版本下载链接：

https://www.uwa4d.com/product.html?t=Gears

无法在设备列表中查看到使用USB连接的

设备，应该怎么处理？

A：首先确认使用USB连接的设备打开了开发者人员选项，且USB调试模式处于开启状态；如果仍然无法检索到设备，可查看本机是否存在多个ADB版本，将ADB版本统一，并在任务管理器中结束ADB进程，进入Gears的设置界面配置指定的ADB路径，尝试重新搜索设备。

部分设备可能需要更换不同的USB配置选项或者尝试更换数据线。

Realtime模式部分GPU参数是置灰且不可

选中，是什么原因？

A：Realtime模式下，不同GPU型号的真机设备可选的GPU性能参数项是不同的，且模拟器不支持采集GPU相关性能数据。

GPU性能数据采集问题可以尝试以下解决方案：

1. 确保设备在GPU Counter的支持列表中，具体型号参见：

https://www.uwa4d.com/main/supported.html

2. 在支持的型号中，若Adreno GPU且为Android 12及以上的设备无法获取GPU Counter数据，可以尝试通过以下ADB命令开启：adb shell "echo 1 > /sys/class/kgsl/kgsl-3d0/perfcounter"。但部分设备可能因为硬件厂商的限制无法进行该操作，如小米品牌设备。

3. 在支持的型号中，若Mali GPU的设备无法获取GPU Counter数据，可以尝试重启设备（有可能需要多次）。

Realtime模式的实时截图是否可以放大？

A：最新版本的Gears已经支持截图放大的功能，双击对应截图即可放大图片，并且支持自由调整大小，查看更多细节内容。

Realtime模式如何查看应用的卡顿率？

A： 大家可以将测试的统计数据导出到本地的CSV表格中，在表格的顶部有卡顿率指标的统计数据。

Realtime模式选择完应用启动时，提示

“Remote Server未启动”，应该怎么处理？

A：大家可以先再次选择应用，尝试重新启动是否可以解决问题。如未能解决，可以在Windows电脑的C:\Users\用户名\AppData\Local\UWA Gears目录中找到日志文件，将日志文件发送给我们的工作人员，协助大家定位问题原因。

Realtime模式是否支持采集功率？

A：最新版本已经支持采集功率数据，可使用WIFI模式连接设备，勾选功率参数即可采集。

Realtime模式如何查看多线程的CPU负载

情况？

A：最新版本已经支持Thread Load指标数据的采集，点击CPU Load性能参数旁的“+”号，即可查看。

更多内容可以查看该文章：《》

Realtime模式数据对比功能的入口在哪里？

A：在Gears主界面，大家可以在指定的Realtime数据上右键，选择“对比分析”进入对比分析界面；也可以在进入Realtime模式后，在界面的左上角，选择“对比分析”进入对比分析界面。

更多内容可以查看该文章：《》

截帧分析模式选择完设备后，为什么应用列表

中找不到我们的应用？

A：请大家先确认自己的应用是否是Debuggable包。Debuggable包是Frame Capture模式所必需的，因为获取底层系统层面的数据需要这个配置，而在其他性能测试中则不需要。

如何查看应用是否为Debuggable包？

A：大家可以在终端中使用以下命令来确认：

adb shell dumpsys package <包名> | findstr DEBUGGABLE

如果输出了如小图的内容，即表示应用为Debuggable包，未输出任何内容则不是Debuggable包。

截帧分析模式如何打开截帧文件？

A： 点击截帧后，可点击右侧的小三角查看截帧文件，双击即可加载截帧文件。

截帧分析模式中提示“已存在一个正在运行

的Capture应用”弹窗时，该如何解决？

A： 先查看手机后台是否存在用Gears启动的应用，如果存在，将应用关闭，成功打开即可； 如果不存在，可以重启手机尝试一下。

如果您在使用过程中遇到任何问题，可以通过UWA官方QQ群找到我们，或者前往问答社区进行提问，我们将竭诚为您提供支持。

QQ群：793972859

问答社区链接：https://answer.uwa4d.com

近期精彩回顾