是UWA最新發(fā)布的無SDK性能分析工具。針對(duì)移動(dòng)平臺(tái)，提供了實(shí)時(shí)監(jiān)測(cè)和截幀分析功能，幫助您精準(zhǔn)定位性能熱點(diǎn)，提升應(yīng)用的整體表現(xiàn)。

本次版本更新新增了自定義數(shù)據(jù)功能，支持靈活定義和捕獲關(guān)鍵性能指標(biāo)，滿足特殊場(chǎng)景的分析需求。同時(shí)，導(dǎo)出數(shù)據(jù)新增卡頓率以及CPU、GPU和電池的平均溫度和最大溫度參數(shù)，為安卓應(yīng)用性能優(yōu)化提供更加全面的數(shù)據(jù)支持。

以下是本次版本更新的主要功能介紹：

自定義數(shù)據(jù)功能

新增的自定義數(shù)據(jù)功能，旨在幫助大家更靈活地記錄和分析項(xiàng)目中關(guān)鍵的性能指標(biāo)。通過將Gears提供的SDK集成到項(xiàng)目中，您可以在代碼的關(guān)鍵位置調(diào)用自定義打點(diǎn)函數(shù)，記錄指定的性能數(shù)據(jù)（例如資源加載時(shí)間、邏輯執(zhí)行耗時(shí)、怪物數(shù)量等）。在使用Gears進(jìn)行測(cè)試時(shí)，這些自定義數(shù)據(jù)可實(shí)時(shí)同步至Gears進(jìn)行展示，方便研發(fā)團(tuán)隊(duì)直觀分析性能情況，快速定位問題根源。

支持范圍

目前，自定義數(shù)據(jù)功能現(xiàn)已支持所有的主流引擎平臺(tái)，包括Unity、Unreal（UE）、Cocos 等。大家可以根據(jù)項(xiàng)目需求選擇適合的SDK進(jìn)行集成，并實(shí)現(xiàn)性能數(shù)據(jù)的自定義捕獲與分析。以下將以Unity引擎作為示例進(jìn)行說明。

SDK獲取位置

首先需要將Gears更新至最新版本，在Gears的安裝目錄下的bin\sdk文件夾中可以找到以下文件：

1. Android Native

在AndroidNative文件夾中，包含arm64-v8a和armeabi-v7a兩種架構(gòu)的動(dòng)態(tài)鏈接庫以及頭文件AndroidTrace.h。

2. Unity SDK

在Unity文件夾中獲取GearsSDK_Android.unitypackage文件，適用于Unity項(xiàng)目的性能測(cè)試。

集成SDK

將GearsSDK_Android.unitypackage拖動(dòng)至Unity項(xiàng)目中，并點(diǎn)擊“import”進(jìn)行導(dǎo)入。

導(dǎo)入之后，SDK的全部文件位于Assets\Plugins文件夾內(nèi)，便于管理。

SDK接口介紹

1. 記錄整型值

• 方法名：UWAGears.Sample

• 用途：記錄指定事件的整型數(shù)據(jù)

• 調(diào)用格式：

UWAGears.Sample(string eventName, int val);

• 參數(shù)說明：

• • eventName：事件名稱，長(zhǎng)度不超過100個(gè)字符

  • val：整型數(shù)據(jù)值

• 展示格式：(I) 。

2. 記錄浮點(diǎn)值

• 方法名：UWAGears.Sample

• 用途：記錄指定事件的浮點(diǎn)數(shù)據(jù)

• 調(diào)用格式：

UWAGears.Sample(string eventName, double val);

• 參數(shù)說明：

• • eventName：事件名稱，長(zhǎng)度不超過100個(gè)字符

  • val：浮點(diǎn)數(shù)據(jù)值

• 展示格式：(D)

3. 開始采樣

• 方法名：UWAGears.BeginSample

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

• 調(diào)用格式：

UWAGears.BeginSample(string eventName);

• 參數(shù)說明：

• • eventName：自定義標(biāo)簽名稱，長(zhǎng)度不超過100個(gè)字符

• 展示格式：(S)

• 注意事項(xiàng)：需要配合UWAGears.EndSample使用

• 示例代碼：

4. 結(jié)束采樣

• 方法名：UWAGears.EndSample

• 用途：結(jié)束當(dāng)前代碼段的性能采樣

• 調(diào)用格式：

UWAGears.EndSample();

• 注意事項(xiàng)：必須在與UWAGears.BeginSample相同的線程中調(diào)用

5. 添加書簽

• 方法名：UWAGears.AddTag

• 用途：為指定事件添加書簽

• 調(diào)用格式：

UWAGears.AddTag(string tagName);

• 參數(shù)說明：

• • tagName：書簽名稱，長(zhǎng)度不超過100個(gè)字符

• 注意事項(xiàng)：確保當(dāng)前書簽名稱與前一個(gè)不同

Gears中自定義數(shù)據(jù)參數(shù)位置

自定義數(shù)據(jù)參數(shù)默認(rèn)位于Gears參數(shù)面板的底部。大家可以通過排序按鈕調(diào)整其上下位置，雙擊自定義數(shù)據(jù)參數(shù)即可在數(shù)據(jù)顯示區(qū)域快速定位對(duì)應(yīng)的參數(shù)位置。同時(shí)，點(diǎn)擊 “+” 按鈕可以展開所有自定義數(shù)據(jù)事件，方便進(jìn)行更詳細(xì)的分析。

導(dǎo)出數(shù)據(jù)新增卡頓率和溫度參數(shù)

新版本中，在導(dǎo)出的CSV表格數(shù)據(jù)中新增了卡頓率（Stutter %）、CPU、GPU及電池的平均溫度和最大溫度參數(shù)，幫助開發(fā)者更直觀地了解應(yīng)用運(yùn)行時(shí)的性能表現(xiàn)。

新用戶可以點(diǎn)擊閱讀原文來訪問UWA官網(wǎng)Gears產(chǎn)品介紹頁進(jìn)行下載體驗(yàn)，老用戶可以在軟件內(nèi)點(diǎn)擊主界面右上角的【檢查更新】更新至最新版本。

如果您在使用過程中遇到任何問題，可以通過UWA官方QQ群找到我們，或者前往問答社區(qū)進(jìn)行提問，我們將竭誠(chéng)為您提供支持。

QQ群：793972859

問答社區(qū)鏈接：https://answer.uwa4d.com

近期精彩回顧