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.

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 daftar yang diizinkan `TestDescription` untuk dilaporkan.
JarHostTest.HostTestListener	Pemroses wrapper yang meneruskan semua peristiwa kecuali testRunStarted() dan testRunEnded() ke pemroses tersemat.
LogSaverResultForwarder	`ResultForwarder` untuk menyimpan log dengan file saver global.
LogcatCrashResultForwarder	Pemroses khusus: jika terjadi kegagalan (proses instrumentasi mengalami error), pemroses akan mencoba mengekstrak error dari logcat dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian.
PythonBinaryHostTest.PythonForwarder	Pengirim hasil untuk mengganti nama operasi dengan nama biner.
ResultAndLogForwarder	Pengirim untuk peristiwa log dan hasil.
RetryResultForwarder	Ekstensi `ResultForwarder` yang selalu mendorong ke jumlah upaya tertentu.
ShardMainResultForwarder	`ResultForwarder` yang menggabungkan hasil pemanggilan pengujian yang di-sharding.
TestTimeoutEnforcer	Pemroses yang memungkinkan untuk memeriksa waktu eksekusi kasus pengujian tertentu dan membuatnya gagal jika melebihi waktu tunggu tertentu.

Subclass tidak langsung yang umum

GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Helper class untuk menangkap awal dan akhir run yang tidak ada.
RetryLogSaverResultForwarder	Pengirim yang juga menangani penerusan upaya saat ini.

ITestInvocationListener yang meneruskan hasil pemanggilan ke daftar pemroses lain.

Ringkasan

Konstruktor publik
`ResultForwarder(ITestInvocationListener... listeners)` Konstruktor arg variabel alternatif untuk `ResultForwarder`.
`ResultForwarder( listeners)` Buat `ResultForwarder`.

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

Metode publik
`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`	`invocationSkipped(SkipReason reason)` Melaporkan pemanggilan sebagai dilewati
`void`	`invocationStarted(IInvocationContext context)` Melaporkan awal pemanggilan pengujian.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`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.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Melaporkan kegagalan kasus pengujian individual.
`void`	`testFailed(TestDescription test, String trace)` Melaporkan kegagalan kasus pengujian individual.
`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)` 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 elapsedTime, runMetrics)` Melaporkan akhir pengujian yang dijalankan.
`void`	`testRunFailed(FailureDescription failure)` Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`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.
`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 elapsedTime)` Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan.
`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.
`void`	`testStarted(TestDescription test)` Melaporkan awal setiap kasus pengujian.

Metode yang dilindungi
	`getListeners()` Mendapatkan daftar pemroses.
`void`	`setListeners(ITestInvocationListener... listeners)` Tetapkan pemroses setelah pembuatan.
`void`	`setListeners( listeners)` Tetapkan pemroses setelah pembuatan.

Konstruktor publik

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Konstruktor arg variabel alternatif untuk ResultForwarder.

Parameter
`listeners`	`ITestInvocationListener`: `ITestInvocationListener` sebenarnya yang akan meneruskan hasil

ResultForwarder

public ResultForwarder ( listeners)

Buat ResultForwarder.

Parameter
`listeners`	: `ITestInvocationListener` sebenarnya yang akan meneruskan hasil

Konstruktor yang dilindungi

ResultForwarder

protected ResultForwarder ()

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

Metode publik

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

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

testAssumptionFailure

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

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 elapsedTime, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

Parameter
`elapsedTime`	`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 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-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 elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

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

testSkipped

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

getListeners

protected  getListeners ()

Mendapatkan daftar pemroses. Hanya ditujukan untuk digunakan oleh subclass.

Hasil
	Daftar `ITestInvocationListener`.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Tetapkan pemroses setelah pembuatan. Hanya ditujukan untuk digunakan oleh subclass.

Parameter
`listeners`	`ITestInvocationListener`: `ITestInvocationListener` sebenarnya yang akan meneruskan hasil

setListeners

protected void setListeners ( listeners)

Tetapkan pemroses setelah pembuatan. Hanya ditujukan untuk digunakan oleh subclass.

Parameter
`listeners`	: `ITestInvocationListener` sebenarnya yang akan meneruskan hasil