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.

CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

Subclass langsung yang dikenal

JsonHttpTestResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

JsonHttpTestResultReporter	Pelapor hasil yang mengenkode hasil metrik pengujian dan cabang, info perangkat ke dalam JSON dan POST ke endpoint layanan HTTP
MetricsXMLResultReporter	MetricsXMLResultReporter menulis metrik pengujian dan menjalankan metrik ke file XML dalam folder yang ditentukan oleh parameter folder metrik pada fase invocationEnded pengujian.
ModuleListener	Pemroses yang dilampirkan ke setiap `IRemoteTest` dari setiap modul untuk mengumpulkan daftar hasil.
ReportPassedTests	Melaporkan dalam file kemungkinan filter untuk mengecualikan pengujian yang lulus.
ResultAggregator	Pengirim khusus yang menggabungkan hasil jika diperlukan, berdasarkan strategi percobaan ulang yang dilakukan.
ShardListener	`ITestInvocationListener` yang mengumpulkan hasil dari shard pemanggilan (alias pemisahan pemanggilan untuk dijalankan di beberapa resource secara paralel), dan meneruskannya ke pemroses lain.
SuiteResultReporter	Kumpulkan hasil pengujian untuk seluruh pemanggilan suite dan hasilkan hasil akhir.
XmlResultReporter	Menulis hasil JUnit ke file XML dalam format yang konsisten dengan XMLJUnitResultFormatter Ant.

Subclass tidak langsung yang umum

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	Reporter yang memungkinkan pembuatan laporan dalam format tertentu.
XmlFormattedGeneratorReporter	Implementasi `FormattedGeneratorReporter` yang memformat suite menghasilkan format xml.

ITestInvocationListener yang akan mengumpulkan semua hasil pengujian.

Meskipun struktur data yang digunakan dalam objek ini aman untuk thread, callback ITestInvocationListener harus dipanggil dalam urutan yang benar.

Ringkasan

Konstruktor publik
`CollectingTestListener()`

Metode publik
`IBuildInfo`	`getBuildInfo()` Metode ini tidak digunakan lagi. mengandalkan `IBuildInfo` dari `getInvocationContext()`.
`TestRunResult`	`getCurrentRunResults()` Mendapatkan hasil untuk pengujian yang sedang berjalan.
`int`	`getExpectedTests()` Menampilkan jumlah pengujian yang diharapkan.
`IInvocationContext`	`getInvocationContext()` Menampilkan konteks pemanggilan yang dilaporkan melalui `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`
	`getMergedTestRunResults()` Menampilkan kumpulan hasil gabungan untuk semua operasi yang dijalankan di berbagai upaya.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` Menampilkan `IInvocationContext` modul yang terkait dengan hasil.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` Menampilkan salinan peta yang berisi semua file yang dicatat ke dalam log yang terkait dengan modul
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` Menampilkan salinan peta yang berisi semua file yang dicatat dalam log yang tidak terkait dengan pengujian yang dijalankan atau modul.
`int`	`getNumAllFailedTestRuns()` Menampilkan jumlah total pengujian yang berjalan dalam status kegagalan
`int`	`getNumAllFailedTests()` Menampilkan jumlah total pengujian dalam status kegagalan (hanya gagal, kegagalan asumsi tidak diperhitungkan).
`int`	`getNumTestsInState(TestResult.TestStatus status)` Menampilkan jumlah pengujian dalam status tertentu untuk operasi ini.
`int`	`getNumTotalTests()` Menampilkan jumlah total pengujian yang lengkap untuk semua operasi.
`IBuildInfo`	`getPrimaryBuildInfo()` Menampilkan info build utama yang dilaporkan melalui `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getRunResults()` Metode ini tidak digunakan lagi. Gunakan `getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` Menampilkan `TestRunResult` untuk satu upaya.
`int`	`getTestRunAttemptCount(String testRunName)` Menampilkan jumlah upaya untuk nama pengujian yang dijalankan.
	`getTestRunAttempts(String testRunName)` Mendapatkan semua upaya untuk `TestRunResult` dari pengujian tertentu yang dijalankan.
	`getTestRunForAttempts(int attempt)` Mendapatkan semua hasil untuk upaya tertentu.
	`getTestRunNames()` Menampilkan semua nama untuk semua pengujian yang dijalankan.
`boolean`	`hasFailedTests()` Menampilkan apakah pemanggilan memiliki pengujian yang gagal atau asumsi yang gagal.
`boolean`	`hasTestRunResultsForName(String testRunName)` Menampilkan apakah nama pengujian yang dijalankan memiliki hasil.
`void`	`invocationEnded(long elapsedTime)`
`void`	`invocationFailed(Throwable cause)`
`void`	`invocationStarted(IInvocationContext context)`
`void`	`logAssociation(String dataName, LogFile logFile)`
`void`	`setBuildInfo(IBuildInfo buildInfo)` Metode ini tidak digunakan lagi. Tidak diperlukan lagi untuk pengujian.
`void`	`setMergeStrategy(MergeStrategy strategy)` Menetapkan `MergeStrategy` yang akan digunakan saat menggabungkan hasil.
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testModuleEnded()`
`void`	`testModuleStarted(IInvocationContext moduleContext)`
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failure)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber)`
`void`	`testRunStarted(String name, int numTests)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped(long elapsedTime)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Metode yang dilindungi
`final void`	`clearModuleLogFiles()` Memungkinkan pembersihan file modul sehingga kita tidak membawanya terlalu lama.
`final void`	`clearResultsForName(String testRunName)` Memungkinkan untuk menghapus hasil untuk nama run tertentu.
`void`	`setIsAggregrateMetrics(boolean aggregate)` Mengaktifkan/menonaktifkan opsi 'metrik gabungan'

Konstruktor publik

CollectingTestListener

public CollectingTestListener ()

Metode publik

getBuildInfo

public IBuildInfo getBuildInfo ()

Metode ini tidak digunakan lagi.
mengandalkan IBuildInfo dari getInvocationContext().

Menampilkan info build.

Hasil
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Mendapatkan hasil untuk pengujian yang sedang berjalan.

Perhatikan bahwa hasilnya mungkin tidak lengkap. Sebaiknya uji nilai TestRunResult.isRunComplete() dan/atau (@link TestRunResult#isRunFailure()} sesuai kebutuhan sebelum memproses hasilnya.

Hasil
`TestRunResult`	`TestRunResult` yang mewakili data yang dikumpulkan selama pengujian terakhir dijalankan

getExpectedTests

public int getExpectedTests ()

Menampilkan jumlah pengujian yang diharapkan. Dapat berbeda dari getNumTotalTests() jika beberapa pengujian tidak berjalan.

Hasil
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

Menampilkan konteks pemanggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Hasil
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

Menampilkan kumpulan hasil gabungan untuk semua operasi yang dijalankan di berbagai upaya.

Jika ada beberapa hasil, setiap pengujian yang dijalankan akan digabungkan, dengan hasil pengujian terbaru menimpa hasil pengujian dari pengujian sebelumnya. Pengujian yang dijalankan diurutkan berdasarkan nomor percobaan.

Metrik untuk upaya yang sama akan digabungkan berdasarkan preferensi yang ditetapkan oleh aggregate-metrics. Metrik akhir akan menjadi metrik dari upaya terakhir.

Hasil

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Menampilkan IInvocationContext modul yang terkait dengan hasil.

Parameter
`testRunName`	`String`: Nama yang diberikan oleh {`testRunStarted(String, int)`.

Hasil
`IInvocationContext`	`IInvocationContext` modul untuk nama pengujian yang dijalankan `null` jika tidak ada hasil untuk nama tersebut.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Menampilkan salinan peta yang berisi semua file yang dicatat ke dalam log yang terkait dengan modul

Hasil
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Menampilkan salinan peta yang berisi semua file yang dicatat dalam log yang tidak terkait dengan pengujian yang dijalankan atau modul.

Hasil
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Menampilkan jumlah total pengujian yang berjalan dalam status kegagalan

Hasil
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

Menampilkan jumlah total pengujian dalam status kegagalan (hanya gagal, kegagalan asumsi tidak diperhitungkan).

Hasil
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Menampilkan jumlah pengujian dalam status tertentu untuk operasi ini.

Parameter
`status`	`TestResult.TestStatus`

Hasil
`int`

getNumTotalTests

public int getNumTotalTests ()

Menampilkan jumlah total pengujian yang lengkap untuk semua operasi.

Hasil
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Menampilkan info build utama yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext). Build utama adalah build yang ditampilkan oleh penyedia build pertama dari konfigurasi yang sedang berjalan. Menampilkan null jika tidak ada konteks (tidak ada build untuk kasus pengujian).

Hasil
`IBuildInfo`

getRunResults

public  getRunResults ()

Metode ini tidak digunakan lagi.
Menggunakan getMergedTestRunResults()

Menampilkan hasil untuk semua pengujian yang dijalankan.

Hasil

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Menampilkan TestRunResult untuk satu upaya.

Parameter
`testRunName`	`String`: Nama yang diberikan oleh {`testRunStarted(String, int)`.
`attempt`	`int`: ID percobaan.

Hasil
`TestRunResult`	`TestRunResult` untuk nama yang diberikan dan ID percobaan atau `null` jika tidak ada.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Menampilkan jumlah upaya untuk nama pengujian yang dijalankan.

Parameter
`testRunName`	`String`: Nama yang diberikan oleh {`testRunStarted(String, int)`.

Hasil
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari pengujian tertentu yang dijalankan.

Parameter
`testRunName`	`String`: Nama yang diberikan oleh {`testRunStarted(String, int)`.

Hasil
	Semua `TestRunResult` untuk pengujian tertentu yang dijalankan, diurutkan berdasarkan upaya.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk upaya tertentu.

Parameter
`attempt`	`int`: Upaya yang ingin kita dapatkan hasilnya.

Hasil
	Semua `TestRunResult` untuk upaya tertentu.

getTestRunNames

public  getTestRunNames ()

Menampilkan semua nama untuk semua pengujian yang dijalankan.

Pengujian ini mungkin telah dijalankan beberapa kali dengan upaya yang berbeda.

Hasil

hasFailedTests

public boolean hasFailedTests ()

Menampilkan apakah pemanggilan memiliki pengujian yang gagal atau asumsi yang gagal.

Hasil
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Menampilkan apakah nama pengujian yang dijalankan memiliki hasil.

Parameter
`testRunName`	`String`: Nama yang diberikan oleh {`testRunStarted(String, int)`.

Hasil
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

Parameter
`elapsedTime`	`long`

invocationFailed

public void invocationFailed (Throwable cause)

Parameter
`cause`	`Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Parameter
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Parameter
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Metode ini tidak digunakan lagi.
Tidak diperlukan lagi untuk pengujian.

Menetapkan info build. Sebaiknya hanya digunakan untuk pengujian.

Parameter
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Menetapkan MergeStrategy yang akan digunakan saat menggabungkan hasil.

Parameter
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parameter
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parameter
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Parameter
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parameter
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parameter
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parameter
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Parameter
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Parameter
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parameter
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

Parameter
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parameter
`errorMessage`	`String`

testRunStarted

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

Parameter
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Parameter
`name`	`String`
`numTests`	`int`

testRunStarted

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

Parameter
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

Parameter
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parameter
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Parameter
`test`	`TestDescription`

Metode yang dilindungi

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Memungkinkan pembersihan file modul sehingga kita tidak membawanya terlalu lama.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Memungkinkan untuk menghapus hasil untuk nama run tertentu. Hanya boleh digunakan dalam beberapa kasus seperti agregator hasil.

Parameter
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Mengaktifkan/menonaktifkan opsi 'metrik gabungan'

Parameter
`aggregate`	`boolean`