Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

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 13 lainnya.

AtraceCollector	`IMetricCollector` yang menjalankan atrace selama pengujian dan mengumpulkan hasilnya serta mencatatnya ke dalam log untuk pemanggilan.
AtraceRunMetricCollector	Mengumpulkan rekaman aktivitas dari semua direktori pengujian di direktori tertentu dari perangkat pengujian, mencatat direktori pengujian dan memproses ulang file rekaman aktivitas di direktori pengujian, serta menggabungkan metrik.
BaseDeviceMetricCollector	Implementasi dasar `IMetricCollector` yang memungkinkan untuk memulai dan menghentikan pengumpulan di `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` dan `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BluetoothConnectionLatencyCollector	Pengumpul akan mendorong 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 nomor status koneksi untuk setiap profil.
BluetoothHciSnoopLogCollector	Pengumpul untuk mengaktifkan logging snoop HCI Bluetooth di DUT dan mengumpulkan log untuk setiap pengujian.
BugreportzOnFailureCollector	Mengumpulkan bugreportz saat kasus pengujian gagal.
BugreportzOnTestCaseFailureCollector	Mengumpulkan bugreportz saat kasus pengujian dalam proses gagal.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Clang dari perangkat dan mencatatnya sebagai artefak pengujian.
CodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan native dan Java 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 kegagalan kasus pengujian terjadi.
DeviceTraceCollector	Kolektor yang akan memulai rekaman aktivitas perfetto saat pengujian dimulai dan mencatat file rekaman aktivitas di bagian akhir.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` yang memproses kunci metrik yang berasal dari perangkat dan menariknya 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 akhirnya 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 mengambil dan mencatat logcat saat kasus pengujian gagal.
LogcatTimingMetricCollector	Pengumpul metrik yang mengumpulkan informasi pengaturan waktu (misalnya, waktu pengalihan pengguna) dari logcat selama satu atau beberapa pengujian berulang dengan menggunakan pola ekspresi reguler tertentu untuk mengurai sinyal awal dan akhir peristiwa dari baris logcat.
ModuleLogcatCollector	Versi kolektor logcat, tetapi untuk modul.
PerfettoPullerMetricCollector	Implementasi dasar `FilePullerDeviceMetricCollector` yang memungkinkan pengambilan file perfetto dari perangkat dan mengumpulkan metrik darinya.
RebootReasonCollector	Pengumpul yang mengumpulkan mulai ulang perangkat selama pengujian berjalan dan melaporkannya berdasarkan alasan dan jumlah.
RuntimeRestartCollector	Pengumpul yang mengumpulkan stempel waktu mulai ulang runtime (error server sistem) selama pengujian dijalankan, jika ada.
ScreenshotOnFailureCollector	Pengumpul yang akan mengambil dan mencatat screenshot saat kasus pengujian gagal.
ShowmapPullerMetricCollector	Implementasi dasar `FilePullerDeviceMetricCollector` yang memungkinkan pengambilan file showmap dari perangkat dan mengumpulkan 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. Fungsi ini 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, status tersebut harus dibersihkan di init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

Ringkasan

Metode publik
`default boolean`	`captureModuleLevel()` Apakah kolektor berlaku untuk pengambilan tingkat modul dan harus diinisialisasi.
`abstract`	`getBuildInfos()` Menampilkan daftar informasi build yang tersedia dalam pemanggilan.
`abstract`	`getDevices()` Menampilkan daftar perangkat yang tersedia dalam pemanggilan.
`abstract ITestInvocationListener`	`getInvocationListener()` Menampilkan `ITestInvocationListener` asli tempat kita meneruskan hasilnya.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inisialisasi kolektor dengan konteks saat ini dan tempat untuk meneruskan hasil.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal dengan kegagalan asumsi.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Callback saat kasus pengujian berakhir.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback saat kasus pengujian berakhir.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal.
`default void`	`onTestModuleEnded()` Memungkinkan pengambilan peristiwa akhir modul.
`default void`	`onTestModuleStarted()` Memungkinkan pengambilan peristiwa dimulai modul.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback saat pengujian berakhir.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback saat pengujian dimulai.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Callback saat pengujian dimulai.
`abstract void`	`onTestStart(DeviceMetricData testData)` Callback saat kasus pengujian dimulai.

Metode publik

captureModuleLevel

public boolean captureModuleLevel ()

Apakah kolektor berlaku untuk pengambilan tingkat modul dan harus diinisialisasi.

Hasil
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Menampilkan daftar informasi build yang tersedia dalam pemanggilan.

Hasil

getDevices

public abstract  getDevices ()

Menampilkan daftar perangkat yang tersedia dalam pemanggilan.

Hasil

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Menampilkan ITestInvocationListener asli tempat kita meneruskan hasilnya.

Hasil
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inisialisasi kolektor dengan konteks saat ini dan tempat untuk meneruskan hasil. Hanya akan dipanggil sekali per instance, dan kolektor diharapkan untuk memperbarui konteks dan pemroses internalnya. Init tidak akan pernah dipanggil selama pengujian dijalankan.

Jangan mengganti kecuali jika Anda tahu apa yang Anda lakukan.

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

Hasil
`ITestInvocationListener`	pemroses baru yang menggabungkan pemroses asli.

Menampilkan
`DeviceNotAvailableException`

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, 
                 currentTestCaseMetrics, 
                TestDescription test)

Callback saat kasus pengujian berakhir. Ini adalah waktunya untuk melakukan pembersihan.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian. Akan menjadi objek yang sama seperti selama `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: peta metrik saat ini yang diteruskan ke `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: `TestDescription` kasus pengujian yang sedang berlangsung.

Menampilkan
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback saat kasus pengujian berakhir. Ini adalah waktunya untuk melakukan pembersihan.

Parameter
`testData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk kasus pengujian. Akan menjadi objek yang sama seperti selama `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: peta metrik saat ini yang diteruskan ke `ERROR(/#testEnded(com.android.tradefed.result.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 akhir modul.

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

onTestModuleStarted

public void onTestModuleStarted ()

Memungkinkan pengambilan peristiwa dimulai modul.

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

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback saat pengujian berakhir. Ini adalah waktunya untuk melakukan pembersihan.

Parameter
`runData`	`DeviceMetricData`: `DeviceMetricData` yang menyimpan data untuk dijalankan. Akan menjadi objek yang sama seperti selama `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: peta metrik saat ini yang diteruskan ke `ERROR(/#testRunEnded(long,Map))`.

Menampilkan
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback saat pengujian dimulai.

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

Menampilkan
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback saat pengujian dimulai.

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

Menampilkan
`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`