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.

SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.SubprocessResultsReporter

Subclass langsung yang dikenal

LegacySubprocessResultsReporter

LegacySubprocessResultsReporter Implementasi beku dari pelapor hasil subproses yang harus tetap kompatibel dengan TF/CTS versi sebelumnya (misalnya 8+), meskipun ada perubahan pada superclass-nya.

Mengimplementasikan ITestInvocationListener untuk ditentukan sebagai result_reporter dan meneruskan dari subproses hasil pengujian, pengujian berjalan, pemanggilan pengujian.

Ringkasan

Konstruktor publik
`SubprocessResultsReporter()`

Metode publik
`void`	`close()`
`TestSummary`	`getSummary()` Memungkinkan InvocationListener menampilkan ringkasan.
`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`	`invocationStarted(IInvocationContext context)` Melaporkan awal pemanggilan pengujian.
`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`	`printEvent(String key, Object event)` Helper untuk mencetak kunci peristiwa, lalu objek json.
`void`	`setOutputTestLog(boolean outputTestLog)` Menetapkan apakah kita harus menampilkan pengujian yang dicatat ke dalam log atau tidak.
`boolean`	`supportGranularResults()` Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.
`void`	`testAssumptionFailure(TestDescription testId, String trace)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`void`	`testAssumptionFailure(TestDescription testId, FailureDescription failure)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`void`	`testEnded(TestDescription testId, long endTime, metrics)` Alternatif untuk `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` tempat kita dapat menentukan waktu berakhir secara langsung.
`void`	`testEnded(TestDescription testId, metrics)` Melaporkan akhir eksekusi setiap kasus pengujian.
`void`	`testFailed(TestDescription testId, FailureDescription failure)` Melaporkan kegagalan kasus pengujian individual.
`void`	`testFailed(TestDescription testId, String reason)` Melaporkan kegagalan kasus pengujian individual.
`void`	`testIgnored(TestDescription testId)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Memberikan data log atau debug terkait dari pemanggilan pengujian.
`void`	`testModuleEnded()` Melaporkan akhir proses modul.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Melaporkan awal modul yang berjalan.
`void`	`testRunEnded(long time, runMetrics)` Melaporkan akhir pengujian yang dijalankan.
`void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`void`	`testRunFailed(String reason)` Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Melaporkan awal pengujian yang dijalankan.
`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.
`void`	`testRunStopped(long arg0)` Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.
`void`	`testSkipped(TestDescription testId, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan.
`void`	`testStarted(TestDescription testId, 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.
`void`	`testStarted(TestDescription testId)` Melaporkan awal setiap kasus pengujian.

Konstruktor publik

SubprocessResultsReporter

public SubprocessResultsReporter ()

Metode publik

tutup

public void close ()

getSummary

public TestSummary getSummary ()

Memungkinkan InvocationListener menampilkan ringkasan.

Hasil
`TestSummary`	`TestSummary` yang meringkas operasi, atau null

invocationEnded

public 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

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

printEvent

public void printEvent (String key, 
                Object event)

Helper untuk mencetak kunci peristiwa, lalu objek json.

Parameter
`key`	`String`
`event`	`Object`

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Menetapkan apakah kita harus menampilkan pengujian yang dicatat ke dalam log atau tidak.

Parameter
`outputTestLog`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

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

Hasil
`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

testEnded

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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
`testId`	`TestDescription`: mengidentifikasi pengujian
`endTime`	`long`: waktu pengujian berakhir, diukur melalui `System.currentTimeMillis()`
`metrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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
`testId`	`TestDescription`: mengidentifikasi pengujian
`metrics`	: `ERROR(/Map)` dari metrik yang dikeluarkan

testFailed

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

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

testFailed

public void testFailed (TestDescription testId, 
                String reason)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
`testId`	`TestDescription`: mengidentifikasi pengujian
`reason`	`String`: stack trace kegagalan

testIgnored

public void testIgnored (TestDescription testId)

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

Parameter
`testId`	`TestDescription`: mengidentifikasi pengujian

testLog

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

Memberikan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(/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". Perhatikan bahwa dataName mungkin tidak unik per pemanggilan. Artinya, pengimplementasi harus dapat menangani beberapa panggilan dengan dataName yang sama
`dataType`	`LogDataType`: `LogDataType` data
`dataStream`	`InputStreamSource`: `InputStreamSource` data. Implementator 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.

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public 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 void testRunEnded (long time, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

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

testRunFailed

public 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 void testRunFailed (String reason)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

Parameter
`reason`	`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-nya adalah dari 0 hingga 3.

testRunStarted

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

testRunStopped

public void testRunStopped (long arg0)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription testId, 
                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
`testId`	`TestDescription`: mengidentifikasi pengujian
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription testId, 
                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
`testId`	`TestDescription`: mengidentifikasi pengujian
`startTime`	`long`: waktu pengujian dimulai, diukur melalui `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription testId)

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

Parameter
`testId`	`TestDescription`: mengidentifikasi pengujian