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.

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 caching tingkat pemanggilan dan daftar modulnya
ModuleProtoResultReporter	Pelapor hasil yang dimaksudkan untuk melaporkan hanya hasil tingkat modul.

Pelapor hasil membuat protobuf TestRecord dengan semua hasil di dalamnya. Harus diperluas untuk menangani apa yang harus dilakukan dengan proto akhir di processFinalProto(TestRecord).

Ringkasan

Konstruktor publik
`ProtoResultReporter()`

Metode publik
`final void`	`invocationEnded(long elapsedTime)` Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena kondisi error tertentu.
`void`	`invocationFailed(FailureDescription failure)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`void`	`invocationFailed(Throwable cause)` Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.
`void`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`void`	`invocationStarted(IInvocationContext context)` Melaporkan dimulainya 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,LogDataType,InputStreamSource,LogFile)` langsung tidak memungkinkan.
`void`	`processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)` Gunakan catatan pemanggilan untuk mengirimkan semua log akhir pemanggilan satu per satu.
`void`	`processFinalProto(TestRecordProto.TestRecord finalRecord)` Penanganan proto akhir dengan semua hasil.
`void`	`processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)` Penanganan proto catatan hasil tes pemanggilan parsial setelah `invocationStarted(IInvocationContext)` terjadi.
`void`	`processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)` Penanganan proto rekaman kasus pengujian yang telah diselesaikan setelah `testEnded(TestDescription,long,HashMap)` terjadi.
`void`	`processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)` Penanganan proto rekaman kasus pengujian parsial setelah `testStarted(TestDescription,long)` terjadi.
`void`	`processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)` Penanganan proto rekaman modul yang telah diselesaikan setelah `testModuleEnded()` terjadi.
`void`	`processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)` Penanganan proto rekaman modul parsial setelah `testModuleStarted(IInvocationContext)` terjadi.
`void`	`processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)` Penanganan proto rekaman proses yang diselesaikan setelah `testRunEnded(long,HashMap)` terjadi.
`void`	`processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)` Penanganan proto rekaman proses pengujian parsial 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 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.
`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`	`testModuleEnded()` Melaporkan akhir proses modul.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.
`final void`	`testRunEnded(long elapsedTimeMillis, 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.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Melaporkan dimulainya proses pengujian.
`final void`	`testRunStarted(String runName, int testCount)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Melaporkan dimulainya proses pengujian.
`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)` Melaporkan dimulainya kasus pengujian individu.

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 kondisi error tertentu.

Akan dipanggil secara otomatis 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 kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

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

invocationFailed

public 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 void invocationStarted (IInvocationContext context)

Melaporkan dimulainya pemanggilan pengujian.

Akan dipanggil secara otomatis oleh framework TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan dari 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,LogDataType,InputStreamSource,LogFile) langsung tidak memungkinkan. Dengan demikian, callback ini memungkinkan untuk memberikan asosiasi 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 catatan pemanggilan untuk mengirimkan semua log akhir pemanggilan satu per satu.

Parameter
`invocationLogs`	`TestRecordProto.TestRecord`: Proto akhir yang merepresentasikan pemanggilan.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Penanganan proto akhir dengan semua hasil.

Parameter
`finalRecord`	`TestRecordProto.TestRecord`: Proto akhir dengan semua hasil pemanggilan.

processStartInvocation

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

Penanganan proto catatan hasil tes pemanggilan parsial setelah invocationStarted(IInvocationContext) terjadi.

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

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Penanganan proto rekaman kasus pengujian yang telah diselesaikan setelah testEnded(TestDescription,long,HashMap) terjadi.

Parameter
`testCaseRecord`	`TestRecordProto.TestRecord`: Proto akhir yang merepresentasikan kasus pengujian.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Penanganan proto rekaman kasus pengujian parsial setelah testStarted(TestDescription,long) terjadi.

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

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Penanganan proto rekaman modul yang telah diselesaikan setelah testModuleEnded() terjadi.

Parameter
`moduleRecord`	`TestRecordProto.TestRecord`: Proto akhir yang merepresentasikan modul.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Penanganan proto rekaman modul parsial setelah testModuleStarted(IInvocationContext) terjadi.

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

processTestRunEnded

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

Penanganan proto rekaman proses yang diselesaikan setelah testRunEnded(long,HashMap) terjadi.

Parameter
`runRecord`	`TestRecordProto.TestRecord`: Proto akhir yang merepresentasikan run.
`moduleInProgress`	`boolean`: apakah modul sedang dalam progres atau tidak.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Penanganan proto rekaman proses pengujian parsial setelah testRunStarted(String,int) terjadi.

Parameter
`runStartedRecord`	`TestRecordProto.TestRecord`: Proto parsial yang merepresentasikan run.

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

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 elapsedTimeMillis, 
                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
`elapsedTimeMillis`	`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 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)

Melaporkan dimulainya proses pengujian.

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

testRunStarted

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

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)

Melaporkan dimulainya kasus pengujian individu. Antarmuka lama, sebaiknya gunakan testStarted(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`