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.

ModuleListener

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

Listener dilampirkan ke setiap IRemoteTest dari setiap modul untuk mengumpulkan daftar hasil.

Ringkasan

Konstruktor publik
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Konstruktor.

Metode publik
`boolean`	`hasLastAttemptFailed()` Menampilkan apakah sesi percobaan ulang terakhir listener telah gagal atau tidak.
`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`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Menetapkan apakah upaya harus dilaporkan sebagai terisolasi atau tidak.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Menetapkan apakah kita hanya mengumpulkan pengujian atau tidak.
`void`	`setMarkTestsSkipped(boolean skip)` Apakah akan menandai semua kasus pengujian yang dilewati atau tidak.
`void`	`setTestMappingSources(List<String> testMappingSources)` Menetapkan sumber pemetaan pengujian yang akan disisipkan ke dalam metrik.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`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, HashMap<String, MetricMeasurement.Metric> testMetrics)` Melaporkan akhir eksekusi kasus pengujian individu.
`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`	`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)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`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 name, int numTests, int attemptNumber)` Melaporkan dimulainya proses pengujian.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Melaporkan dimulainya proses pengujian.
`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.

Konstruktor publik

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Konstruktor.

Parameter
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

Metode publik

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

Menampilkan apakah sesi percobaan ulang terakhir listener telah gagal atau tidak.

Hasil
`boolean`

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

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Menetapkan apakah upaya harus dilaporkan sebagai terisolasi atau tidak.

Parameter
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Menetapkan apakah kita hanya mengumpulkan pengujian atau tidak.

Parameter
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Apakah akan menandai semua kasus pengujian yang dilewati atau tidak.

Parameter
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

Menetapkan sumber pemetaan pengujian yang akan disisipkan ke dalam metrik.

Parameter
`testMappingSources`	`List`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parameter
`useModuleResultsForwarder`	`boolean`

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

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

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)

Parameter
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parameter
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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 name, 
                int numTests, 
                int attemptNumber)

Melaporkan dimulainya proses pengujian.

Parameter
`name`	`String`: nama uji coba
`numTests`	`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 name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Melaporkan dimulainya proses pengujian.

Parameter
`name`	`String`: nama uji coba
`numTests`	`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 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()`