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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Subclass langsung yang dikenal

AtraceCollector	`IMetricCollector` yang menjalankan atrace selama pengujian dan mengumpulkan hasil serta mencatatnya ke pemanggilan.
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.
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.
ModulePerfettoCollector	Pengumpul yang akan memulai rekaman aktivitas perfetto saat modul pengujian dimulai dan berakhir serta perangkat dimulai ulang.
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.

Subclass tidak langsung yang umum

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

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.
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.
FilePullerLogCollector	Logger file yang dilaporkan oleh sisi perangkat.
ModuleLogcatCollector	Versi pengumpul logcat, tetapi untuk modul.
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)`.
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.

Implementasi dasar IMetricCollector yang memungkinkan untuk memulai dan menghentikan pengumpulan di onTestRunStart(DeviceMetricData) dan onTestRunEnd(DeviceMetricData,Map).

Ringkasan

Konstanta
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Konstruktor publik
`BaseDeviceMetricCollector()`

Metode publik
`boolean`	`doesModuleContainFailure()` Menampilkan nilai benar jika modul saat ini berisi kegagalan kasus pengujian atau eksekusi pengujian.
`void`	`enableDefaultMetricCollection()` Mengizinkan pengumpul untuk mengaktifkan pengumpulan metrik default.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` Menampilkan daftar informasi build yang tersedia dalam pemanggilan.
`final List<ITestDevice>`	`getDevices()` Menampilkan daftar perangkat yang tersedia dalam pemanggilan.
`File`	`getFileFromTestArtifacts(String fileName)` Ambil file dari artefak pengujian atau artefak modul dan simpan dalam cache di peta untuk panggilan berikutnya.
`final ITestInvocationListener`	`getInvocationListener()` Menampilkan `ITestInvocationListener` asli tempat kita meneruskan hasilnya.
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` Menampilkan semua perangkat non-stub dari daftar `getDevices()`.
`String`	`getRunName()` Menampilkan nama test run `mRunName` yang memicu pengumpul.
`String`	`getTestName()` Menampilkan nama pengujian `mTestName` yang memicu pengumpul.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inisialisasi pengumpul dengan konteks saat ini dan tempat meneruskan hasil.
`final void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena kondisi error tertentu.
`final void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`final void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`final void`	`invocationStarted(IInvocationContext context)` Pemroses Pemanggilan untuk penerusan
`boolean`	`isDefaultMetricCollectionEnabled()` Apakah pengumpul mengumpulkan metrik sebagai bagian dari pengumpulan metrik default.
`final boolean`	`isDisabled()` Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penguraian).
`boolean`	`isDisabledReceiver()` Apakah `IDeviceActionReceiver` dinonaktifkan atau tidak.
`final void`	`logAssociation(String dataName, LogFile logFile)` Jangan gunakan di dalam penerapan pengumpul metrik.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal dengan kegagalan asumsi.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback saat kasus pengujian berakhir.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback saat kasus pengujian berakhir.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal.
`void`	`onTestModuleEnded()` Memungkinkan pengambilan peristiwa modul berakhir.
`void`	`onTestModuleStarted()` Memungkinkan pengambilan peristiwa modul dimulai.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback saat uji coba berakhir.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Callback untuk peristiwa testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Callback saat uji coba dimulai.
`void`	`onTestStart(DeviceMetricData testData)` Callback saat kasus pengujian dimulai.
`void`	`rebootEnded(ITestDevice device)` Mendapatkan notifikasi saat perangkat selesai dimulai ulang.
`void`	`rebootStarted(ITestDevice device)` Mendapatkan notifikasi saat perangkat dimulai ulang.
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Menetapkan tingkat pengumpulan log oleh pengumpul, terlepas dari kegagalan.
`final void`	`setDisable(boolean isDisabled)` Menetapkan apakah objek harus dinonaktifkan.
`void`	`setDisableReceiver(boolean isDisabled)` Menetapkan apakah `IDeviceActionReceiver` harus dinonaktifkan.
`final void`	`setLogSaver(ILogSaver logSaver)` Jangan gunakan di dalam penerapan pengumpul metrik.
`void`	`setModuleContainsFailure()` Menetapkan apakah modul mengalami kegagalan (kasus pengujian, eksekusi pengujian).
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Menetapkan tingkat pengumpulan log yang harus dilakukan pengumpul selama kegagalan.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternatif untuk `testEnded(TestDescription,Map)` tempat kita dapat menentukan waktu berakhir secara langsung.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Melaporkan akhir eksekusi kasus pengujian individu.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Melaporkan kegagalan kasus pengujian individu.
`final void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individu.
`final void`	`testIgnored(TestDescription test)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Menyediakan data log atau debug terkait dari pemanggilan pengujian.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Jangan gunakan di dalam penerapan pengumpul metrik.
`final void`	`testModuleEnded()` Melaporkan akhir proses modul.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Melaporkan akhir eksekusi pengujian.
`final void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` Uji coba laporan gagal diselesaikan karena terjadi error fatal.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Melaporkan dimulainya proses pengujian.
`final void`	`testRunStarted(String runName, int testCount)` Callback uji coba
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Melaporkan dimulainya proses pengujian.
`final void`	`testRunStopped(long elapsedTime)` Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan.
`final void`	`testStarted(TestDescription test, long startTime)` Alternatif untuk `testStarted(TestDescription)` yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan `testEnded(TestDescription,long,Map)` untuk pengukuran yang akurat.
`final void`	`testStarted(TestDescription test)` Callback kasus pengujian

Konstanta

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Nilai Konstanta: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Nilai Konstanta: "test-case-include-group"

Konstruktor publik

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Metode publik

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.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Hasil
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

Menampilkan daftar informasi build yang tersedia dalam pemanggilan.

Hasil
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

Menampilkan daftar perangkat yang tersedia dalam pemanggilan.

Hasil
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Ambil file dari artefak pengujian atau artefak modul dan simpan dalam cache di peta untuk panggilan berikutnya.

Parameter
`fileName`	`String`: nama file yang akan dicari di artefak.

Hasil
`File`	File dari artefak pengujian atau artefak modul. Menampilkan null jika file tidak ditemukan.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Menampilkan ITestInvocationListener asli tempat kita meneruskan hasilnya.

Hasil
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Hasil
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Hasil
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

Menampilkan semua perangkat non-stub dari daftar getDevices().

Hasil
`List<ITestDevice>`

getRunName

public String getRunName ()

Menampilkan nama test run mRunName yang memicu pengumpul.

Hasil
`String`	mRunName, nama proses pengujian saat ini.

getTestName

public String getTestName ()

Menampilkan nama pengujian mTestName yang memicu pengumpul.

Hasil
`String`	mTestName, nama pengujian saat ini.

init

public final 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`

invocationEnded

public final void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
`elapsedTime`	`long`: waktu yang berlalu dari pemanggilan dalam md

invocationFailed

public final void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan penyebab kegagalan

invocationFailed

public final void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
`cause`	`Throwable`: penyebab kegagalan `Throwable`

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Pemroses Pemanggilan untuk penerusan

Parameter
`context`	`IInvocationContext`: informasi tentang pemanggilan

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Apakah pengumpul mengumpulkan metrik sebagai bagian dari pengumpulan metrik default.

Hasil
`boolean`

isDisabled

public final boolean isDisabled ()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penguraian). Salah untuk sebaliknya.

Hasil
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Apakah IDeviceActionReceiver dinonaktifkan atau tidak.

Hasil
`boolean`	menampilkan nilai benar jika dinonaktifkan, salah jika tidak.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Jangan gunakan di dalam penerapan pengumpul metrik. Ini adalah penerusan murni.

Parameter
`dataName`	`String`: Nama data
`logFile`	`LogFile`: `LogFile` yang dicatat sebelumnya dan harus dikaitkan dengan kasus pengujian.

onTestAssumptionFailure

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

onTestEnd

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

onTestFail

public 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
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Memungkinkan pengambilan peristiwa modul dimulai.

Menampilkan
`DeviceNotAvailableException`

onTestRunEnd

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

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback untuk peristiwa testRunFailed

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

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback saat uji coba dimulai.

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

Menampilkan
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback saat kasus pengujian dimulai.

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

Menampilkan
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Mendapatkan notifikasi saat perangkat selesai dimulai ulang.

CATATAN: Penerima harus menghindari memulai ulang selama callback ini. Setiap upaya memulai ulang akan diabaikan.

Parameter
`device`	`ITestDevice`: `ITestDevice` tempat mulai ulang berakhir.

Menampilkan
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Mendapatkan notifikasi saat perangkat dimulai ulang.

CATATAN: Penerima harus menghindari memulai ulang selama callback ini. Setiap upaya memulai ulang akan diabaikan.

Parameter
`device`	`ITestDevice`: `ITestDevice` tempat mulai ulang dimulai.

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.

setDisable

public final void setDisable (boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan. Nonaktif berarti langkah penyiapan dan penguraian harus dilewati. Dapat digunakan untuk membuat objek dinonaktifkan secara default di konstruktor default.

Parameter
`isDisabled`	`boolean`: status yang harus dimasukkan objek.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Menetapkan apakah IDeviceActionReceiver harus dinonaktifkan. Jika dinonaktifkan, aplikasi tidak akan didaftarkan ke perangkat untuk menerima peristiwa tindakan perangkat.

Parameter
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Jangan gunakan di dalam penerapan pengumpul metrik. Ini adalah penerusan murni.

Parameter
`logSaver`	`ILogSaver`: `ILogSaver`

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.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`trace`	`String`: stack trace kegagalan

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatif untuk testEnded(TestDescription,Map) tempat kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(TestDescription,long) untuk pengukuran yang akurat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`endTime`	`long`: waktu berakhirnya pengujian, diukur melalui `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `Map` metrik yang dikeluarkan

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Melaporkan akhir eksekusi kasus pengujian individu.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`testMetrics`	`HashMap`: `Map` metrik yang dikeluarkan

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`trace`	`String`: stack trace kegagalan

testIgnored

public final void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

Framework TradeFederation akan otomatis memanggil metode ini, yang menyediakan log host dan jika berlaku, logcat perangkat.

Parameter
`dataName`	`String`: nama deskriptif `String` data. Misalnya, "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. Artinya, pelaksana harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Jangan gunakan di dalam penerapan pengumpul metrik. Ini adalah penerusan murni.

Parameter
`dataName`	`String`: nama deskriptif `String` data. Misalnya, "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. Artinya, pelaksana harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai.
`logFile`	`LogFile`: `LogFile` yang berisi meta data file yang disimpan.

testModuleEnded

public final void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini terkait dengan testModuleEnded() dan bersifat opsional dalam urutan. Hanya digunakan selama menjalankan modul yang menggunakan runner berbasis rangkaian pengujian.

Parameter
`moduleContext`	`IInvocationContext`: `IInvocationContext` modul.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Melaporkan akhir eksekusi pengujian. FIXME: Kita tidak dapat memiliki dua antarmuka Map<> dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.

Parameter
`elapsedTime`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik
`runMetrics`	`HashMap`: pasangan nilai kunci yang dilaporkan di akhir proses pengujian dengan `Metric`.

testRunFailed

public final void testRunFailed (FailureDescription failure)

Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

Parameter
`failure`	`FailureDescription`: `FailureDescription` yang menjelaskan kegagalan dan konteksnya.

testRunFailed

public final void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

Parameter
`errorMessage`	`String`: `String` yang menjelaskan alasan kegagalan operasi.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Melaporkan dimulainya proses pengujian.

Parameter
`runName`	`String`: nama uji coba
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada proses baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka akan ada total 4 proses dalam runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callback uji coba

Parameter
`runName`	`String`: nama uji coba
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Melaporkan dimulainya proses pengujian.

Parameter
`runName`	`String`: nama uji coba
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada run baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka akan ada total 4 run dengan runName yang sama dan attemptNumber dari 0 hingga 3.
`startTime`	`long`: waktu mulai eksekusi, diukur melalui `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya

Parameter
`elapsedTime`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba lagi untuk mendapatkan eksekusi yang tepat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(TestDescription) yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan testEnded(TestDescription,long,Map) untuk pengukuran yang akurat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`startTime`	`long`: waktu dimulainya pengujian, diukur melalui `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Callback kasus pengujian

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian