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.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Subclass langsung yang dikenal

FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer

FilteredResultForwarder	Varian `ResultForwarder` yang hanya mengizinkan `TestDescription` dalam daftar yang diizinkan untuk dilaporkan.
JarHostTest.HostTestListener	Pemroses wrapper yang meneruskan semua peristiwa kecuali testRunStarted() dan testRunEnded() ke pemroses yang disematkan.
LogSaverResultForwarder	`ResultForwarder` untuk menyimpan log dengan penyimpan file global.
LogcatCrashResultForwarder	Pendengar khusus: saat terjadi kegagalan (proses instrumentasi error), pendengar akan mencoba mengekstrak error dari logcat dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian.
PythonBinaryHostTest.PythonForwarder	Penerus hasil untuk mengganti nama operasi dengan nama program biner.
ResultAndLogForwarder	Forwarder untuk hasil dan peristiwa log.
RetryResultForwarder	Ekstensi `ResultForwarder` yang selalu mendorong ke nomor percobaan tertentu.
ShardMainResultForwarder	`ResultForwarder` yang menggabungkan hasil pemanggilan pengujian yang di-sharding.
TestTimeoutEnforcer	Listener yang memungkinkan untuk memeriksa waktu eksekusi kasus pengujian tertentu dan gagal jika melebihi waktu tunggu tertentu.

Subclass tidak langsung yang umum

GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Class helper untuk menangkap awal dan akhir proses yang tidak ada.
ModuleResultsAndMetricsForwarder	Ekstensi `ResultAndLogForwarder` yang menambahkan metrik terkait modul tambahan ke hasil pengujian.
RemoteTestTimeOutEnforcer	Listener yang memungkinkan untuk memeriksa waktu eksekusi konfigurasi pengujian tertentu dan gagal jika melebihi waktu tunggu tertentu.
RetryLogSaverResultForwarder	Forwarder yang juga menangani upaya saat ini yang sedang kita lakukan.

ITestInvocationListener yang meneruskan hasil pemanggilan ke daftar pemroses lainnya.

Ringkasan

Konstruktor publik
`ResultForwarder(ITestInvocationListener... listeners)` Konstruktor argumen variabel alternatif untuk `ResultForwarder`.
`ResultForwarder(List<ITestInvocationListener> listeners)` Buat `ResultForwarder`.

Konstruktor yang dilindungi
`ResultForwarder()` Buat `ResultForwarder` dengan setelan pemroses yang ditangguhkan.

Metode publik
`List<ITestInvocationListener>`	`getListeners()` Dapatkan daftar pendengar.
`TestSummary`	`getSummary()` Memungkinkan InvocationListener menampilkan ringkasan.
`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.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)
`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.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Melaporkan kegagalan kasus pengujian individu.
`void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individu.
`void`	`testIgnored(TestDescription test)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Menyediakan 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 elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Melaporkan akhir eksekusi pengujian.
`void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`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.
`void`	`testRunStarted(String runName, int testCount)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStopped(long elapsedTime)` Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan.
`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.
`void`	`testStarted(TestDescription test)` Melaporkan dimulainya kasus pengujian individu.

Metode yang dilindungi
`void`	`setListeners(ITestInvocationListener... listeners)` Tetapkan pemroses setelah konstruksi.
`void`	`setListeners(List<ITestInvocationListener> listeners)` Tetapkan pemroses setelah konstruksi.

Konstruktor publik

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Konstruktor argumen variabel alternatif untuk ResultForwarder.

Parameter
`listeners`	`ITestInvocationListener`: `ITestInvocationListener` asli untuk meneruskan hasil

ResultForwarder

public ResultForwarder (List<ITestInvocationListener> listeners)

Buat ResultForwarder.

Parameter
`listeners`	`List`: `ITestInvocationListener` asli untuk meneruskan hasil

Konstruktor yang dilindungi

ResultForwarder

protected ResultForwarder ()

Buat ResultForwarder dengan setelan pemroses yang ditangguhkan. Hanya ditujukan untuk digunakan oleh subkelas.

Metode publik

getListeners

public List<ITestInvocationListener> getListeners ()

Dapatkan daftar pendengar.

Hasil
`List<ITestInvocationListener>`	Daftar `ITestInvocationListener`.

getSummary

public TestSummary getSummary ()

Memungkinkan InvocationListener menampilkan ringkasan.

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

invocationEnded

public 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

testAssumptionFailure

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

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

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

testRunStopped

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

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Tetapkan pemroses setelah konstruksi. Hanya ditujukan untuk digunakan oleh subkelas.

Parameter
`listeners`	`ITestInvocationListener`: `ITestInvocationListener` asli untuk meneruskan hasil

setListeners

protected void setListeners (List<ITestInvocationListener> listeners)

Tetapkan pemroses setelah konstruksi. Hanya ditujukan untuk digunakan oleh subkelas.

Parameter
`listeners`	`List`: `ITestInvocationListener` asli untuk meneruskan hasil