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.

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

ITestInvocationListener yang mengumpulkan hasil dari shard pemanggilan (alias pemisahan pemanggilan untuk dijalankan di beberapa resource secara paralel), dan meneruskannya ke pemroses lain.

Ringkasan

Konstruktor publik
`ShardListener(ITestInvocationListener main)` Buat `ShardListener`.

Metode publik
	`getUnderlyingResultReporter()`
`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`	`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`	`setSupportGranularResults(boolean enableGranularResults)`
`boolean`	`supportGranularResults()` Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Memberikan data log atau debug terkait dari pemanggilan pengujian.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`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 failureMessage)` Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Melaporkan awal pengujian yang dijalankan.

Konstruktor publik

ShardListener

public ShardListener (ITestInvocationListener main)

Buat ShardListener.

Parameter
`main`	`ITestInvocationListener`: `ITestInvocationListener` hasil harus diteruskan. Untuk mencegah bentrok dengan `ShardListener` lain, objek ini akan disinkronkan di `main` saat meneruskan hasil. Selain itu, hasil hanya akan dikirim setelah shard pemanggilan selesai.

Metode publik

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Hasil

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

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.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parameter
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

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

Hasil
`boolean`

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.

testLogSaved

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

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

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

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Melaporkan awal pengujian yang dijalankan.

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