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 Kuartal 2 dan Kuartal 4. Untuk membangun dan berkontribusi ke AOSP, sebaiknya gunakan android-latest-release, bukan aosp-main. Cabang manifes android-latest-release akan selalu merujuk pada rilis terbaru yang di-push ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Subclass tidak langsung yang umum

StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener

StubTestRunListener	Implementasi stub `ITestRunListener`
TestRunResult	Menyimpan hasil dari satu pengujian.
TestRunToTestInvocationForwarder	Penerusan dari ddmlib `ITestRunListener` ke `ITestLifeCycleReceiver`.
XmlTestRunListener	Menulis hasil JUnit ke file XML dalam format yang konsisten dengan XMLJUnitResultFormatter Ant.

Menerima notifikasi peristiwa selama menjalankan uji instrumentasi.

Dibuat berdasarkan org.junit.runner.notification.RunListener

Urutan panggilan akan menjadi:

testRunStarted
testStarted
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

Ringkasan

Metode publik
`abstract void`	`testAssumptionFailure(TestIdentifier test, String trace)` Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
`abstract void`	`testEnded(TestIdentifier test, testMetrics)` Melaporkan akhir eksekusi kasus pengujian individual.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Melaporkan kegagalan kasus pengujian individual.
`abstract void`	`testIgnored(TestIdentifier test)` Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
`abstract void`	`testRunEnded(long elapsedTime, runMetrics)` Melaporkan akhir proses pengujian.
`abstract void`	`testRunFailed(String errorMessage)` Uji coba laporan gagal diselesaikan karena terjadi error fatal.
`abstract void`	`testRunStarted(String runName, int testCount)` Melaporkan dimulainya proses pengujian.
`abstract void`	`testRunStopped(long elapsedTime)` Metode ini tidak digunakan lagi. Callback ini tidak akan pernah dipanggil. Akan dihapus.
`abstract void`	`testStarted(TestIdentifier test)` Melaporkan dimulainya kasus pengujian individual.

Metode publik

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

Melaporkan akhir eksekusi kasus pengujian individual.

Jika testFailed(TestIdentifier, String) tidak dipanggil, pengujian ini lulus. Juga menampilkan metrik key/value yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter

test

TestIdentifier: mengidentifikasi pengujian

testMetrics

: ERROR(/Map) metrik yang dikeluarkan selama eksekusi kasus pengujian oleh android.app.Instrumentation#sendStatus. Perintah penyisipan dipertahankan kecuali jika Anda memancarkan kunci yang sama beberapa kali. Perhatikan bahwa kunci standar yang ditentukan dalam IInstrumentationResultParser.StatusKeys difilter dari Peta ini. Ddmlib dapat menambahkan metrik pengujian tambahan yang ditentukan dalam IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

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

testIgnored

public abstract void testIgnored (TestIdentifier test)

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

Parameter
`test`	`TestIdentifier`: mengidentifikasi pengujian

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir proses pengujian.

Parameter

elapsedTime

long: waktu berlalu yang dilaporkan perangkat, dalam milidetik

runMetrics

: ERROR(/Map) metrik yang dikeluarkan selama eksekusi kasus pengujian oleh android.app.Instrumentation#addResults. Perintah penyisipan dipertahankan kecuali jika Anda memancarkan kunci yang sama beberapa kali. Perhatikan bahwa kunci standar yang ditentukan dalam IInstrumentationResultParser.StatusKeys difilter dari Peta ini. Ddmlib dapat menambahkan metrik pengujian tambahan yang ditentukan dalam IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

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

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

Melaporkan dimulainya proses pengujian.

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

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Metode ini tidak digunakan lagi.
Callback ini tidak akan pernah dipanggil. Akan dihapus.

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

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

testStarted

public abstract void testStarted (TestIdentifier test)

Melaporkan dimulainya kasus pengujian individual.

Parameter
`test`	`TestIdentifier`: mengidentifikasi pengujian