自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
TraceCmdCollector
public
class
TraceCmdCollector
extends AtraceCollector
IMetricCollector 會在測試期間使用 trace-cmd 收集追蹤記錄，並將這些記錄記錄到叫用作業中。
這個追蹤記錄收集器可在測試期間 (例如電源測試) 中斷 USB 連線。
系統預設工具 atrace 會與此收集器搭配使用，以便設定 Android 專屬的 sysfs 標記。
必須指定與 Android 相容的 trace-cmd (https://git.kernel.org/pub/scm/linux/kernel/git/rostedt/trace-cmd.git) 二進位檔。
這會上傳由 trace-cmd 產生的 trace.dat 格式 (請參閱 man 5 trace-cmd.dat)。
摘要
公用建構函式
TraceCmdCollector
public TraceCmdCollector ()
受保護的方法
startTracing
protected void startTracing (ITestDevice device)
stopTracing
protected void stopTracing (ITestDevice device)
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-27 (世界標準時間)。"],[],[],null,["# TraceCmdCollector\n=================\n\n\n`\npublic\n\n\nclass\nTraceCmdCollector\n`\n\n\n`\n\n\n`\n\n`\n\n\n`\n\n`\n\nextends `[AtraceCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/AtraceCollector.html)`\n\n\n`\n\n`\n\n\n`\n\n|---|---|---|------------------------------------------------------|\n| java.lang.Object ||||\n| ↳ | [com.android.tradefed.device.metric.BaseDeviceMetricCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/BaseDeviceMetricCollector.html) |||\n| | ↳ | [com.android.tradefed.device.metric.AtraceCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/AtraceCollector.html) ||\n| | | ↳ | com.android.tradefed.device.metric.TraceCmdCollector |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA [IMetricCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/IMetricCollector.html) that collects traces during the test using trace-cmd, and logs them to\nthe invocation.\n\nThis trace collector allows for USB disconnection during the test (as in power testing).\n\nThe system default tool, atrace, is used in tandem with this collector to set the\nandroid-specific sysfs flags.\n\nA trace-cmd (https://git.kernel.org/pub/scm/linux/kernel/git/rostedt/trace-cmd.git) binary\ncompatible with Android must be specified.\n\nThis will upload the trace.dat format (see man 5 trace-cmd.dat) produced by trace-cmd.\n\nSummary\n-------\n\n| ### Public constructors ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[TraceCmdCollector](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/TraceCmdCollector.html#TraceCmdCollector())`() ` |\n\n| ### Protected methods ||\n|--------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` `[LogDataType](../../../../../../../reference/tradefed/com/android/tradefed/result/LogDataType.html) | ` `[getLogType](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/TraceCmdCollector.html#getLogType())`() ` |\n| ` void` | ` `[startTracing](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/TraceCmdCollector.html#startTracing(com.android.tradefed.device.ITestDevice))`(`[ITestDevice](../../../../../../../reference/tradefed/com/android/tradefed/device/ITestDevice.html)` device) ` |\n| ` void` | ` `[stopTracing](../../../../../../../reference/tradefed/com/android/tradefed/device/metric/TraceCmdCollector.html#stopTracing(com.android.tradefed.device.ITestDevice))`(`[ITestDevice](../../../../../../../reference/tradefed/com/android/tradefed/device/ITestDevice.html)` device) ` |\n\nPublic constructors\n-------------------\n\n### TraceCmdCollector\n\n```\npublic TraceCmdCollector ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nProtected methods\n-----------------\n\n### getLogType\n\n```\nprotected LogDataType getLogType ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Returns ||\n|-----------------------------------------------------------------------------------------------------|--------|\n| [LogDataType](../../../../../../../reference/tradefed/com/android/tradefed/result/LogDataType.html) | \u003cbr /\u003e |\n\n### startTracing\n\n```\nprotected void startTracing (ITestDevice device)\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------|----------------------|\n| `device` | `ITestDevice` \u003cbr /\u003e |\n\n| Throws ||\n|-------------------------------------------------------------------------------------------------------------------------------------|---|\n| [DeviceNotAvailableException](../../../../../../../reference/tradefed/com/android/tradefed/device/DeviceNotAvailableException.html) | |\n\n### stopTracing\n\n```\nprotected void stopTracing (ITestDevice device)\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Parameters ||\n|----------|----------------------|\n| `device` | `ITestDevice` \u003cbr /\u003e |\n\n| Throws ||\n|-------------------------------------------------------------------------------------------------------------------------------------|---|\n| [DeviceNotAvailableException](../../../../../../../reference/tradefed/com/android/tradefed/device/DeviceNotAvailableException.html) | |"]]
