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.

ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.proto.ProtoResultReporter

Subclass langsung yang dikenal

FileProtoResultReporter, StreamProtoResultReporter

FileProtoResultReporter	Pelapor proto yang membuang `TestRecord` ke dalam file.
StreamProtoResultReporter	Implementasi `ProtoResultReporter`

Subclass tidak langsung yang umum

InvocationProtoResultReporter, ModuleProtoResultReporter

InvocationProtoResultReporter	Pelapor untuk menyimpan informasi penyimpanan dalam cache tingkat pemanggilan dan daftar modulnya
ModuleProtoResultReporter	Pelapor hasil yang dimaksudkan untuk hanya melaporkan hasil tingkat modul.

Pelapor hasil membuat protobuf TestRecord dengan semua hasil di dalamnya. Harus diperluas untuk menangani tindakan yang harus dilakukan dengan proto akhir di processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord).

Ringkasan

Konstruktor publik
`ProtoResultReporter()`

Metode publik
`final void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.
`void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
`void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`void`	`invocationStarted(IInvocationContext context)` Melaporkan awal pemanggilan pengujian.
`final void`	`logAssociation(String dataName, LogFile logFile)` Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` langsung tidak memungkinkan.
`void`	`processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)` Gunakan data pemanggilan untuk mengirim satu per satu semua log akhir pemanggilan.
`void`	`processFinalProto(TestRecordProto.TestRecord finalRecord)` Penanganan proto akhir dengan semua hasil.
`void`	`processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)` Penanganan proto data pengujian pemanggilan parsial setelah `invocationStarted(com.android.tradefed.invoker.IInvocationContext)` terjadi.
`void`	`processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)` Penanganan proto data kasus pengujian yang telah selesai setelah `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))` terjadi.
`void`	`processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)` Penanganan proto data kasus pengujian parsial setelah `testStarted(com.android.tradefed.result.TestDescription, long)` terjadi.
`void`	`processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)` Penanganan proto data modul yang telah selesai setelah `testModuleEnded()` terjadi.
`void`	`processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)` Penanganan proto data modul parsial setelah `testModuleStarted(com.android.tradefed.invoker.IInvocationContext)` terjadi.
`void`	`processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)` Penanganan proto data operasi yang telah selesai setelah `ERROR(/#testRunEnded(long,HashMap))` terjadi.
`void`	`processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)` Penanganan proto data pengujian berjalan sebagian setelah `testRunStarted(String, int)` terjadi.
`void`	`setGranularResults(boolean granularResults)`
`void`	`setInlineRecordOfChildren(boolean inline)`
`boolean`	`supportGranularResults()` Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternatif untuk `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` tempat kita dapat menentukan waktu berakhir secara langsung.
`void`	`testEnded(TestDescription test, testMetrics)` Melaporkan akhir eksekusi setiap kasus pengujian.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Melaporkan kegagalan kasus pengujian individual.
`final void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individual.
`final void`	`testIgnored(TestDescription test)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`final void`	`testModuleEnded()` Melaporkan akhir proses modul.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.
`final void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Melaporkan akhir pengujian yang dijalankan.
`final void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Melaporkan awal pengujian yang dijalankan.
`final void`	`testRunStarted(String runName, int testCount)` Melaporkan awal pengujian yang dijalankan.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Melaporkan awal pengujian yang dijalankan.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan.
`final void`	`testStarted(TestDescription test, long startTime)` Alternatif untuk `testStarted(com.android.tradefed.result.TestDescription)` tempat kita juga menentukan kapan pengujian dimulai, digabungkan dengan `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` untuk pengukuran yang akurat.
`final void`	`testStarted(TestDescription test)` Melaporkan awal setiap kasus pengujian.

Metode yang dilindungi
`void`	`afterModuleEnd()`
`void`	`beforeModuleStart()`
`TestRecordProto.ChildReference`	`createModuleChildReference(TestRecordProto.TestRecord record)` Membuat referensi turunan untuk modul.

Konstruktor publik

ProtoResultReporter

public ProtoResultReporter ()

Metode publik

invocationEnded

public final void invocationEnded (long elapsedTime)

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

Akan otomatis dipanggil oleh framework TradeFederation.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

Akan otomatis dipanggil oleh framework TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.

Parameter
`context`	`IInvocationContext`: informasi tentang pemanggilan

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) langsung tidak memungkinkan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat secara eksplisit.

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Gunakan data pemanggilan untuk mengirim satu per satu semua log akhir pemanggilan.

Parameter
`invocationLogs`	`TestRecordProto.TestRecord`: Proto yang telah selesai yang mewakili pemanggilan.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Penanganan proto akhir dengan semua hasil.

Parameter
`finalRecord`	`TestRecordProto.TestRecord`: Proto yang telah selesai dengan semua hasil pemanggilan.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Penanganan proto data pengujian pemanggilan parsial setelah invocationStarted(com.android.tradefed.invoker.IInvocationContext) terjadi.

Parameter
`invocationStartRecord`	`TestRecordProto.TestRecord`: Proto sebagian yang diisi setelah invocationStart.
`invocationContext`	`IInvocationContext`: Pemanggilan `IInvocationContext`.

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Penanganan proto data kasus pengujian yang telah selesai setelah ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) terjadi.

Parameter
`testCaseRecord`	`TestRecordProto.TestRecord`: Proto yang telah selesai yang mewakili kasus pengujian.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Penanganan proto data kasus pengujian parsial setelah testStarted(com.android.tradefed.result.TestDescription, long) terjadi.

Parameter
`testCaseStartedRecord`	`TestRecordProto.TestRecord`: Proto parsial yang mewakili kasus pengujian.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Penanganan proto data modul yang telah selesai setelah testModuleEnded() terjadi.

Parameter
`moduleRecord`	`TestRecordProto.TestRecord`: Proto yang telah selesai yang mewakili modul.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Penanganan proto data modul parsial setelah testModuleStarted(com.android.tradefed.invoker.IInvocationContext) terjadi.

Parameter
`moduleStartRecord`	`TestRecordProto.TestRecord`: Proto parsial yang mewakili modul.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Penanganan proto data operasi yang telah selesai setelah ERROR(/#testRunEnded(long,HashMap)) terjadi.

Parameter
`runRecord`	`TestRecordProto.TestRecord`: Proto yang telah selesai yang mewakili operasi.
`moduleInProgress`	`boolean`: apakah modul sedang berlangsung atau tidak.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Penanganan proto data pengujian berjalan sebagian setelah testRunStarted(String, int) terjadi.

Parameter
`runStartedRecord`	`TestRecordProto.TestRecord`: Proto parsial yang mewakili operasi.

setGranularResults

public void setGranularResults (boolean granularResults)

Parameter
`granularResults`	`boolean`

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parameter
`inline`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.

Hasil
`boolean`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

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

testEnded

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

Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) tempat kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long) untuk pengukuran yang akurat.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`endTime`	`long`: waktu pengujian berakhir, diukur melalui `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

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

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian
`testMetrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individual.

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

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

testModuleEnded

public final void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan bersifat opsional dalam urutan. Ini hanya digunakan selama operasi yang menggunakan modul: runner berbasis suite.

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

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

Parameter
`elapsedTimeMillis`	`long`: waktu berlalu yang dilaporkan perangkat, dalam milidetik
`runMetrics`	: pasangan nilai kunci yang dilaporkan di akhir pengujian

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)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

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

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
`runName`	`String`: nama operasi pengujian
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi di bawah runName yang sama dan attemptNumber adalah dari 0 hingga 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Melaporkan awal pengujian yang dijalankan.

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

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
`runName`	`String`: nama operasi pengujian
`testCount`	`int`: jumlah total pengujian dalam operasi pengujian
`attemptNumber`	`int`: nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi di bawah runName yang sama dan attemptNumber adalah dari 0 hingga 3.
`startTime`	`long`: waktu mulai operasi, diukur melalui `System.currentTimeMillis()`

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) tempat kita juga menentukan kapan pengujian dimulai, digabungkan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat.

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

testStarted

public final void testStarted (TestDescription test)

Melaporkan awal setiap kasus pengujian. Antarmuka lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) jika memungkinkan.

Parameter
`test`	`TestDescription`: mengidentifikasi pengujian

Metode yang dilindungi

afterModuleEnd

protected void afterModuleEnd ()

beforeModuleStart

protected void beforeModuleStart ()

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Membuat referensi turunan untuk modul.

Parameter
`record`	`TestRecordProto.TestRecord`

Hasil
`TestRecordProto.ChildReference`