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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

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

Subclass langsung yang dikenal

BugreportzOnFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, ScreenshotOnFailureCollector

BugreportzOnFailureCollector	Mengumpulkan bugreportz saat kasus pengujian gagal.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan Clang dari perangkat dan mencatatnya sebagai artefak pengujian.
CountTestCasesCollector	Menghitung dan melaporkan jumlah kasus pengujian untuk `IRemoteTest` tertentu.
DebugHostLogOnFailureCollector	Kolektor yang akan mengumpulkan dan mencatat log sisi host saat kegagalan kasus pengujian terjadi.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` yang memproses kunci metrik yang berasal dari perangkat dan menariknya sebagai file dari perangkat.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` yang akan menarik pengukuran cakupan gcov dari perangkat dan mencatatnya sebagai artefak pengujian.
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.
ScreenshotOnFailureCollector	Pengumpul yang akan mengambil dan mencatat screenshot saat kasus pengujian gagal.

Subclass tidak langsung yang umum

FilePullerLogCollector

FilePullerLogCollector Logger file yang dilaporkan oleh sisi perangkat.

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)).

Ringkasan

Kolom
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Konstruktor publik
`BaseDeviceMetricCollector()`

Metode publik
`final`	`getBuildInfos()` Menampilkan daftar informasi build yang tersedia dalam pemanggilan.
`final`	`getDevices()` Menampilkan daftar perangkat yang tersedia dalam pemanggilan.
`File`	`getFileFromTestArtifacts(String fileName)` Ambil file dari artefak pengujian atau artefak modul, lalu simpan dalam cache di peta untuk panggilan berikutnya.
`final ITestInvocationListener`	`getInvocationListener()` Menampilkan `ITestInvocationListener` asli tempat kita meneruskan hasilnya.
`final`	`getRealDevices()` Menampilkan semua perangkat non-stub dari daftar `getDevices()`.
`String`	`getRunName()` Menampilkan nama pengujian yang dijalankan `mRunName` yang memicu kolektor.
`ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inisialisasi kolektor dengan konteks saat ini dan tempat untuk meneruskan hasil.
`final void`	`invocationEnded(long elapsedTime)`
`final void`	`invocationFailed(FailureDescription failure)`
`final void`	`invocationFailed(Throwable cause)`
`final void`	`invocationStarted(IInvocationContext context)` Pemroses Pemanggilan untuk penerusan
`final boolean`	`isDisabled()` Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan).
`final void`	`logAssociation(String dataName, LogFile logFile)` Jangan gunakan di dalam implementasi pengumpulan metrik.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal dengan kegagalan asumsi.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Callback saat kasus pengujian berakhir.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback saat kasus pengujian berakhir.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback saat kasus pengujian gagal.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback saat pengujian berakhir.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)`
`void`	`onTestRunStart(DeviceMetricData runData)` Callback saat pengujian dimulai.
`void`	`onTestStart(DeviceMetricData testData)` Callback saat kasus pengujian dimulai.
`final void`	`setDisable(boolean isDisabled)` Menetapkan apakah objek harus dinonaktifkan.
`final void`	`setLogSaver(ILogSaver logSaver)` Jangan gunakan di dalam implementasi pengumpulan metrik.
`final void`	`testAssumptionFailure(TestDescription test, String trace)`
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`final void`	`testEnded(TestDescription test, testMetrics)`
`final void`	`testFailed(TestDescription test, FailureDescription failure)`
`final void`	`testFailed(TestDescription test, String trace)`
`final void`	`testIgnored(TestDescription test)`
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Jangan gunakan di dalam implementasi pengumpulan metrik.
`final void`	`testModuleEnded()`
`final void`	`testModuleStarted(IInvocationContext moduleContext)`
`final void`	`testRunEnded(long elapsedTime, runMetrics)`
`final void`	`testRunFailed(FailureDescription failure)`
`final void`	`testRunFailed(String errorMessage)`
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)`
`final void`	`testRunStarted(String runName, int testCount)` Menguji callback run
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)`
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` Callback kasus pengujian

Kolom

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Konstruktor publik

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Metode publik

getBuildInfos

public final  getBuildInfos ()

Menampilkan daftar informasi build yang tersedia dalam pemanggilan.

Hasil

getDevices

public final  getDevices ()

Menampilkan daftar perangkat yang tersedia dalam pemanggilan.

Hasil

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Ambil file dari artefak pengujian atau artefak modul, lalu 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`

getRealDevices

public final  getRealDevices ()

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

Hasil

getRunName

public String getRunName ()

Menampilkan nama pengujian yang dijalankan mRunName yang memicu kolektor.

Hasil
`String`	mRunName, nama pengujian yang sedang berjalan.

init

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

invocationEnded

public final void invocationEnded (long elapsedTime)

Parameter
`elapsedTime`	`long`

invocationFailed

public final void invocationFailed (FailureDescription failure)

Parameter
`failure`	`FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

Parameter
`cause`	`Throwable`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Pemroses Pemanggilan untuk penerusan

Parameter
`context`	`IInvocationContext`

isDisabled

public final boolean isDisabled ()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan). Salah jika tidak.

Hasil
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Jangan gunakan di dalam implementasi pengumpulan metrik. Ini adalah penerusan murni.

Parameter
`dataName`	`String`
`logFile`	`LogFile`

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.

onTestEnd

public 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 `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.
`test`	`TestDescription`: `TestDescription` kasus pengujian yang sedang berlangsung.

onTestEnd

public 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 `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.

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.

onTestRunEnd

public 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 `ITestLifeCycleReceiver.testRunEnded(long, Map)`.

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Parameter
`testData`	`DeviceMetricData`
`failure`	`FailureDescription`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback saat pengujian dimulai.

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

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback saat kasus pengujian dimulai.

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

setDisable

public final void setDisable (boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan. Dinonaktifkan berarti langkah penyiapan dan penghapusan harus dilewati. Dapat digunakan untuk membuat objek dinonaktifkan secara default dalam konstruktor default.

Parameter
`isDisabled`	`boolean`: status yang harus diberikan pada objek.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Jangan gunakan di dalam implementasi pengumpulan metrik. Ini adalah penerusan murni.

Parameter
`logSaver`	`ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Parameter
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parameter
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Parameter
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Parameter
`test`	`TestDescription`
`testMetrics`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Parameter
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Parameter
`test`	`TestDescription`
`trace`	`String`

testIgnored

public final void testIgnored (TestDescription test)

Parameter
`test`	`TestDescription`

testLog

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

Parameter
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

Jangan gunakan di dalam implementasi pengumpulan metrik. Ini adalah penerusan murni.

Parameter
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Parameter
`moduleContext`	`IInvocationContext`

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Parameter
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public final void testRunFailed (FailureDescription failure)

Parameter
`failure`	`FailureDescription`

testRunFailed

public final void testRunFailed (String errorMessage)

Parameter
`errorMessage`	`String`

testRunStarted

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

Parameter
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Menguji callback run

Parameter
`runName`	`String`
`testCount`	`int`

testRunStarted

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

Parameter
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public final void testRunStopped (long elapsedTime)

Parameter
`elapsedTime`	`long`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Parameter
`test`	`TestDescription`
`startTime`	`long`

testStarted

public final void testStarted (TestDescription test)

Callback kasus pengujian

Parameter
`test`	`TestDescription`