Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Q2 dan Q4. Untuk membuat dan berkontribusi ke AOSP, gunakan android-latest-release. Cabang manifes android-latest-release akan selalu merujuk ke rilis terbaru yang dikirim ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Subclass tidak langsung yang umum

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, dan 16 lainnya.

AtraceCollector	`IMetricCollector` yang menjalankan atrace selama pengujian dan mengumpulkan hasil serta mencatatnya ke pemanggilan.
AtraceRunMetricCollector	Mengumpulkan rekaman aktivitas dari semua direktori pengujian di direktori yang ditentukan dari perangkat pengujian, mencatat direktori pengujian, dan memproses file rekaman aktivitas setelahnya di direktori pengujian serta menggabungkan metrik.
BaseDeviceMetricCollector	Implementasi dasar `IMetricCollector` yang memungkinkan untuk memulai dan menghentikan pengumpulan di `onTestRunStart(DeviceMetricData)` dan `onTestRunEnd(DeviceMetricData,Map)`.
BluetoothConnectionLatencyCollector	Pengumpul akan mengirimkan konfigurasi metrik durasi statsd yang telah ditentukan sebelumnya ke perangkat dan mengumpulkan durasi koneksi Bluetooth untuk setiap profil.
BluetoothConnectionStateCollector	Pengumpul ini akan mengumpulkan metrik BluetoothConnectionStateChanged dan mencatat jumlah status koneksi untuk setiap profil.
BluetoothHciSnoopLogCollector	Pengumpul untuk mengaktifkan pencatatan log snoop HCI Bluetooth di DUT dan mengumpulkan log untuk setiap pengujian.
BugreportzOnFailureCollector	Kumpulkan bugreportz saat kasus pengujian gagal.
BugreportzOnTestCaseFailureCollector	Mengumpulkan bugreportz saat kasus pengujian dalam suatu proses gagal.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Clang dari perangkat dan mencatatnya sebagai artefak pengujian.
CodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Java dan native dari perangkat dan mencatatnya sebagai artefak pengujian.
CountTestCasesCollector	Menghitung dan melaporkan jumlah kasus pengujian untuk `IRemoteTest` tertentu.
DebugHostLogOnFailureCollector	Pengumpul yang akan mengumpulkan dan mencatat log sisi host saat terjadi kegagalan kasus pengujian.
DeviceTraceCollector	Collector yang akan memulai rekaman aktivitas perfetto saat uji coba dimulai dan mencatat file rekaman aktivitas di akhir.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` yang memantau kunci metrik yang berasal dari perangkat dan menarik nya sebagai file dari perangkat.
FilePullerLogCollector	Logger file yang dilaporkan oleh sisi perangkat.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan gcov dari perangkat dan mencatatnya sebagai artefak pengujian.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan kernel gcov dari debugfs dan dari perangkat, lalu mencatatnya sebagai artefak pengujian.
HostStatsdMetricCollector	`IMetricCollector` yang mengumpulkan metrik statsd dari sisi host menggunakan perintah utilitas statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Java dari perangkat dan mencatatnya sebagai artefak pengujian.
LogcatOnFailureCollector	Pengumpul yang akan merekam dan mencatat logcat saat kasus pengujian atau proses pengujian gagal.
LogcatTimingMetricCollector	Pengumpul metrik yang mengumpulkan informasi pengaturan waktu (misalnya, waktu peralihan pengguna) dari logcat selama satu atau beberapa pengujian berulang dengan menggunakan pola regex tertentu untuk mengurai sinyal mulai dan akhir peristiwa dari baris logcat.
ModuleLogcatCollector	Versi pengumpul logcat, tetapi untuk modul.
ModulePerfettoCollector	Pengumpul yang akan memulai rekaman aktivitas perfetto saat modul pengujian dimulai dan berakhir serta perangkat dimulai ulang.
PerfettoFilePullerCollector	Pengumpul yang menarik file rekaman aktivitas perfetto dari perangkat, mengompresinya secara opsional, dan menambahkannya ke log pengujian.
PerfettoPullerMetricCollector	Class ini tidak digunakan lagi. Sebagai gantinya, gunakan `PerfettoFilePullerCollector` dan `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Pengumpul yang mengumpulkan reboot perangkat selama uji coba dan melaporkannya berdasarkan alasan dan jumlah.
RuntimeRestartCollector	Pengumpul yang mengumpulkan stempel waktu mulai ulang runtime (error server sistem) selama uji coba, jika ada.
ScreenRecordOnFailureCollector	Pengumpul yang akan merekam dan mencatat log rekaman layar saat kasus pengujian gagal.
ScreenshotOnFailureCollector	Pengumpul yang akan mengambil dan mencatat screenshot saat kasus pengujian gagal.
ShowmapPullerMetricCollector	Implementasi dasar `FilePullerDeviceMetricCollector` yang memungkinkan penarikan file showmap dari perangkat dan pengumpulan metrik darinya.
TraceCmdCollector	`IMetricCollector` yang mengumpulkan rekaman aktivitas selama pengujian menggunakan trace-cmd, dan mencatatnya ke pemanggilan.

Antarmuka ini akan ditambahkan sebagai dekorator saat melaporkan hasil pengujian untuk mengumpulkan metrik yang cocok.

Antarmuka ini tidak dapat digunakan sebagai meskipun memperluas ITestInvocationListener. Pemeriksaan konfigurasi akan menolaknya. Harus digunakan sebagai "metrics_collector".

Pengumpul tidak diharapkan untuk menyimpan status internal karena dapat digunakan kembali di beberapa tempat. Jika status internal benar-benar harus digunakan, maka status tersebut harus dibersihkan pada init(IInvocationContext,ITestInvocationListener).

Ringkasan

Metode publik
`default boolean`	`captureModuleLevel()` Apakah pengumpul berlaku untuk pengambilan tingkat modul dan harus diinisialisasi.
`default boolean`	`doesModuleContainFailure()` Menampilkan nilai benar jika modul saat ini berisi kegagalan kasus pengujian atau eksekusi pengujian.
`default void`	`enableDefaultMetricCollection()` Mengizinkan pengumpul untuk mengaktifkan pengumpulan metrik default.
`default IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`abstract List<IBuildInfo>`	`getBuildInfos()` Menampilkan daftar informasi build yang tersedia dalam pemanggilan.
`abstract List<ITestDevice>`	`getDevices()` Menampilkan daftar perangkat yang tersedia dalam pemanggilan.
`abstract ITestInvocationListener`	`getInvocationListener()` Menampilkan `ITestInvocationListener` asli tempat kita meneruskan hasilnya.
`default IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inisialisasi pengumpul dengan konteks saat ini dan tempat meneruskan hasil.
`default boolean`	`isDefaultMetricCollectionEnabled()` Apakah pengumpul mengumpulkan metrik sebagai bagian dari pengumpulan metrik default.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal dengan kegagalan asumsi.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback saat kasus pengujian berakhir.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback saat kasus pengujian berakhir.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal.
`default void`	`onTestModuleEnded()` Memungkinkan pengambilan peristiwa modul berakhir.
`default void`	`onTestModuleStarted()` Memungkinkan pengambilan peristiwa modul dimulai.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback saat uji coba berakhir.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback saat uji coba dimulai.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Callback saat uji coba dimulai.
`default void`	`onTestRunStartBlocking()` Callback eksplisit untuk memulai pengumpul secara manual jika didukung.
`abstract void`	`onTestStart(DeviceMetricData testData)` Callback saat kasus pengujian dimulai.
`default void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Menetapkan tingkat pengumpulan log oleh pengumpul, terlepas dari kegagalan.
`default void`	`setModuleContainsFailure()` Menetapkan apakah modul mengalami kegagalan (kasus pengujian, eksekusi pengujian).
`default void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Menetapkan tingkat pengumpulan log yang harus dilakukan pengumpul selama kegagalan.

Metode publik

captureModuleLevel

public boolean captureModuleLevel ()

Apakah pengumpul berlaku untuk pengambilan tingkat modul dan harus diinisialisasi.

Hasil
`boolean`

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Menampilkan nilai benar jika modul saat ini berisi kegagalan kasus pengujian atau eksekusi pengujian.

Hasil
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Mengizinkan pengumpul untuk mengaktifkan pengumpulan metrik default. Jika pengumpulan metrik default diaktifkan, pengumpul hanya boleh mengumpulkan pada tingkat pengumpulan yang ditentukan.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Hasil
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

Menampilkan daftar informasi build yang tersedia dalam pemanggilan.

Hasil
`List<IBuildInfo>`

getDevices

public abstract List<ITestDevice> getDevices ()

Menampilkan daftar perangkat yang tersedia dalam pemanggilan.

Hasil
`List<ITestDevice>`

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Menampilkan ITestInvocationListener asli tempat kita meneruskan hasilnya.

Hasil
`ITestInvocationListener`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Hasil
`IMetricCollector.MetricCollectionLevel`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inisialisasi pengumpul dengan konteks saat ini dan tempat meneruskan hasil. Hanya akan dipanggil satu kali per instance, dan pengumpul diharapkan memperbarui konteks dan pemroses internalnya. Init tidak akan pernah dipanggil selama uji coba selalu sebelumnya.

Jangan mengganti kecuali jika Anda tahu apa yang Anda lakukan.

Parameter
`context`	`IInvocationContext`: `IInvocationContext` untuk pemanggilan yang sedang berlangsung.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` tempat hasil akan ditempatkan.

Hasil
`ITestInvocationListener`	pendengar baru yang membungkus pendengar asli.

Menampilkan
`DeviceNotAvailableException`

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Apakah pengumpul mengumpulkan metrik sebagai bagian dari pengumpulan metrik default.

Hasil
`boolean`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback saat kasus pengujian gagal dengan kegagalan asumsi.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian.
`test`	`TestDescription`: `TestDescription` kasus pengujian yang sedang berlangsung.

Menampilkan
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Callback saat kasus pengujian berakhir. Sekarang saatnya membersihkan.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian. Akan menjadi objek yang sama seperti selama `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: peta metrik saat ini yang diteruskan ke `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: `TestDescription` kasus pengujian yang sedang berlangsung.

Menampilkan
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Callback saat kasus pengujian berakhir. Sekarang saatnya membersihkan.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian. Akan menjadi objek yang sama seperti selama `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: peta metrik saat ini yang diteruskan ke `testEnded(TestDescription,Map)`.

Menampilkan
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback saat kasus pengujian gagal.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian.
`test`	`TestDescription`: `TestDescription` kasus pengujian yang sedang berlangsung.

Menampilkan
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Memungkinkan pengambilan peristiwa modul berakhir.

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Memungkinkan pengambilan peristiwa modul dimulai.

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Callback saat uji coba berakhir. Sekarang saatnya membersihkan.

Parameter
`runData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk proses. Akan menjadi objek yang sama seperti selama `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: peta metrik saat ini yang diteruskan ke `testRunEnded(long,Map)`.

Menampilkan
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback saat uji coba dimulai.

Parameter
`runData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk proses.

Menampilkan
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback saat uji coba dimulai.

Parameter
`runData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk proses.
`testCount`	`int`: jumlah kasus pengujian dalam operasi pengujian ini.

Menampilkan
`DeviceNotAvailableException`

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Callback eksplisit untuk memulai pengumpul secara manual jika didukung. Hal ini memungkinkan untuk memastikan kita keluar dari beberapa siklus proses pengujian yang bersifat asinkron.

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback saat kasus pengujian dimulai.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian.

Menampilkan
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Menetapkan tingkat pengumpulan log oleh pengumpul, terlepas dari kegagalan.

Tingkat NULL tidak akan menghasilkan pengumpulan data.

Parameter
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` tempat log akan dikumpulkan.

setModuleContainsFailure

public void setModuleContainsFailure ()

Menetapkan apakah modul mengalami kegagalan (kasus pengujian, eksekusi pengujian).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Menetapkan tingkat pengumpulan log yang harus dilakukan pengumpul selama kegagalan.

Tingkat NULL tidak akan menghasilkan pengumpulan data.

Parameter
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` tempat log akan dikumpulkan.