是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) 。

2. 記錄浮點值

• 方法名：UWAGears.Sample

• 用途：記錄指定事件的浮點數據

• 調用格式：

UWAGears.Sample(string eventName, double val);

• 參數說明：

• • eventName：事件名稱，長度不超過100個字符

  • val：浮點數據值

• 展示格式：(D)

3. 開始采樣

• 方法名：UWAGears.BeginSample

• 用途：開始對指定代碼段的性能采樣

• 調用格式：

UWAGears.BeginSample(string eventName);

• 參數說明：

• • eventName：自定義標簽名稱，長度不超過100個字符

• 展示格式：(S)

• 注意事項：需要配合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群找到我們，或者前往問答社區進行提問，我們將竭誠為您提供支持。

QQ群：793972859

問答社區鏈接：https://answer.uwa4d.com

近期精彩回顧